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.

Add a bot

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:

https://raw.githubusercontent.com/howdyai/botkit-starter-ciscospark/master/public/default_icon.png

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).

Follow these instructions to run your bot locally, or by using a third-party service such as Glitch or Heroku.

You will need the following environment variables when running your bot:

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.

Is something missing or out of date?

This file is managed on Github. click here to view the source, and send us a pull request with your improvements!