lunartech-x/Webex Automation

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

1. Add the Rube MCP server to your environment: https://rube.app/mcp
2. Connect your Webex account when prompted (OAuth flow via Composio)
3. 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 [email protected] 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 [email protected]"

---

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 |

---

Powered by Composio