Cisco Webex Teams
| Schemes | wxteams://, webex:// |
| Cargo feature | service-webexteams |
| Service | https://webex.teams.com/ |
| Body formats | markdown (first is the default) |
| Attachments | yes |
| Title length | no title (merged into the body) |
| Body length | 1,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | yes |
URL formats
{schema}://{token}
{schema}://{access_token}/{targets}
{schema} is one of wxteams://, webex://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{access_token} | Bot Access Token | string | yes | secret | |
{targets} | Room IDs | list | no | separated by / | |
{token} | Webhook Token | string | yes | secret; must match ^[a-z0-9]{80,160}$ |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
mode | Mode | choice | one of webhook, bot | |
to | Room IDs | list | sets {targets} | |
token | Webhook Token | string | sets {token} |
The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.
Examples
Accepted URLs (tokens are fake):
wxteams://BotToken1234567890/Y2lzY29zcGFyazovL3VzL1JPT00vabc
wxteams://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
https://api.ciscospark.com/v1/webhooks/incoming/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
webex://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
wxteams://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Y2lzY29zcGFyazovL3VzL1JPT00vabc?mode=b
wxteams://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?format=text
https://webexapis.com/v1/webhooks/incoming/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?format=text
wxteams://BotToken1234567890?to=Y2lzY29zcGFyazovL3VzL1JPT00vabc&mode=bot
Rejected URLs:
wxteams://
wxteams://:@/
wxteams://shorttoken?mode=webhook
wxteams://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?mode=invalid
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'wxteams://BotToken1234567890/Y2lzY29zcGFyazovL3VzL1JPT00vabc'
Notes
Cisco Webex Teams (wxteams://, webex://): messages through Webex incoming webhooks.