---

name: whatsapp-automation description: "通过Rube MCP（Composio）自动化WhatsApp Business任务：发送消息、管理模板、上传媒体和处理联系人。始终先搜索工具获取当前schema。" risk: unknown source: community date_added: "2026-02-27"

通过Rube MCP实现WhatsApp Business自动化

通过Composio的WhatsApp工具包经由Rube MCP自动化WhatsApp Business操作。

前置条件

• Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用toolkit whatsapp 建立活跃的WhatsApp连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具schema
• 需要WhatsApp Business API账户（非普通WhatsApp）

设置

获取Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为MCP服务器。无需API密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应来验证Rube MCP可用
2. 使用toolkit whatsapp 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接完成WhatsApp Business设置
4. 确认连接状态显示ACTIVE后再运行任何工作流

核心工作流

1. 发送文本消息

何时使用：用户想要向WhatsApp联系人发送文本消息

工具序列：

1. WHATSAPP_GET_PHONE_NUMBERS - 列出可用的商业电话号码 [前置]
2. WHATSAPP_SEND_MESSAGE - 发送文本消息 [必需]

关键参数：

• to：国际格式的收件人电话号码（如 '+14155551234'）
• body：消息文本内容
• phone_number_id：发送方的商业电话号码ID

注意事项：

• 电话号码必须是带国家代码的国际E.164格式
• 24小时窗口外的消息需要已批准的模板
• 24小时窗口从客户最后一次给你发消息时开始
• 商家发起的对话需要先使用模板消息

2. 发送模板消息

何时使用：用户想要发送预批准的模板消息进行外呼通信

工具序列：

1. WHATSAPP_GET_MESSAGE_TEMPLATES - 列出可用模板 [前置]
2. WHATSAPP_GET_TEMPLATE_STATUS - 检查模板审批状态 [可选]
3. WHATSAPP_SEND_TEMPLATE_MESSAGE - 发送模板消息 [必需]

关键参数：

• template_name：已批准的模板名称
• language_code：模板语言（如 'en_US'）
• to：收件人电话号码
• components：模板变量值和参数

注意事项：

• 模板必须在使用前获得Meta批准
• 模板变量必须匹配预期的数量和格式
• 发送未批准或被拒绝的模板会返回错误
• 语言代码必须匹配模板的已批准翻译

3. 发送媒体消息

何时使用：用户想要发送图片、文档或其他媒体

工具序列：

1. WHATSAPP_UPLOAD_MEDIA - 上传媒体到WhatsApp服务器 [必需]
2. WHATSAPP_SEND_MEDIA_BY_ID - 通过媒体ID发送 [必需]

关键参数：

• file：要上传的文件路径或URL
• type：媒体类型（'image'、'document'、'audio'、'video'）
• media_id：上传后返回的媒体ID
• caption：可选的媒体说明文字

注意事项：

• 媒体有大小限制（图片5MB、视频16MB、文档100MB）
• 上传的媒体在30天后过期
• 支持的格式因类型而异（图片：JPEG/PNG，文档：PDF/DOC等）

4. 管理联系人

何时使用：用户想要查看或管理WhatsApp Business联系人

工具序列：

1. WHATSAPP_GET_CONTACTS - 获取联系人列表 [必需]

5. 获取消息状态

何时使用：用户想要检查已发送消息的送达状态

工具序列：

1. WHATSAPP_GET_MESSAGE_STATUS - 检查消息状态 [必需]

状态值：

• sent：消息已发送到WhatsApp服务器
• delivered：消息已送达收件人设备
• read：收件人已阅读消息
• failed：消息发送失败

通用注意事项

• WhatsApp Business API有严格的消息策略——遵守24小时规则
• 速率限制因账户层级而异（标准/高级）
• 始终先使用 RUBE_SEARCH_TOOLS 验证当前可用的工具和参数schema
• 测试时使用WhatsApp Business测试号码避免影响真实用户
• 模板审批可能需要24-48小时