{"id":17930,"date":"2016-10-28T17:18:54","date_gmt":"2016-10-28T17:18:54","guid":{"rendered":"https:\/\/developer.kore.com\/?post_type=docs&#038;p=8563"},"modified":"2021-03-25T09:51:09","modified_gmt":"2021-03-25T09:51:09","slug":"adding-the-cisco-spark-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-0\/docs\/bots\/channel-enablement\/adding-the-cisco-spark-channel\/","title":{"rendered":"Adding the Cisco Spark 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 add the Cisco Spark channel to your Bot, you will need a <em>Cisco Spark for Developers<\/em>\u00a0account to configure the connection between <em>Cisco<\/em>\u00a0Spark and Kore.ai. Adding the Cisco Spark channel to your Kore.ai Bot is a 4-step process to allow end-users for your Bot to interact with your Bot using their <em>Cisco Spark<\/em>\u00a0accounts. To add the Cisco Spark channel to your Bot, you will need to:<\/p>\n<ol>\n<li><strong>Create a Cisco Spark\u00a0App<\/strong> &#8211; In your <em>Spark for Developers<\/em>\u00a0account, you will need to create an app to provide authorization for communication between<i>\u00a0Cisco Spark<\/i>\u00a0and your Kore.ai Bot.\u00a0To create a <em>Cisco Spark<\/em>\u00a0app, you must have created and registered for a free account in the <a href=\"https:\/\/developer.ciscospark.com\/index.html\">Spark for Developers<\/a> portal.<\/li>\n<li><strong>Get an Access Token<\/strong> &#8211; To use Cisco Spark as a channel for your Kore.ai Bot, have a valid Spark <strong>Bot Username<\/strong> and generate an access token to provide authentication for communications.<\/li>\n<li><strong>Setup Integration<\/strong> &#8211; Define the Cisco Spark integration to your Kore.ai Bot by adding the Call Back URL to Kore.ai and setting the Cisco Spark app Scopes to receive and send messages to and from <i>Cisco Spark<\/i>.<\/li>\n<li><b>Enable<\/b> &#8211; After setting up the Cisco Spark app and entering configuration data in Bot Builder, you need to enable the channel.<\/li>\n<\/ol>\n<p><strong>To add the Cisco Spark\u00a0channel<\/strong><br \/>\nTo complete the following procedure, you must have, or register for a new developer account in the <em>Cisco Spark for Developers<\/em> portal.<\/p>\n<ol>\n<li>In Bot Builder, in the <strong>Bots<\/strong>\u00a0section, click\u00a0the Bot that\u00a0you want to add the Cisco Spark\u00a0channel to.<\/li>\n<li>On the <strong>Channels<\/strong>\u00a0tab, click the <strong>Expand<\/strong>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-8615 size-full\" src=\"\/wp-content\/uploads\/sites\/11\/RightArrowIcon.png\" width=\"9\" height=\"13\" \/> icon for the <b>Cisco Spark<\/b>\u00a0section. The <strong>Cisco Spark\u00a0Channel<\/strong>\u00a0page is displayed.<\/li>\n<li>In a new browser tab, sign in to your <em>Cisco Spark for Developers<\/em>\u00a0account, and then click <strong>My Apps<\/strong>. The <strong>My Apps<\/strong> page is displayed.<\/li>\n<li>To create a new <em>Cisco Spark<\/em> app, click the <strong>Plus<\/strong>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-9160\" src=\"\/wp-content\/uploads\/sites\/11\/DIYDialogTaskPlusIcon.png\" width=\"15\" height=\"15\" \/> icon. The <strong>New App<\/strong> page is displayed.<\/li>\n<li>In the Bot section, click <strong>Create a Bot<\/strong>. The <strong>New Bot<\/strong> page is displayed.<\/li>\n<li>In the <strong>Display name<\/strong> field, enter the name of your Bot displayed to end-users, for example, <span style=\"color: #0000ff\">Banking Bot<\/span>.<\/li>\n<li>In the <strong>Bot Username<\/strong> field, enter the name of the bot used to add the bot to a room, for example, <span style=\"color: #0000ff\">BankingBot<\/span>. Spaces cannot be used.<\/li>\n<li>In the <strong>Icon<\/strong> field,\u00a0enter a URL to the Bot icon, for example, <span style=\"color: #0000ff\">http:\/\/icons.iconarchive.com\/icons\/designbolts\/free-multimedia\/1024\/iMac-icon.png<\/span>.<\/li>\n<li>Click <strong>Add Bot<\/strong> as shown in the following illustration<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkNewBot.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-9444 alignnone\" src=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkNewBot.png\" alt=\"Adding a New Bot in Cisco Spark Developer Portal\" width=\"1273\" height=\"806\" \/><\/a><\/li>\n<li>When the Bot is saved, an <strong>Access Token<\/strong> is generated. Copy and paste bot the <strong>Access Token<\/strong> and the <strong>Bot Username<\/strong> from <em>Spark for Developers<\/em> to Kore.ai Bot Builder on the <strong>Generate Access Token<\/strong> tab for\u00a0the\u00a0<strong>Cisco Spark\u00a0Channel<\/strong> as shown in the following illustration.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkGenAccessTab.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-9445 alignnone\" src=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkGenAccessTab.png\" alt=\"Access Token for Cisco Spark\" width=\"1119\" height=\"910\" \/><\/a><\/li>\n<li>In the <em>Cisco Spark for Developers<\/em> portal, click <strong>My Apps<\/strong>, and then click the <strong>Plus<\/strong>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-9160\" src=\"\/wp-content\/uploads\/sites\/11\/DIYDialogTaskPlusIcon.png\" width=\"15\" height=\"15\" \/> icon. The <strong>New App<\/strong> page is displayed.<\/li>\n<li>In the <strong>Integration<\/strong>\u00a0section, click <strong>Create an Integration<\/strong>. The <strong>New Integration<\/strong> page is displayed.<\/li>\n<li>In the <strong>Name<\/strong> field, enter a name for this integration, for example,\u00a0<span style=\"color: #0000ff\">BankingBotIntegration<\/span>.<\/li>\n<li>In the <strong>Description<\/strong> field, enter a description for this integration configuration.<\/li>\n<li>In the <strong>Support Email<\/strong> field, enter the email address for end-users to use to ask for support for this integration.<\/li>\n<li>In the <strong>App Icon<\/strong> field, enter the URL of the icon image that you want to use for this integration, for example,\u00a0<span style=\"color: #0000ff\">http:\/\/icons.iconarchive.com\/icons\/designbolts\/free-multimedia\/1024\/iMac-icon.png<\/span>.<\/li>\n<li>In the <strong>Redirect URIs<\/strong> field, copy and paste the <strong>Redirect URL<\/strong> field from Bot Builder <strong>Setup Integration<\/strong> tab for the <strong>Cisco Spark Channel<\/strong> page, for example,\u00a0<span style=\"color: #0000ff\">https:\/\/idproxy-app.kore.ai\/workflows\/callback<\/span>.<\/li>\n<li>Click <strong>Add Integration<\/strong>. The integration settings are saved and the OAuth section with <strong>Client ID<\/strong> and <strong>Client Secret<\/strong> is displayed.<\/li>\n<li>Copy the <strong>Client ID<\/strong> and <strong>Client Secret<\/strong> from the <em>Spark for Developers<\/em> portal to the\u00a0Bot Builder <strong>Setup Integration<\/strong> tab for the <strong>Cisco Spark Channel<\/strong> as shown in the following illustration.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkSetUpIntegrationTab.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-9446 alignnone\" src=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkSetUpIntegrationTab.png\" alt=\"Adding Client ID and Client Secret\" width=\"1128\" height=\"902\" \/><\/a><\/li>\n<li>Click <strong>Next<\/strong>. The <strong>Enable Channel<\/strong> tab is displayed.<\/li>\n<li>In the <strong>Enable Channel<\/strong> section, click <strong>Yes<\/strong>, and then click <strong>Save<\/strong>.<\/li>\n<li>The channel configuration settings are saved and the <strong>Cisco Spark Channel<\/strong> page is closed.<\/li>\n<\/ol>\n<h1><span class=\"ez-toc-section\" id=\"Editing_the_Cisco_Spark_Channel\">Editing the Cisco Spark\u00a0Channel<\/span><\/h1>\n<p>To edit the Cisco Spark channel, hover your mouse over the channel to modify, and then click the <strong>Settings<\/strong> <img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-2113 size-full\" src=\"\/wp-content\/uploads\/sites\/11\/DIYSettingsIcon-1.png\" width=\"18\" height=\"18\" \/>\u00a0icon displayed to show the command menu displayed in the following illustration.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkEdit.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-9447 alignnone\" src=\"\/wp-content\/uploads\/sites\/11\/DIYChannelsTabCiscoSparkEdit.png\" alt=\"Editing the Cisco Spark Channel\" width=\"860\" height=\"214\" \/><\/a><br \/>\nSelect one of the following commands to modify the channel:<\/p>\n<ul>\n<li><strong>Edit<\/strong> &#8211; Click to open the <strong>Cisco Spark Channel<\/strong> setup page.<\/li>\n<li><strong>Disable\/Enable<\/strong> &#8211; Click <strong>Disable<\/strong> to temporarily disable use of the Cisco Spark channel for your Bot. When the channel is disabled, click <strong>Enable<\/strong> to enable use of the Cisco Spark channel.<\/li>\n<li><strong>Delete<\/strong> &#8211; Click <strong>Delete<\/strong>, and then click <strong>OK<\/strong> in the <strong>Delete Confirmation<\/strong> dialog to permanently delete the Bot channel configuration.\n<p class=\"warning\"><strong>Warning:<\/strong> This operation is permanent, and cannot be undone.<\/p>\n<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_medium 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 add the Cisco Spark channel to your Bot, you will need a Cisco Spark for Developers\u00a0account to configure the connection between Cisco\u00a0Spark and Kore.ai. Adding the Cisco Spark channel to your Kore.ai Bot is a 4-step process to allow end-users for your Bot to interact with your Bot using their Cisco Spark\u00a0accounts. To add...","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-17930","post","type-post","status-publish","format-standard","hentry","category-channel-enablement"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/posts\/17930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/comments?post=17930"}],"version-history":[{"count":4,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/posts\/17930\/revisions"}],"predecessor-version":[{"id":22462,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/posts\/17930\/revisions\/22462"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/media?parent=17930"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/categories?post=17930"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-0\/wp-json\/wp\/v2\/tags?post=17930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}