{"id":17878,"date":"2016-08-08T16:59:19","date_gmt":"2016-08-08T16:59:19","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&#038;p=4945"},"modified":"2021-03-30T13:02:34","modified_gmt":"2021-03-30T12:02:34","slug":"adding-the-slack-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-1\/docs\/bots\/channel-enablement\/adding-the-slack-channel\/","title":{"rendered":"Adding the Slack Channel"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>To setup Slack as a channel, you will need to associate the bot with a Slack app. Adding the Slack channel to your Kore.ai Bot allows end-users for your bot to interact with your bot using their <em>Slack<\/em> accounts.<\/p>\n<ol>\n<li><b>Create a Slack App<\/b> \u2013 Create and configure a new app in <em>Slack<\/em>, and then copy app data from Kore.ai Bot Builder into the <em>Slack<\/em> app configuration for the bot name and Redirect URL.<\/li>\n<li><b>Copy Authorization Details<\/b> \u2013 Copy app authorization details from <em>Slack<\/em> to the Bot Builder Slack channel <strong>Get App Details<\/strong> tab.<\/li>\n<li><b>Create a Bot User in Slack<\/b> \u2013 In <em>Slack<\/em>, add a bot username to identify your bot.<\/li>\n<li><b>Enable the Channel<\/b> \u2013 In Bot Builder, save the channel settings.<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p><b>To add the Slack channel to a bot<\/b><br \/>\nTo complete this procedure, you must already have a <em>Slack<\/em> account and be a member of a <em>Slack<\/em> team.<\/p>\n<p>NOTE: The steps have been modified in ver7.1 of the platform in sync with changes to the channel requirements.<\/p>\n<ol>\n<li>In the <b>Bots<\/b> section of the Bot Builder, click the Bot that you want to add the Slack channel to.<\/li>\n<li>On the <b>Channels<\/b> tab, click the <b>Slack <\/b>icon. The <b>Slack Channel<\/b> page gets displayed.<\/li>\n<li>In a new browser tab, <a href=\"https:\/\/api.slack.com\/\">Login <\/a>to Slack developer portal and navigate to Apps section <a href=\"https:\/\/api.slack.com\/apps\">https:\/\/api.slack.com\/apps<\/a>. If this is your first app, click on <b>Create an App<\/b> and if you already have some apps, then click on <b>Create New App<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/1-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-14102 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/1-1.png\" alt=\"\" width=\"1321\" height=\"463\" \/><\/a><\/li>\n<li>In the <b>Create App<\/b> pop-up screen, enter <b>App Name<\/b> and select a team from Development Slack Team drop-down. Use your bot name as the App Name.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14103 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/2.png\" alt=\"\" width=\"550\" height=\"231\" \/><\/a><\/li>\n<li>After entering the required information, click on <b>Create App<\/b>. Slack will now create a new app and you would be redirected to <b>Basic Information<\/b> section of the new app.<\/li>\n<li>Navigate to <b>OAuth &amp; Permissions<\/b> tab and click on <b>Add a new Redirect URL<\/b>. Copy the Redirect URL provided in the Configurations tab of Slack channel page and enter in the <b>Redirect URLs<\/b> <b>field<\/b>. Click on <b>Add<\/b> and then click on <b>Save URLs<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/3-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14112 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/3-1.png\" alt=\"\" width=\"500\" height=\"284\" \/><\/a><br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/4-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14108 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/4-1.png\" alt=\"\" width=\"500\" height=\"292\" \/><\/a><\/li>\n<li>To create a <b>Bot user<\/b>, navigate to Bot Users section and click on <b>Add a Bot User.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/5-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14111 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/5-1.png\" alt=\"\" width=\"450\" height=\"289\" \/><\/a><br \/>\n<\/b><\/li>\n<li>Provide values for <b>Display name<\/b>, <b>the Default username<\/b> and then\u00a0<b>Save<\/b> changes. Try to use your bot name as <b>Display name<\/b> and <b>Default username<\/b>. A bot user is now added to your Slack app.<\/li>\n<li>To enable Interactive Components, navigate to <b>Interactive Messages<\/b> section and click on <b>Enable Interactive Components<\/b>. Copy the Webhook URL provided in the Configurations tab of this page and enter it in <b>Request URL<\/b> field. Click on <b>Save Changes<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/6.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14110 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/6.png\" alt=\"\" width=\"500\" height=\"288\" \/><\/a><\/li>\n<li>Navigate to the <strong>Event Subscriptions<\/strong> section and activate the <strong>Enable Events<\/strong>\u00a0option.\n<ul>\n<li>Copy the <em>Webhook URL<\/em> provided in the <em>Configurations<\/em> tab of Slack Channel page and enter it in the <strong>Request URL<\/strong>\u00a0field.<\/li>\n<li>In the <strong>Subscribe to Bot Events<\/strong>\u00a0section, add \u201c<em>app_mention<\/em>\u201d, \u201c<em>message_channels<\/em>\u201d and \u201c<em>message_im<\/em>\u201d events.<\/li>\n<li>In the <strong>Subscribe to Workspace Events<\/strong>\u00a0section, add \u201c<em>message_im<\/em>\u201d event.<\/li>\n<li>Click <strong>Save Changes<\/strong>.<\/li>\n<\/ul>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/Slack-7.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-22507\" src=\"\/wp-content\/uploads\/sites\/12\/Slack-7.png\" alt=\"\" width=\"1366\" height=\"1664\" \/><\/a><\/li>\n<li>Navigate to <b>Basic Information<\/b> section and scroll down to <b>App Credentials<\/b> section. Capture the values of <b>Client ID<\/b>, <b>Client Secret<\/b>, and <b>Verification Token<\/b> fields and provide them in the <b>Configurations<\/b> tab of Slack Channel page.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/7.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14114 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/7.png\" alt=\"\" width=\"450\" height=\"341\" \/><\/a><\/li>\n<li>If you would like to enable public distribution of your app on Slack, you would need to proceed with following steps. Navigate to <b>Manage Distribution<\/b> section and click on <b>Remove Hard Coded Information<\/b> and select the checkbox <b><i>I&#8217;ve reviewed and removed any hard-coded information<\/i><\/b> and click on <b>Activate Public Distribution.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/8.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14115 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/8.png\" alt=\"\" width=\"450\" height=\"493\" \/><\/a><br \/>\n<\/b><\/li>\n<li>After you submit your app for public distribution on Slack, you can also optionally submit your app to the Slack directory. Click on <b>Submit to App Directory<\/b> option and you will be redirected to separate form. Fill out the form and submit for approval.<\/li>\n<li>Navigate to the <b>Configurations<\/b> tab to review and complete the channel setup.<\/li>\n<\/ol>\n<p>The <em>Successfully added Slack channel<\/em> message is displayed at the top of the Bot Builder Homepage. In <em>Slack<\/em>, it is optional to submit your app to the Slack App Directory.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h1><span class=\"ez-toc-section\" id=\"Editing_the_Slack_Channel\">Editing the Slack Channel<\/span><\/h1>\n<p>To edit the Slack channel, hover your mouse over the channel and click to modify. You can make necessary updates to your channel configurations and save them. You may also disable or delete the channel information by clicking the <b>Settings icon.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/9.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14116 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/9.png\" alt=\"\" width=\"500\" height=\"218\" \/><\/a><\/b>Select one of the following commands to modify the channel:<\/p>\n<ul>\n<li><b>Disable\/Enable<\/b> \u2013 Click <b>Disable<\/b> to temporarily disable use of the Slack channel for your Bot. To enable the use of the Slack, click <b>Enable<\/b>.<\/li>\n<li><b>Delete<\/b> \u2013 Click <b>Delete<\/b>, and then click <b>OK<\/b> in the <b>Delete Confirmation<\/b> dialog to permanently delete the Bot channel configuration.<\/li>\n<\/ul>\n<div class=\"alert alert-warning\"><b>Warning:<\/b> This operation is permanent, and cannot be undone.<\/div>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To setup Slack as a channel, you will need to associate the bot with a Slack app. Adding the Slack channel to your Kore.ai Bot allows end-users for your bot to interact with your bot using their Slack accounts. Create a Slack App \u2013 Create and configure a new app in Slack, and then copy...","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\/v7-1\/wp-json\/wp\/v2\/posts\/17878","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/comments?post=17878"}],"version-history":[{"count":3,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/17878\/revisions"}],"predecessor-version":[{"id":22649,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/17878\/revisions\/22649"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/media?parent=17878"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/categories?post=17878"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/tags?post=17878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}