To add the Cisco Webex Teams (formerly Cisco Spark) channel to your bot, the developer must create a bot app and an integration app in Cisco Webex Teams.
Adding the Cisco Spark channel to your Kore.ai bot is a four-step process to allow end-users of your bot to interact with your bot using their Cisco Spark accounts. To add the Cisco Spark channel to your bot, follow the below steps:
- Create a Cisco Spark App – In your Spark for Developers account, you must 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 must enable the channel.
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 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.
Enable Cisco Webex Team channel from Bot Builder
- In Bot Builder, under 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.
Set Up Integration with Cisco Webex Team
- On the Cisco Webex Team Developer portal, click the Profile drop-down list on the top-right and go to the My Webex Apps page.
- Click Create a New App and choose the Create an Integration option to add a new integration app for Spark.
- 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.
- 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 to create the new integration app.
- This step creates 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.
Complete Cisco Webex Team Channel Configuration from Bot Builder
- In the Bot Builder platform, on the Channel Configuration page, enter the Client ID and Client Secret noted in the previous step.
- Enable Channel to complete the configuration.
- Save the configuration.
Edit Cisco Spark Channel
To edit the Cisco Spark channel, hover 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 the use of the Cisco Spark channel for your bot. When the channel is disabled, click Enable to enable the use of the Cisco Spark channel.
- Delete – Click Delete. On the Delete Confirmation dialog box, click OK to permanently delete the bot channel configuration.
Warning: This operation is permanent, and cannot be undone.