name: Webex自动化 description: “通过自然语言命令自动化Cisco Webex的消息发送、房间管理、团队管理、webhooks配置和人员管理” requires: mcp: - rube
Webex自动化
自动化Cisco Webex协作工作流程——发送消息、管理房间和团队、配置webhooks以及查找人员——全部通过自然语言命令完成。
工具包文档: composio.dev/toolkits/webex
设置
- 将Rube MCP服务器添加到您的环境：
https://rube.app/mcp - 在提示时连接您的Webex账户（通过Composio的OAuth流程）
- 开始为Webex自动化发布自然语言命令
核心工作流程
1. 向房间或人员发送消息
向任何Webex房间或直接向人员发送纯文本、markdown、文件附件或自适应卡片。
工具: WEBEX_MESSAGING_CREATE_MESSAGE
关键参数:
roomId—— 目标房间ID（使用WEBEX_MESSAGING_LIST_ROOMS查找）toPersonEmail—— 发送私人一对一消息（与roomId互斥）text—— 纯文本内容（最大7439字节）markdown—— markdown格式内容（优先于text）files—— 文件附件的公共URL列表（每条消息一个文件）attachments—— 自适应卡片JSON（每条消息一个卡片）parentId—— 作为线程回复特定消息
示例提示:
“向房间Y2lz…发送一个markdown消息，说部署已完成并附带发布说明的链接”
2. 列出和发现房间
浏览您所属的所有房间，按类型、团队筛选或按活动排序。
工具: WEBEX_MESSAGING_LIST_ROOMS
关键参数:
type—— 按direct（一对一）或group筛选teamId—— 限制到特定团队中的房间sortBy—— 按id、lastactivity或created排序max—— 限制结果数（1-1000，默认100）
后续使用WEBEX_MESSAGING_GET_ROOM_DETAILS获取特定房间的完整元数据，包括标题、类型、锁定状态、创建者和时间戳。
示例提示:
“列出我在Webex中最近活跃的10个群组房间”
3. 管理用于事件驱动自动化的Webhooks
创建webhooks以在Webex资源更改时接收实时HTTP POST通知。
工具: WEBEX_WEBHOOKS_CREATE_WEBHOOK
关键参数:
name—— 人可读的webhook名称（必需）targetUrl—— 接收POST通知的URL（必需）resource—— 监控什么：messages、rooms、memberships、meetings、recordings、meetingParticipants、telephony_calls等（必需）event—— 触发类型：created、updated、deleted、started、ended、joined、left（必需）filter—— 范围通知（例如，roomId=<id>或hostEmail=<email>）secret—— 用于有效负载签名验证的可选HMAC密钥ownedBy——creator用于个人或org用于组织范围的webhooks
支持工具:
WEBEX_LIST_WEBHOOKS—— 列出所有注册的webhooks，带有可选的max和ownedBy筛选器WEBEX_WEBHOOKS_GET_WEBHOOK—— 通过webhookId检查特定webhook
示例提示:
“创建一个名为’新消息’的webhook，每当在房间Y2lz…中创建消息时，POST到https://my-app.com/hook”
4. 管理团队成员关系
将人员添加到Webex团队，并可选择授予管理员权限。
工具: WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP
关键参数:
teamId—— 要添加人员的团队（必需）personEmail—— 要添加人员的电子邮件personId—— Webex人员ID（替代电子邮件）isModerator—— 设置为true获取管理员访问权限（默认false）
首先使用WEBEX_LIST_TEAMS来发现可用团队。
示例提示:
“将alice@example.com添加为团队Y2lz…的管理员”
5. 审计房间成员关系
检查谁在房间中，验证特定人员的成员关系，或跨团队列出成员关系。
工具: WEBEX_MESSAGING_LIST_MEMBERSHIPS
关键参数:
roomId—— 列出特定房间的所有成员personEmail—— 检查人员是否为成员（需要roomId）personId—— 通过Webex人员ID检查（需要roomId）teamId—— 按团队关联筛选max—— 限制结果数
示例提示:
“列出房间Y2lz…的所有成员，并告诉我谁是谁的管理员”
6. 搜索和查找人员
通过电子邮件、显示名称或ID在您的Webex组织中查找人员。
工具: WEBEX_PEOPLE_LIST_PEOPLE
用于在发送直接消息或添加团队成员之前将名称解析为人员ID。
示例提示:
“查找bob@company.com的Webex人员ID”
已知陷阱
| 陷阱 | 细节 |
|---|---|
| Webhook自动禁用 | 目标URL必须响应HTTP 2xx；5分钟内100次失败将自动禁用webhook |
| 消息大小限制 | text和markdown都有最大7439字节限制 |
| 每条消息一个文件 | files数组接受列表但每条消息实际上仅支持一个附件 |
| 每条消息一个卡片 | 每条消息仅支持一个自适应卡片附件 |
| 互斥目标 | 发送消息时，roomId和toPersonEmail/toPersonId不能同时使用 |
| 房间更新需要标题 | WEBEX_UPDATE_ROOM总是需要title参数，即使仅更改锁定状态或团队 |
| orgPublicSpaces冲突 | 列出房间时，不能将orgPublicSpaces与teamId、type或sortBy结合使用 |
| Webhook读取范围 | 创建webhook需要对监控资源类型的read范围 |
| 成员关系筛选需要roomId | 列出成员关系时，personEmail和personId筛选器需要roomId，除非您是合规官 |
快速参考
| 操作 | 工具标签 | 关键参数 |
|---|---|---|
| 发送消息 | WEBEX_MESSAGING_CREATE_MESSAGE |
roomId、text/markdown、toPersonEmail |
| 列出房间 | WEBEX_MESSAGING_LIST_ROOMS |
type、sortBy、max |
| 获取房间详情 | WEBEX_MESSAGING_GET_ROOM_DETAILS |
roomId |
| 更新房间 | WEBEX_UPDATE_ROOM |
roomId、title |
| 删除消息 | WEBEX_MESSAGING_DELETE_MESSAGE |
messageId |
| 获取消息详情 | WEBEX_MESSAGING_GET_MESSAGE_DETAILS |
messageId |
| 创建webhook | WEBEX_WEBHOOKS_CREATE_WEBHOOK |
name、targetUrl、resource、event |
| 列出webhooks | WEBEX_LIST_WEBHOOKS |
max、ownedBy |
| 获取webhook | WEBEX_WEBHOOKS_GET_WEBHOOK |
webhookId |
| 添加团队成员 | WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP |
teamId、personEmail、isModerator |
| 列出成员关系 | WEBEX_MESSAGING_LIST_MEMBERSHIPS |
roomId、personEmail、max |
| 列出人员 | WEBEX_PEOPLE_LIST_PEOPLE |
电子邮件、显示名称、ID筛选器 |
| 列出团队 | WEBEX_LIST_TEAMS |
max |
由Composio提供支持