messaging-bots

Build Webex bots with adaptive cards, webhooks, and room tabs via wxcli.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/achobgood/wxops --skill messaging-bots-achobgood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: messaging-bots
Source: https://github.com/achobgood/wxops/tree/main/.claude/skills/messaging-bots
Command: npx skills add https://github.com/achobgood/wxops --skill messaging-bots-achobgood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Webex bots involves many failure-prone details: token type detection, scope verification, space membership, webhook configuration, and adaptive card payload rules. This Skill guides an AI agent through the entire bot-building workflow so nothing is missed. ## Core Features & Use Cases - Bot & Token Setup: Detect token type (bot, user, admin, service app), verify scopes, and confirm the bot is a member of the target space before sending messages. - Adaptive Card Flows: Select from six card recipes (notification, approval, form, status dashboard, incident alert, dropdown) and send them with the required fallback text field. - Webhooks & Interactions: Create webhooks for messages and attachmentActions, handle the bot interaction loop, and manage webhook auto-deactivation. - Use Case: A user wants an approval workflow in a Webex space. The Skill verifies the bot token, selects the approval card recipe, creates the attachmentActions webhook, sends the card, and verifies the response capture end to end. ## Quick Start Use the messaging-bots skill to build a Webex bot that sends an approval card to my ops space and captures the button responses via webhook.

Frequently Asked Questions about messaging-bots

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Webex bot that sends adaptive cards?

Create a bot at developer.webex.com, configure its token with wxcli configure, add the bot to the target space, then send a card with wxcli messages create using a JSON body containing the adaptive card attachment and a required fallback text field.

How do Webex bots receive adaptive card button responses?

Register a webhook for the attachmentActions resource with the created event pointing at a public HTTPS URL. When a user clicks Action.Submit, retrieve the input values with wxcli attachment-actions show using the action ID from the webhook payload.

Can a Webex bot token create room tabs or add itself to spaces?

No. Bot tokens get 403 on room tab operations, which require a moderator-level user token. Bots also cannot add themselves to spaces; a user must invite the bot via wxcli memberships create.

Why is my Webex bot webhook not receiving message text?

Bot message webhooks intentionally exclude message text as a Webex security measure. The bot must call wxcli messages show with the message ID from the webhook payload to retrieve the actual content.

Why did my Webex adaptive card fail to render?

Cards over 4KB silently fail to render, and Action.Execute from Adaptive Cards 1.4+ is unsupported by Webex. Use Action.Submit, keep payloads under 4KB, and always include the fallback text field.

What are the limitations of Webex service app tokens for messaging?

Service app tokens cannot post messages to spaces and receive 403 errors on message creation. Use a bot token or a user token instead; personal admin tokens work if the admin is a member of the space.