To add the Cisco Webex Teams (formerly Cisco Spark) channel to your Bot, the developer will need to create a Bot app and also an Integration app in Cisco Webex Teams.
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 accounts. To add the Cisco Spark channel to your Bot, you will need to:
- Create a Cisco Spark App – In your Spark for Developers account, you will need to create an app to provide authorization for communication between Cisco Spark and your Kore.ai Bot. To create a Cisco Spark app, you must have created and registered for a free account in the Spark for Developers portal.
- Get an Access Token – To use Cisco Spark as a channel for your Kore.ai Bot, have a valid Spark Bot Username and generate an access token to provide authentication for communications.
- Setup Integration – 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 Cisco Spark.
- Enable – After setting up the Cisco Spark app and entering configuration data in Bot Builder, you need to enable the channel.
Step 1: Create Bot with Cisco Webex Team
- Log in to the Cisco Webex Developer portal and proceed to the Start Building Apps page or to the My Webex Apps page.
- Click the ‘Create a New App’ option, and then choose the ‘Create a Bot’ option.
- Provide all the required information to create the bot and click on ‘Add Bot’.
- This step will create a Bot User and an Access Token is also generated for accessing this Bot.
- Make a note of the Bot Username and Access Token from this page.
Step 2: Enable Cisco Webex Team channel from Bot Builder
- In Bot Builder, in the Bots section, click the Bot that you want to add the Cisco Spark channel to.
- On the Channels tab, select the Cisco Webex Teams channel to open the corresponding Channel page.
- Enter the Bot Username and Access Token from the previous step.
- Make a note of the Redirect URL.
Step 3: Setup Integration with Cisco Webex Team
- On the Cisco Webex Team Developer portal, proceed to the ‘My Webex Apps’ page from the Profile dropdown on the top right.
- Click ‘Create a New App’ and then choose the ‘Create an integration’ option to add a new integration app for Spark.
- Provide all the required details for creating the integration like integration name, description, logo etc. This information should be user-facing as this will be displayed to end-users in the permissions dialog.
- For Redirect URI(s), copy ‘Redirect URL’ from the previous step.
- Under Scopes, select “spark:all” for enabling bot communication.
- After providing all the required information, click the ‘Add Integration’ button to create the new integration app.
- This step will create a new integration app and also generates the Client ID and Client Secret for this app.
- Make a note of the Client Id and Client Secret.
Step 4: Complete Cisco Webex Team channel configuration from Bot Builder
- In the Bot Builder platform, Channel configuration page, enter the Client ID and Client Secret noted in the previous step.
- Enable Channel to complete the configuration.
- Save the configuration.
Editing the Cisco Spark Channel
To edit the Cisco Spark channel, hover your mouse over the channel to modify, and then click the Settings icon displayed to show the command menu.
Select one of the following commands to modify the channel:
- Edit – Click to open the Cisco Spark Channel setup page.
- Disable/Enable – Click Disable to temporarily disable use of the Cisco Spark channel for your Bot. When the channel is disabled, click Enable to enable use of the Cisco Spark channel.
- Delete – Click Delete, and then click OK in the Delete Confirmation dialog to permanently delete the Bot channel configuration.
Warning: This operation is permanent, and cannot be undone.