Kyso
Kyso.ioAbout Us
  • What is Kyso?
  • Getting started
    • Architecture and Deployment
  • Kyso's Renderer
    • Jupyter Notebooks
    • Jupyter FAQ
      • Kyso's Jupyter Renderer
      • Bokeh Plots and Kyso
    • HTML
    • Markdown
    • PDFs
    • PowerPoints
    • RTF Documents
    • Embedded Dashboards
      • Google Sheets
      • Looker Dashboards
      • Tableau Dashboards
      • Microsoft BI Dashboards
      • Plotly's Dash
      • Streamlit
    • Videos
  • Publishing Workflows
    • Creating Reports In-App
    • Kyso's Command Line Tool
      • Installation
        • Using Amazon Linux
      • Authorization
      • Publishing & Downloading
      • Advanced configuration
    • Integrating with Git
      • Github
      • Gitlab
      • Bitbucket
    • Configuring Report Metadata
    • Importing Files from S3
    • Publishing FAQ
      • Meta Reports
      • Pushing Single Files
      • Issues with Report Rendering
  • Search and Discovery
    • Searching Reports
    • Browsing Files & Versions
  • COLLABORATION
    • Report Comments
    • Report Tasks
    • Notebook Report Snippets
    • Business Notifications
      • Slack
      • Microsoft Teams
  • Settings & Administration
    • Themes & Styling
    • Permissions System
    • Managing Access
    • SSO Configuration
  • Resources
    • How to manage adoption
      • Driving Internal Engagement
      • Advice for Large Companies
    • R Users & R Markdown
    • Writing a good data-science report
Powered by GitBook
On this page
  • 1. Create a Slack App
  • Configure Kyso
  • Configure Slack Notifications at the Channel Level

Was this helpful?

  1. COLLABORATION
  2. Business Notifications

Slack

Keep Kyso and Slack in sync so the team doesn't miss anything

PreviousBusiness NotificationsNextMicrosoft Teams

Last updated 1 year ago

Was this helpful?

Current limitation: all event notifications are sent to Slack and Teams from Kyso. There is no option (currently) to customise your own communications preferences. This is only possible for email communications.

Kyso can be integrated easily with Slack, which will receive notifications when something happens in your organization or channel, for example, when a new report is created, or a new comment is written, just follow these steps:

1. Create a Slack App

Open Slack and choose the option Apps, under the menu More.

Click on App Directory button, located at the top right of your screen.

Then, click on Build, located at the top right of your screen.

Go to Your Apps in the top right of your screen, go to Manage your apps and click Create an app

Click Create an app

Select the option From scratch

Choose a name and select the desired workspace

Click on the section Permissions.

Scroll down until the section Scopes and add the scope chat:write to the Bot Token Scopes.

Scroll up to the top of the same page and click on the button Install to Workspace.

Copy the generated Bot User OAuth Token and save it for later use.

The Slack App configuration is finished, in the next section you will configure Kyso to use this Slack App.

Configure Kyso

Slack notifications can be configured at different levels:

  • Organization level. All the channels under an organization will inherit this configuration. That means, all the notifications related to that organization will use the same Slack channel. Requires organization admin role.

  • Channel level. Every channel can define their own slack notifications. If there is a configuration at organization level, that configuration will be overwritten by the channel configuration. Using this, you can define specific configuration per channel. Requires Full Access role.

Configure Slack Notifications at Organization Level

Login into Kyso, click on your avatar and select Settings.

Choose the desired organization in the left menu, select the tab Notifications and copy & paste the Bot User OAuth Token in the form Slack Token. Also, specify the destination channel in the input Slack Channel.

Open Slack, click on the destination channel and open the configuration by clicking on the title of the channel, at the top of the page.

Select the tab Integrations and click on the button Add an App.

Write the name of your app and click on the button Add.

Well done! Your organization is now configured with Slack, to test it out just create a new report in your organization and check that you are receiving the notifications in the configured channel at Slack.

Configure Slack Notifications at the Channel Level

The configuration process is exactly the same, but in the Channel Configuration page on your Kyso settings.

Take into account that the slack token only can be defined at the Organization level, for security reasons.

Slack Apps
Slack's App Directoy
Slack Apps
Your Slack Apps
Create an App
New App from Scratch
Choose an App Name
App Permissions
App Tokens
Auth Tokens
Auth Tokens
Kyso Settings
Channel Configuration
Adding an Integration
Add the Kyso App
Kyso Notifications
Kyso Channel Settings