Setting up a bot for Cisco Webex Teams is one of the easiest experiences for bot developers! Follow these steps carefully to configure your bot.
The easiest path to creating a new bot for Webex Teams is through Botkit Studio. Sign up for an account here. This method will provide a guided path to hosting, along with other useful tools for creating and managing your bot.
For advanced users looking to run their own code, you will need to install Botkit and run it before your bot can be configured with Cisco Spark.
Follow the instructions to create a new bot in the Cisco Webex Teams Developer Portal.
Take note of the bot username, you'll need it later.
Note about your icon: Cisco requires you host an avatar for your bot before you can create it in their portal. This bot needs to be a 512x512px image icon hosted anywhere on the web. This can be changed later.
You can copy and paste this URL for a Botkit icon you can use right away:
Cisco will provide you an
access token that is specific to your bot. Write this down, you won't be able to see this later (but you will be able revoke it and create a new one).
You will need the following environment variables when running your bot:
access_token= Your token from Webex Teams (required)
secret= User-defined string to validate payloads (required)
public_address= URL of your bot server (required)
studio_token= Botkit Studio API token (optional)
You should now be able to search your Webex Teams for the bot username you defined, and add it to your team!
Read more about making bots for this platform in the Cisco Developer Portal.
This file is managed on Github. click here to view the source, and send us a pull request with your improvements!