{"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":"2023-02-15T09:01:27","modified_gmt":"2023-02-15T09:01:27","slug":"adding-the-cisco-spark-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-the-cisco-spark-channel\/","title":{"rendered":"Adding the Cisco Webex Teams"},"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><span style=\"font-weight: 400\">To add the Cisco Webex Teams (formerly Cisco Webex) channel to your VA, the developer must create a dedicated VA app and an integration app in Cisco Webex Teams.<\/span><\/p>\n<p><span style=\"font-weight: 400\">Adding the Cisco Webex Teams channel to your Kore.ai VA is a four-step process to allow end-users to interact with it using their <\/span><em><span style=\"font-weight: 400\">Webex <\/span><\/em><span style=\"font-weight: 400\">accounts.\u00a0<\/span><\/p>\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>\n<h1><span class=\"ez-toc-section\" id=\"Step_1_Create_a_Bot_with_Cisco_Webex_Team\"><span style=\"font-weight: 400\">Step 1: Create a Bot with Cisco Webex Team<\/span><\/span><\/h1>\n<p><span style=\"font-weight: 400\">To create a Bot from within Cisco Webex Teams, please follow the steps below:<\/span><\/p>\n<ol>\n<li style=\"font-weight: 400\"><a href=\"https:\/\/developer.webex.com\/\"><span style=\"font-weight: 400\">Log in to the Cisco Webex Developer Portal<\/span><\/a><span style=\"font-weight: 400\"> and proceed to the <\/span><strong>Start Building Apps<\/strong><span style=\"font-weight: 400\"> page or to the <\/span><strong>My Webex Apps<\/strong><span style=\"font-weight: 400\"> page.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Click the <\/span><strong>Create a New App<\/strong><span style=\"font-weight: 400\"> option and choose the <\/span><strong>Create a Bot<\/strong><span style=\"font-weight: 400\"> option.<br \/><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170346\/create-bot.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46876\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170346\/create-bot-1024x515.png\" alt=\"\" width=\"640\" height=\"322\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170346\/create-bot-1024x515.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170346\/create-bot-300x151.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170346\/create-bot.png 1329w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><br \/><\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Provide all the required information to create the bot and click on <\/span><strong>Add Bot<\/strong><span style=\"font-weight: 400\">.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">This step will create a <\/span><em><span style=\"font-weight: 400\">Bot User<\/span><\/em><span style=\"font-weight: 400\"> and an <\/span><em><span style=\"font-weight: 400\">Access Token<\/span><\/em><span style=\"font-weight: 400\"> is also generated for accessing this bot.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Make a note of the <\/span><strong>Bot Username<\/strong><span style=\"font-weight: 400\"> and <\/span><strong>Access Token<\/strong><span style=\"font-weight: 400\"> from this page.<br \/><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170338\/access-token-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46870\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170338\/access-token-2-1024x337.png\" alt=\"\" width=\"640\" height=\"211\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170338\/access-token-2-1024x337.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170338\/access-token-2-300x99.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170338\/access-token-2.png 1259w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><br \/><\/span><\/li>\n<\/ol>\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>\n<h1><span class=\"ez-toc-section\" id=\"Step_2_Enable_the_Cisco_Webex_Team_channel_from_the_XO_Platform\"><span style=\"font-weight: 400\">Step 2: Enable the Cisco Webex Team channel from the XO Platform<\/span><\/span><\/h1>\n<ol>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">In the XO Platform, select the assistant you want to add the channel to.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Go to <\/span><strong>Deploy &gt; Channels, <\/strong><span style=\"font-weight: 400\">and select <\/span><strong>Cisco Webex Teams<\/strong><span style=\"font-weight: 400\">. The channel window opens.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Enter the <\/span><strong>Bot Username<\/strong><span style=\"font-weight: 400\"> and <\/span><strong>Access Token<\/strong><span style=\"font-weight: 400\"> from the previous step.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Make a note of the <\/span><strong>Redirect URL<\/strong><span style=\"font-weight: 400\">.<\/span><\/li>\n<\/ol>\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>\n<h1><span class=\"ez-toc-section\" id=\"Step_3_Set_Up_an_Integration_with_Cisco_Webex_Team\"><span style=\"font-weight: 400\">Step 3: Set Up an Integration with Cisco Webex Team<\/span><\/span><\/h1>\n<ol>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">On the Cisco Webex Team Developer portal, click the <\/span><strong>Profile<\/strong><span style=\"font-weight: 400\"> drop-down list on the top-right and go to the <\/span><strong>My Webex Apps<\/strong><span style=\"font-weight: 400\"> page.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Click <\/span><strong>Create a New App<\/strong><span style=\"font-weight: 400\"> and choose the <\/span><strong>Create an Integration<\/strong><span style=\"font-weight: 400\"> option to add a new integration app for Webex.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Provide all the required details to create the integration like integration name, description, logo, etc. This information must be user-facing as this is displayed to end-users in the permissions dialog.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">For <\/span><strong>Redirect URI(s)<\/strong><span style=\"font-weight: 400\">, paste the <\/span><em><span style=\"font-weight: 400\">Redirect URL<\/span><\/em><span style=\"font-weight: 400\"> from the previous step.<\/span><\/li>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-message color_yellow\"><div class=\"w-message-body\"><p><b>Important<\/b>: The Redirect URI now includes the <b><i>streamid<\/i><\/b> in the API request to identify the virtual assistant being accessed. When an incoming request is qualified with this identifier, it helps with traceability, troubleshooting, and remediation at the network level during anomalies like malicious calls or unusual bot activity.<\/p><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<ol start=\"5\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Under <\/span><strong>Scopes<\/strong><span style=\"font-weight: 400\">, select <\/span><strong><em>spark:all<\/em><\/strong><span style=\"font-weight: 400\"> for enabling bot communication.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">After providing all the required information, click the <\/span><strong>Add Integration<\/strong><span style=\"font-weight: 400\"> to create the new integration app.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">This step creates a new integration app and also generates the Client ID and Client Secret for this app.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Make a note of the <\/span><strong>Client Id<\/strong><span style=\"font-weight: 400\"> and <\/span><strong>Client Secret<\/strong><span style=\"font-weight: 400\">.<\/span><\/li>\n<\/ol>\n<p><span style=\"font-weight: 400\">For further information, please see <\/span><a href=\"https:\/\/developer.webex.com\/docs\/integrations\"><span style=\"font-weight: 400\">Cisco\u2019s documentation<\/span><\/a><span style=\"font-weight: 400\">.\u00a0<\/span><\/p>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170349\/integration-successful.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46879\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170349\/integration-successful-1024x451.png\" alt=\"\" width=\"640\" height=\"282\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170349\/integration-successful-1024x451.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170349\/integration-successful-300x132.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170349\/integration-successful.png 1260w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\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>\n<h1><span class=\"ez-toc-section\" id=\"Step_4_Complete_Cisco_Webex_Team_Channel_Configuration_from_the_XO_Platform\"><span style=\"font-weight: 400\">Step 4: Complete Cisco Webex Team Channel Configuration from the XO Platform<\/span><\/span><\/h1>\n<ol>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">In the XO Platform, on the Channel Configuration page, enter the Post URL where you want Webex <\/span><strong>Client ID<\/strong><span style=\"font-weight: 400\"> and <\/span><strong>Client Secret<\/strong><span style=\"font-weight: 400\"> noted in the previous step.<\/span><\/li>\n<li style=\"font-weight: 400\"><strong>Enable Channel<\/strong><span style=\"font-weight: 400\"> to complete the configuration.<\/span><\/li>\n<li style=\"font-weight: 400\"><strong>Save<\/strong><span style=\"font-weight: 400\"> the configuration.<\/span><\/li>\n<\/ol>\n<p><span style=\"font-weight: 400\"><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170342\/add-webex.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46873\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170342\/add-webex.png\" alt=\"\" width=\"541\" height=\"582\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170342\/add-webex.png 779w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930170342\/add-webex-279x300.png 279w\" sizes=\"auto, (max-width: 541px) 100vw, 541px\" \/><\/a><\/span><\/p>\n<p><span style=\"font-weight: 400\">After the channel is enabled and all configurations are verified, you can optionally publish the assistant to make it available for end-users, with the new channel. Learn more about<\/span><a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/publish\/publishing-bot\/\"><span style=\"font-weight: 400\"> Publishing your Virtual Assistant<\/span><\/a><span style=\"font-weight: 400\">.<\/span><\/p>\n<p><span style=\"font-weight: 400\">To learn more about working with Channels within the Kore.ai XO Platform, please see<\/span><a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-channels-to-your-bot\/\"><span style=\"font-weight: 400\"> Channel Enablement.<\/span><\/a><\/p>\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>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To add the Cisco Webex Teams (formerly Cisco Webex) channel to your VA, the developer must create a dedicated VA app and an integration app in Cisco Webex Teams. Adding the Cisco Webex Teams channel to your Kore.ai VA is a four-step process to allow end-users to interact with it using their Webex accounts.\u00a0 Step...","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\/v10-1\/wp-json\/wp\/v2\/posts\/17930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=17930"}],"version-history":[{"count":11,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17930\/revisions"}],"predecessor-version":[{"id":54220,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17930\/revisions\/54220"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17930"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17930"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}