send_webex_adaptive_card
Send rich interactive Adaptive Card messages to Webex rooms or individuals. Requires card_body and fallback_text for non-supporting clients.
Instructions
Send an Adaptive Card message to a Webex room or person.
Adaptive Cards are rich, interactive message attachments. Clients that do not support cards will display fallback_text instead.
IMPORTANT — Webhook limitation: Card action submissions (Action.Submit) are delivered to the bot only if a webhook is registered for the "attachmentActions" resource on the Webex platform. Without that webhook, submissions are silently dropped and the bot never receives them. Inform the user of this limitation whenever the card includes interactive actions. To receive submissions, a webhook must be created at developer.webex.com or via the Webex Webhooks API targeting the bot's public HTTPS endpoint.
Args: room_id: Room ID to send the card to (use this OR to_person_id/to_person_email) to_person_id: Person ID to send a direct card to to_person_email: Person email to send a direct card to card_body: List of Adaptive Card body elements (required, non-empty). Each element must have a "type" field (e.g. "TextBlock", "Image", "ColumnSet"). Use build_webex_adaptive_card to generate this from high-level inputs. fallback_text: Plain-text fallback shown to clients that do not support cards (required) card_actions: Optional list of action objects (Action.OpenUrl, Action.Submit, etc.) card_version: Adaptive Card schema version — one of "1.0", "1.1", "1.2", "1.3" (default "1.3") parent_id: Parent message ID for threaded replies
Returns: Standardized response dictionary with success/error information
Examples: result = send_webex_adaptive_card( room_id="Y2lzY29zcGFyazovL3VzL1JPT00v...", fallback_text="Build passed", card_body=[ {"type": "TextBlock", "text": "Build Passed", "weight": "Bolder", "size": "Medium"}, {"type": "TextBlock", "text": "All 42 tests green", "color": "Good"}, ], card_actions=[ {"type": "Action.OpenUrl", "title": "View Logs", "url": "https://ci.example.com"} ], )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| room_id | No | ||
| card_body | No | ||
| parent_id | No | ||
| card_actions | No | ||
| card_version | No | 1.3 | |
| to_person_id | No | ||
| fallback_text | No | ||
| to_person_email | No |