{"versionId":"af8b7fa9-9326-4d9e-7416-08dc59a4dfdc","articleId":"5bb7b0e2-dcb6-4894-c729-08db0890fc0f","title":"Adding a chatbot to Slack","tags":["Slack","integrations","All articles"],"content":"
\n

Table of Contents

\n\n
\n

You can deploy the same chatbot, with the same knowledge base, on multiple channels, including Slack.

\n

This means you can automate the answering of frequently asked questions, wherever your customers (or team, in the case of internal support scenarios) are asking them. All your chat forms and escalations will work on Slack too.

\n

To set up your bot in Slack, you'll first need to create a Slack app, and then, with the help of the FAQ Bot team, connect it to your FAQ Bot.

\n

This article describes the steps you need to take, and the information you'll need to provide to the FAQ Bot team. It also details some chatbot elements that will appear differently on Slack.

\n
\n

Prerequisites

\n

Before you get started, you will need:

\n
\n\n
\n

Create an app in Slack

\n
\n

You first create an application in Slack, which generates the information you need to configure the Slack channel for your FAQ Bot .

\n
    \n
  1. Go to Your Apps panel and sign in to your Slack account.
    2. \n
  2. Select Create New App, or Create an App if this is your first application.\n
      \n
    1. On the Create an app page, select From scratch.
      2. \n
    2. On the Name app & choose workspace page, for App Name, enter the name of your Slack application.
      3. \n
    3. For Pick a workspace to develop your app in, select a workspace for your app.
      4. \n
    4. Review and agree to the Slack API terms of service.
      5. \n
    5. Select Create App.
      6. \n
    \n
    3. \n
\n

\n
\n
\n

Add a new redirect URL

\n
\n

Once the app is created, add a redirect URL to your app.

\n
    \n
  1. Select OAuth & Permissions.
    2. \n
  2. In the resulting pane, under Redirect URLs, select Add a new Redirect URL
    3. \n
  3. In the input box, enter https://slack.botframework.com  and select Add.
    4. \n
  4. Select Save URLs.
    5. \n
\n

\n
\n

Subscribe to bot events

\n
\n

After you add the redirect URL, you need to subscribe to events for the bot to work. 

\n
    \n
  1. Select Event Subscriptions.
    2. \n
  2. In the resulting pane, toggle Enable Events to On.
    3. \n
  3. For Request URL, enter https://slack.botframework.com/api/Events/{bot-name}
    4. \n
  4. Subscribe to the following events:
    5. \n
\n

member_joined_channel

\n

member_left_channel

\n

message.channels

\n

message.groups

\n

message.im

\n

message.mpim

\n

\n
\n

Enable sending messages to the bot by the users

\n
\n

After you subscribe to bot events, enable users to message your bot.

\n
    \n
  1. Select App Home.
    2. \n
  2. In the resulting pane, in the Show Tabs section under the Messages Tab, enable Allow users to send Slash commands and messages from the messages tab.
    3. \n
\n
\n

Add and configure interactive messages

\n
\n

Enable interactive messages so buttons in the bot will work:

\n
    \n
  1. Select Interactivity & Shortcuts.
    2. \n
  2. For Request URL, enter https://slack.botframework.com/api/Actions.
    3. \n
  3. Select Save changes.
    4. \n
\n
\n

Copy your app information

\n
\n

You'll need to provide the following information to the FAQ Bot team so they can add the Slack channel to your bot. Always copy and store app credentials in a safe place.

\n
    \n
  1. Select Basic Information.
    2. \n
  2. In the resulting pane, under App Credentials, locate Client ID, Client Secret, and Signing Secret.
    3. \n
  3. Now, select OAuth & Permissions.
    4. \n
  4. In the resulting pane, locate the Scopes section. Record the Bot Token Scopes for your app.
    5. \n
  5. Share this information with the FAQ Bot team.
    6. \n
\n
\n

Test your application in Slack

\n

Once you hear from the FAQ Bot team that Slack has been added to your bot, complete the following testing steps:

\n
\n
    \n
  1. Sign in to the Slack workspace where you installed your app.
    2. \n
  2. Under Apps, select your app.
    3. \n
  3. In the resulting pane, send messages to the application.
    4. \n
\n
\n

Additional information

\n
\n

For more information about Slack support for bots, see the Slack API documentation:

\n\n

 

\n
\n

What's different on Slack?

\n

Suggested actions

\n

Suggested action buttons are not supported on Slack - they will be converted to regular buttons.

\n

Truncated button text

\n

Button text may be truncated - use a maximum of 30 characters for best results. This affects:

\n\n

\n

Callouts and styling

\n

Callouts and custom styling (colours/CSS) don't display on Slack.

\n

Video

\n

YouTube videos will not display in Slack. You could add video links to your answers, but users would need to click the link to view the video (outside of Slack).

\n

Segmenting analytics

\n

FAQ Bot analytics are segmented by bot source, allowing you to review and analyse conversations on Slack vs other channels.

\n

\n

How to disable your Slack bot in the portal

\n

You can enable/disable your bot on Slack, to temporarily prevent your bot sending messages on this channel.

\n

To do this, navigate to the Channel settings tab on Configuration > Main and toggle off the \"bot enabled\" switch for Slack. Note this can take up to 15 minutes to take effect.

\n

","description":"","isMarkdown":false,"publishedOnUtc":"2024-04-10T23:48:40.3152177","modifiedOnUtc":"2023-02-15T03:40:42.6981611"}