Webex Automation

Automate Cisco Webex collaboration workflows -- send messages, manage rooms and teams, configure webhooks, and look up people -- all through natural language.

Toolkit docs: composio.dev/toolkits/webex

Setup

Add the Rube MCP server to your environment: https://rube.app/mcp

Connect your Webex account when prompted (OAuth flow via Composio)

Start issuing natural language commands for Webex automation

Core Workflows

1. Send a Message to a Room or Person

Post plain text, markdown, file attachments, or Adaptive Cards to any Webex room or directly to a person.

Tool: WEBEX_MESSAGING_CREATE_MESSAGE

Key parameters:

roomId -- target room ID (use WEBEX_MESSAGING_LIST_ROOMS to find it)

toPersonEmail -- send a private 1:1 message instead (mutually exclusive with roomId)

text -- plain text content (max 7439 bytes)

markdown -- markdown-formatted content (takes precedence over text)

files -- list of public URLs for file attachments (one file per message)

attachments -- Adaptive Card JSON (one card per message)

parentId -- reply to a specific message as a threaded response

Example prompt:
> "Send a markdown message to room Y2lz... saying Deploy completed with a link to the release notes"

2. List and Discover Rooms

Browse all rooms you belong to, filtered by type, team, or sorted by activity.

Tool: WEBEX_MESSAGING_LIST_ROOMS

Key parameters:

type -- filter by direct (1:1) or group

teamId -- limit to rooms in a specific team

sortBy -- sort by id, lastactivity, or created

max -- limit results (1-1000, default 100)

Follow-up with WEBEX_MESSAGING_GET_ROOM_DETAILS to get full metadata for a specific room including title, type, lock status, creator, and timestamps.

Example prompt:
> "List my 10 most recently active group rooms in Webex"

3. Manage Webhooks for Event-Driven Automation

Create webhooks to receive real-time HTTP POST notifications when Webex resources change.

Tool: WEBEX_WEBHOOKS_CREATE_WEBHOOK

Key parameters:

name -- human-friendly webhook name (required)

targetUrl -- URL that receives POST notifications (required)

resource -- what to monitor: messages, rooms, memberships, meetings, recordings, meetingParticipants, telephony_calls, etc. (required)

event -- trigger type: created, updated, deleted, started, ended, joined, left (required)

filter -- scope notifications (e.g., roomId=<id> or hostEmail=<email>)

secret -- optional HMAC secret for payload signature verification

ownedBy -- creator for personal or org for organization-wide webhooks

Supporting tools:

WEBEX_LIST_WEBHOOKS -- list all registered webhooks with optional max and ownedBy filters

WEBEX_WEBHOOKS_GET_WEBHOOK -- inspect a specific webhook by webhookId

Example prompt:
> "Create a webhook called 'New Messages' that POSTs to https://my-app.com/hook whenever a message is created in room Y2lz..."

4. Manage Team Memberships

Add people to Webex teams and optionally grant moderator privileges.

Tool: WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP

Key parameters:

teamId -- the team to add the person to (required)

personEmail -- email of the person to add

personId -- Webex person ID (alternative to email)

isModerator -- set to true for moderator access (default false)

Use WEBEX_LIST_TEAMS to discover available teams first.

Example prompt:
> "Add alice@example.com as a moderator to team Y2lz..."

5. Audit Room Memberships

Check who is in a room, verify a specific person's membership, or list memberships across teams.

Tool: WEBEX_MESSAGING_LIST_MEMBERSHIPS

Key parameters:

roomId -- list all members of a specific room

personEmail -- check if a person is a member (requires roomId)

personId -- check by Webex person ID (requires roomId)

teamId -- filter by team association

max -- limit results

Example prompt:
> "List all members of room Y2lz... and tell me who the moderators are"

6. Search and Look Up People

Look up people in your Webex organization by email, display name, or ID.

Tool: WEBEX_PEOPLE_LIST_PEOPLE

Use to resolve names to person IDs before sending direct messages or adding team members.

Example prompt:
> "Find the Webex person ID for bob@company.com"

Known Pitfalls

Pitfall	Details
Webhook auto-disable	Target URL must respond with HTTP 2xx; 100 failures in 5 minutes disables the webhook automatically
Message size limit	Both `text` and `markdown` have a 7439-byte maximum
One file per message	The `files` array accepts a list but only one attachment is actually supported per message
One card per message	Only one Adaptive Card attachment is supported per message
Mutually exclusive targets	`roomId` and `toPersonEmail`/`toPersonId` cannot be used together when sending messages
Room update requires title	`WEBEX_UPDATE_ROOM` always requires the `title` parameter, even when only changing lock status or team
orgPublicSpaces conflicts	Cannot combine `orgPublicSpaces` with `teamId`, `type`, or `sortBy` when listing rooms
Webhook read scope	Creating a webhook requires `read` scope on the monitored resource type
Membership filter requires roomId	`personEmail` and `personId` filters in list memberships require `roomId` unless you are a Compliance Officer

Quick Reference

Action	Tool Slug	Key Params
Send message	`WEBEX_MESSAGING_CREATE_MESSAGE`	`roomId`, `text`/`markdown`, `toPersonEmail`
List rooms	`WEBEX_MESSAGING_LIST_ROOMS`	`type`, `sortBy`, `max`
Get room details	`WEBEX_MESSAGING_GET_ROOM_DETAILS`	`roomId`
Update room	`WEBEX_UPDATE_ROOM`	`roomId`, `title`
Delete message	`WEBEX_MESSAGING_DELETE_MESSAGE`	`messageId`
Get message details	`WEBEX_MESSAGING_GET_MESSAGE_DETAILS`	`messageId`
Create webhook	`WEBEX_WEBHOOKS_CREATE_WEBHOOK`	`name`, `targetUrl`, `resource`, `event`
List webhooks	`WEBEX_LIST_WEBHOOKS`	`max`, `ownedBy`
Get webhook	`WEBEX_WEBHOOKS_GET_WEBHOOK`	`webhookId`
Add team member	`WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP`	`teamId`, `personEmail`, `isModerator`
List memberships	`WEBEX_MESSAGING_LIST_MEMBERSHIPS`	`roomId`, `personEmail`, `max`
List people	`WEBEX_PEOPLE_LIST_PEOPLE`	email, displayName, ID filters
List teams	`WEBEX_LIST_TEAMS`	`max`

Webex Automation

作者

分类

安装