BusyBot

Reference · Credentials

Cisco Webex API credentials

Used by 2 BusyBot nodes.

Type ciscoWebexApi 2 fields

The Cisco Webex credential holds a personal access token or a bot token from the Webex developer portal, plus an optional webhook secret used to verify incoming trigger payloads with HMAC-SHA1.

Fields

FieldTypeRequiredNotes
Access Token
accessToken		 password Yes Personal access token or bot token from the Cisco Webex Developer portal.
Webhook Secret
webhookSecret		 password No Secret used for HMAC-SHA1 signature verification of incoming webhook payloads.

Getting your credentials

  1. Sign in to the Webex developer portal.
  2. For automation, create a bot and copy its access token — bot tokens are long-lived and act as the bot rather than as you.
  3. Alternatively, copy your personal access token from the portal for testing. Personal tokens are short-lived and expire, so they are not suitable for production.
  4. Paste the token into the credential’s Access Token field.
  5. If you use the Webex trigger, set a Webhook Secret and configure the same value on the Webex side so incoming payloads can be verified.

Permissions and scopes

A bot only sees spaces it has been added to, so add it to the relevant rooms. A personal token carries your own access to everything you can see, which is broader than most automations need.

Troubleshooting

  • Token stopped working after a day — you used a personal access token, which expires. Use a bot token for anything ongoing.
  • Bot cannot see a space — add the bot to that space in Webex.
  • Webhook signature failures — the webhook secret in BusyBot and the one configured in Webex do not match.

Frequently asked questions

Should I use a personal token or a bot token?

A bot token for anything ongoing. Personal access tokens from the developer portal expire quickly, which makes them fine for testing and wrong for production.

What is the webhook secret for?

Verifying incoming webhook payloads with HMAC-SHA1. Set the same value in Webex and in the credential, or verification fails.

Why can the bot not post in a room?

Bots only see spaces they have been added to. Add the bot to the room in Webex first.

Nodes that use Cisco Webex API

One credential works across every node below — create it once and reuse it.

Last updated . Spotted something wrong? Tell us.