{"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":"2022-12-20T08:00:07","modified_gmt":"2022-12-20T08:00:07","slug":"adding-the-slack-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v9-3\/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 Slack as a channel, you must associate the assistant with a Slack app. Adding the Slack channel to your Kore.ai VA allows end-users to interact with it using their <\/span>Slack<\/span><\/em> accounts.<\/span><\/p>\n

To complete this procedure, you must already have a <\/span>Slack<\/span><\/em> account and be a member of a <\/span>Slack<\/span><\/em> team.<\/span><\/p>\n

<\/div><\/div>\n

Step 1: Create an App on Slack<\/span><\/span><\/h1>\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, <\/span>Login <\/span><\/a>to the Slack developer portal and go to the Apps section <\/span>https:\/\/api.slack.com\/apps<\/span><\/a>. If this is your first app, click <\/span>Create an App<\/strong> and if you already have some apps, then click <\/span>Create New App<\/strong>.
    \"\"<\/a><\/span>
    <\/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 <\/span>Create App<\/strong> window, enter the <\/span>App Name<\/strong> and select a team from the Development Slack Team drop-down list. Use your assistant\u2019s name as the App Name.
    \"\"<\/a><\/span>
    <\/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
    <\/div><\/div>\n

    Step 2: Set Redirect URL and Scopes<\/span><\/span><\/h1>\n
      \n
    1. Go to the <\/span>OAuth & Permissions<\/strong> tab and click <\/span>Add a new Redirect URL<\/strong>. Copy the Redirect URL provided in the <\/span>Configurations<\/strong> tab of the Slack channel page within the XO Platform and enter in the <\/span>Redirect URLs<\/strong> field.<\/span><\/li>\n
    2. Click <\/span>Add<\/strong> a new Redirect URL<\/strong>, then click <\/span>Save URLs<\/strong>.
      \"\"<\/a><\/span>
      <\/span><\/li>\n
    3. Proceed to <\/span>Scopes ><\/strong> Bot Token Scopes<\/strong> section.<\/span><\/li>\n
    4. Add \u2018<\/span>incoming-webhook<\/span><\/em>\u2018,\u2018<\/span>chat:write<\/span><\/em>\u2018, ‘users:read.email<\/em>‘, and ‘users:read<\/em>‘ scopes.<\/span><\/li>\n
    5. 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
    6. If you would like to send Proactive Notifications to your users on Slack, then select the <\/span>users:read<\/span><\/em>, <\/span>users:read.email<\/span><\/em>, <\/span>team:read<\/span><\/em> scopes.
      \"\"<\/a>
      <\/span><\/li>\n<\/ol>\n
      <\/div><\/div>\n

      Step 3: Install the App<\/span><\/span><\/h1>\n
        \n
      1. Next, navigate to the <\/span>OAuth Tokens & Redirect URLs<\/strong> section, and select the <\/span>Install to Workspace<\/strong> option. Choose the required Workspace and complete the process.
        \"\"<\/a><\/span>
        <\/span><\/li>\n
      2. Optionally, if you would like to send Proactive Notifications to your users on Slack, copy the <\/span>Bot User OAuth Token<\/strong> from the <\/span>OAuth Tokens for Your Workspace <\/strong>section and provide it in the Slack Channel Configurations tab within the XO Platform.
        <\/span><\/li>\n<\/ol>\n

        \"\"<\/a>
        <\/span><\/p>\n

        <\/div><\/div>\n

        Step 4 : Enable Interactivity<\/span><\/span><\/h1>\n
          \n
        1. To enable Interactive Components, go to the <\/span>Interactivity & Shortcuts<\/strong> section and enable <\/span>Interactivity<\/strong>. Copy the <\/span>Webhook URL<\/strong> provided in the <\/span>Configurations<\/strong> tab of this page and enter it in the <\/span>Request URL<\/strong> field.<\/span><\/li>\n
        2. Click Save Changes<\/strong>.<\/span><\/li>\n<\/ol>\n


          <\/span>          \"\"<\/a><\/span>
          <\/span><\/p>\n

          <\/div><\/div>\n

          Step 5 : Enable Events<\/span><\/span><\/h1>\n

          Go to the <\/span>Event Subscriptions<\/strong> section and activate the <\/span>Enable Events<\/strong> option.<\/span><\/p>\n

            \n
          1. Copy the <\/span>Webhook URL<\/span><\/em> provided in the <\/span>Configurations<\/span><\/em> tab of Slack Channel page and enter it in the <\/span>Request URL<\/strong> field.<\/span><\/li>\n
          2. In the <\/span>Subscribe to Bot Events<\/strong> section, add <\/span>app_mention<\/span><\/em>, <\/span>message_channels,<\/span><\/em> and <\/span>message_im<\/span><\/em> events.<\/span><\/li>\n
          3. In the <\/span>Subscribe to Workspace Events<\/strong> section, add <\/span>message_im<\/span><\/em> event.<\/span><\/li>\n
          4. Click <\/span>Save Changes<\/strong>.<\/span><\/li>\n<\/ol>\n

            \"\"<\/a><\/span><\/p>\n

            <\/div><\/div>\n

            Step 6: Enable Interactions from the Messages tab<\/span><\/span><\/h1>\n

            Navigate to the <\/span>App Home<\/strong> section and under <\/span>Show tabs<\/strong>. enable the <\/span>Messages Tab<\/strong> and also enable the <\/span>Allow users to send Slash commands and messages from the messages tab<\/strong>. This is required to allow your users to directly interact with the app from the Messages tab.<\/span><\/p>\n

            \"\"<\/a><\/span><\/p>\n

            <\/div><\/div>\n

            Step 7: Configure App Credentials<\/span><\/span><\/h1>\n

            Go to the <\/span>Basic Information<\/strong> section and scroll down to the <\/span>App Credentials<\/strong> section. Capture the values for <\/span>Client ID<\/strong>, <\/span>Client Secret<\/strong>, and <\/span>Verification Token<\/strong> fields and provide them in the <\/span>Configurations<\/strong> tab of the Slack Channel within the XO Platform.<\/span>
            <\/span><\/p>\n

            \"\"<\/a><\/span><\/p>\n

            <\/div><\/div>\n

            Step 8: Manage Distribution<\/span><\/span><\/h1>\n

            If you want to enable the public distribution of your app on Slack, you must proceed with the following steps. Go to the <\/span>Manage Distribution<\/strong> section and click on <\/span>Remove Hard Coded Information<\/strong>.<\/span><\/p>\n

            Select the checkbox <\/span>I\u2019ve reviewed and removed any hard-coded information<\/strong> and click <\/span>Activate Public Distribution.<\/strong>
            <\/strong><\/p>\n

            \"\"<\/a><\/strong><\/p>\n

            <\/div><\/div>\n

            Step 9: Enable the Channel<\/span><\/span><\/h1>\n

            Go to the <\/span>Configurations<\/strong> tab to review and complete the channel setup. Click <\/span>Authorize <\/strong>under the app credentials area. Under <\/span>Enable Channel<\/strong>, select <\/span>Yes <\/strong>and click on <\/span>Save <\/strong>to enable the Slack channel.<\/span><\/p>\n

            \"\"<\/a><\/span><\/p>\n

            The <\/span>Successfully added Slack channel<\/span><\/em> message is displayed at the top of the XO Platform. In <\/span>Slack<\/span><\/em>, it is optional to submit your app to the Slack App Directory.<\/span><\/p>\n

            After the channel is enabled and all configurations are verified, you can optionally publish<\/span><\/p>\n

            the assistant to make it available for end-users, with the new channel. Learn more about<\/span><\/p>\n

            Publishing your Virtual Assistant<\/span><\/a>.<\/span><\/p>\n

            To learn more about working with Channels within the Kore.ai XO Platform, please see <\/span>Channel Enablement.<\/span><\/a><\/p>\n

            <\/div><\/div>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To set up Slack as a channel, you must associate the assistant with a Slack app. Adding the Slack channel to your Kore.ai VA allows end-users to interact with it using their Slack accounts. To complete this procedure, you must already have a Slack account and be a member of a Slack team. Step 1:...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-17878","post","type-post","status-publish","format-standard","hentry","category-channel-enablement"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/17878","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/comments?post=17878"}],"version-history":[{"count":12,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/17878\/revisions"}],"predecessor-version":[{"id":49781,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/posts\/17878\/revisions\/49781"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/media?parent=17878"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/categories?post=17878"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v9-3\/wp-json\/wp\/v2\/tags?post=17878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}