Webex Automation

Webex Automation

技能概述

Webex Automation 是一个通过自然语言命令自动化 Cisco Webex 协作流程的智能工具，支持消息发送、房间管理、团队协作、webhook 配置和人员查询等核心功能。

适用场景

1. DevOps 与部署自动化

在 CI/CD 流程中自动发送部署通知到 Webex 群组，让团队实时了解项目状态。支持 markdown 格式、文件链接和 Adaptive Card，一键播报构建成功或失败信息。

2. 企业团队协作管理

企业管理员可以通过自然语言命令批量添加团队成员、分配权限、创建房间和设置 webhook，无需手动操作 Webex 界面，大幅提升协作效率。

3. 事件驱动实时通知

配置 Webex webhook 监控消息、房间、成员、会议等事件变化，自动将关键信息推送到指定 URL，实现实时监控和自动化响应，适合运维监控和系统告警场景。

核心功能

消息发送与格式化

支持向 Webex 房间或个人发送纯文本、markdown、文件附件和 Adaptive Card，消息大小限制为 7439 字节，每条消息支持一个文件或一个卡片。可回复指定消息实现线程化对话，适合构建自动化通知流程。

房间与团队管理

列出并筛选所有加入的房间，按类型（1:1 或群组）、团队、活跃度排序，查看房间详情包括锁定状态和创建者信息。管理团队成员资格，可添加成员并授予管理员权限，简化团队维护工作。

Webhook 事件自动化

创建 webhook 监听 Webex 资源变化（消息、房间、成员、会议等），支持 created、updated、deleted 等多种事件类型，可设置过滤条件缩小范围，提供 HMAC 签名验证，确保通知安全可靠。目标 URL 必须返回 HTTP 2xx，否则 100 次失败将自动禁用。

常见问题

Webex Automation 是什么？能做什么？

Webex Automation 是一个通过自然语言命令控制 Cisco Webex 的自动化工具。它能发送消息到房间或个人、管理房间和团队成员、配置 webhook 实现事件驱动通知、查询人员信息等，适合 DevOps 部署通知、企业协作管理和实时监控告警场景。

如何用自然语言控制 Webex 发送消息？

只需描述目标房间或人员邮箱，加上消息内容和格式，例如"向房间 Y2lz... 发送 markdown 消息说 部署完成 并附带发布说明链接"。工具会自动调用 WEBEX_MESSAGING_CREATE_MESSAGE API，支持纯文本、markdown、文件链接和 Adaptive Card。

Webex webhook 如何配置和使用？

通过 WEBEX_WEBHOOKS_CREATE_WEBHOOK 工具创建 webhook，指定名称、目标 URL、监听资源（如 messages、rooms）、事件类型（created、updated 等）和可选过滤条件。目标 URL 必须可靠响应 HTTP 2xx，否则 5 分钟内 100 次失败会自动禁用 webhook。可用 WEBEX_LIST_WEBHOOKS 查看所有已注册的 webhook。

Webex Automation 支持哪些自动化操作？

核心操作包括：发送消息（房间/个人）、列出房间、获取房间详情、更新房间、删除消息、创建 webhook、列出 webhook、添加团队成员、列出成员、查询人员、列出团队等，覆盖 Webex 协作的主要场景。

Webex 消息大小限制是什么？

纯文本和 markdown 消息都有 7439 字节的长度限制。文件 attachments 每条消息只支持一个文件，Adaptive Card 同样每条消息只支持一个卡片。发送大文件时建议使用公开 URL 链接而非直接上传。

如何通过 Webex Automation 管理团队成员？

使用 WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP 工具，提供团队 ID（teamId）和人员邮箱（personEmail）或人员 ID（personId），可选择性授予管理员权限（isModerator）。先用 WEBEX_LIST_TEAMS 发现可用团队，再用 WEBEX_MESSAGING_LIST_MEMBERSHIPS 审核现有成员。

Webex webhook 失败会被自动禁用吗？

是的，如果目标 URL 在 5 分钟内连续失败 100 次，webhook 会被自动禁用。建议确保 webhook 接收端稳定可靠并正确返回 HTTP 2xx 状态码，避免因网络或服务问题导致自动化中断。

Webex Automation 需要 MCP 服务器吗？

是的，需要添加 Rube MCP 服务器（https://rube.app/mcp）到环境，然后通过 Composio 的 OAuth 流程连接 Webex 账号，才能开始使用自然语言命令进行 Webex 自动化操作。