{"id":17878,"date":"2016-08-08T16:59:19","date_gmt":"2016-08-08T16:59:19","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&p=4945"},"modified":"2024-04-30T10:02:04","modified_gmt":"2024-04-30T09:02:04","slug":"adding-the-slack-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-2\/docs\/bots\/channel-enablement\/adding-the-slack-channel\/","title":{"rendered":"Adding the Slack Channel"},"content":{"rendered":"
\r\n\t
\r\n\t\t
\r\n\t\t\t

To set up the Slack channel on the XO Platform and interact with a VA using a Slack account, you must associate the VA with a Slack app.<\/p>\n

The Slack channel integration supports Direct Messaging (DM) and Channel (group) conversations via the Platform. When a VA is added to a channel (group) within the Slack organization space, any member can start a group conversation using @mentions<\/em><\/code> to talk to a specific VA.<\/p>\n

The XO Platform offers native support for threaded conversations in the Slack channel. Users can initiate a new thread from any message within a Slack channel or direct message group and continue a conversation with the VA. <\/span>The XO Platform leverages Slack\u2019s Threads<\/strong> to enable one-on-one conversations without losing the conversation context.<\/p>\n

Additionally, the Platform allows developers to configure how the Slack channel integration should handle DM and group conversations. It can automatically create a new thread whenever a user @mentions the virtual assistant in a Slack channel. This configuration flexibility gives developers control over the Threads feature.<\/span>
\n<\/span><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n

Note<\/b>: To use Slack Threads<\/b> for your Virtual Assistant deployed on the Slack Channel, add the Bot token Scope \u201cchat:write.public<\/code>\u201d to the existing Slack app under OAuth & Permissions<\/b> > Scopes<\/b> > Bot Token Scopes<\/b>. Learn more<\/a>.<\/p><\/div><\/div>\r\n\t

\r\n\t\t
\r\n\t\t\t

Prerequisites<\/strong><\/p>\n

To enable this integration, you must already have a Slack<\/em> account and be a member of a Slack<\/em> organization space.<\/p>\n

Setup Flow<\/strong><\/p>\n

To set up Slack as a channel, the developer should associate the VA with a Slack app, set up a bot user, and enable interactive components for this app. The important steps include:<\/p>\n

    \n
  1. Create an App on Slack<\/a>.<\/li>\n
  2. Set Redirect URL and Scopes<\/a>.<\/li>\n
  3. Install the App<\/a>.<\/li>\n
  4. Enable Interactivity<\/a>.<\/li>\n
  5. Enable Events<\/a>.<\/li>\n
  6. Enable Interactions from the Message Tab<\/a>,<\/li>\n
  7. Configure App Credentials<\/a>.<\/li>\n
  8. Manage Distribution<\/a>.<\/li>\n
  9. Enable the Channel on the XO Platform<\/a>.<\/li>\n<\/ol>\n

    Step 1: Create an App on Slack<\/span><\/span><\/h2>\n
      \n
    1. In the XO Platform, select the assistant to which you want to add the Slack Channel.<\/span><\/li>\n
    2. Go to <\/span>Deploy > Channels > Slack<\/strong>, and open the <\/span>Configuration <\/strong>tab.<\/span><\/li>\n
    3. In a new browser tab, Login<\/a> to the Slack developer portal and go to the Your Apps<\/strong> section https:\/\/api.slack.com\/apps<\/a>. If this is your first app, click Create an App<\/strong>. If you already have some apps, then click Create New App<\/strong>.
      \n      \"\"<\/a><\/span>
      \n<\/span><\/li>\n
    4. You will now be asked to <\/span>choose how you\u2019d like to configure your app\u2019s scopes and settings. Select <\/span>From Scratch<\/strong>.<\/span><\/li>\n
    5. On the Create a Slack App<\/strong> window, enter the App Name<\/strong> and select a team from the Development Slack Team drop-down list. Use your assistant\u2019s name as the App Name.
      \n<\/span>
      \n      \"\"<\/a><\/span><\/li>\n
    6. After you enter the required information, click <\/span>Create App<\/strong>. Slack will now create a new app and you are redirected to the <\/span>Basic Information<\/strong> section of the new app.<\/span><\/li>\n<\/ol>\n

      Step 2: Set Redirect URL and Scopes<\/span><\/span><\/h2>\n
        \n
      1. Click OAuth & Permissions<\/strong> on the left menu and click Add New Redirect URL <\/strong>on the resulting page.<\/li>\n
      2. On the XO Platform, copy the Redirect URL provided in the Configurations<\/strong> section of the Slack channel window and paste it in the Redirect URLs<\/strong> field of the OAuth Tokens & Redirect URLs<\/strong> page.<\/li>\n
      3. Click Add<\/strong>, and then click Save URLs<\/strong>.
        \n<\/span>
        \n        \"\"<\/a><\/span><\/li>\n
      4. Proceed to <\/span>Scopes ><\/strong> Bot Token Scopes<\/strong> section.<\/span><\/li>\n
      5. Add \u2018incoming-webhook<\/code><\/em>\u2019, \u2018chat:write<\/code><\/em>\u2019, and \u2018chat:write.public<\/code><\/em>\u2019 scopes.<\/li>\n
      6. If you would like your users to send attachments to your bot, then select the \u2018<\/span>files:write<\/span><\/em>\u2019 scope.<\/span><\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n

        Note<\/b>:<\/p>\n