
关于
通过 Rube MCP(Composio)自动化 WhatsApp Business 任务:发送消息、管理模板、上传媒体和处理联系人。使用前先搜索工具获取当前 Schema。
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使用toolkitwhatsapp建立活跃的WhatsApp连接 - 始终先调用
RUBE_SEARCH_TOOLS获取当前工具schema - 需要WhatsApp Business API账户(非普通WhatsApp)
设置
获取Rube MCP:在你的客户端配置中添加 https://rube.app/mcp 作为MCP服务器。无需API密钥——只需添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS响应来验证Rube MCP可用 - 使用toolkit
whatsapp调用RUBE_MANAGE_CONNECTIONS - 如果连接不是ACTIVE状态,按照返回的认证链接完成WhatsApp Business设置
- 确认连接状态显示ACTIVE后再运行任何工作流
核心工作流
1. 发送文本消息
何时使用:用户想要向WhatsApp联系人发送文本消息
工具序列:
WHATSAPP_GET_PHONE_NUMBERS- 列出可用的商业电话号码 [前置]WHATSAPP_SEND_MESSAGE- 发送文本消息 [必需]
关键参数:
to:国际格式的收件人电话号码(如 '+14155551234')body:消息文本内容phone_number_id:发送方的商业电话号码ID
注意事项:
- 电话号码必须是带国家代码的国际E.164格式
- 24小时窗口外的消息需要已批准的模板
- 24小时窗口从客户最后一次给你发消息时开始
- 商家发起的对话需要先使用模板消息
2. 发送模板消息
何时使用:用户想要发送预批准的模板消息进行外呼通信
工具序列:
WHATSAPP_GET_MESSAGE_TEMPLATES- 列出可用模板 [前置]WHATSAPP_GET_TEMPLATE_STATUS- 检查模板审批状态 [可选]WHATSAPP_SEND_TEMPLATE_MESSAGE- 发送模板消息 [必需]
关键参数:
template_name:已批准的模板名称language_code:模板语言(如 'en_US')to:收件人电话号码components:模板变量值和参数
注意事项:
- 模板必须在使用前获得Meta批准
- 模板变量必须匹配预期的数量和格式
- 发送未批准或被拒绝的模板会返回错误
- 语言代码必须匹配模板的已批准翻译
3. 发送媒体消息
何时使用:用户想要发送图片、文档或其他媒体
工具序列:
WHATSAPP_UPLOAD_MEDIA- 上传媒体到WhatsApp服务器 [必需]WHATSAPP_SEND_MEDIA_BY_ID- 通过媒体ID发送 [必需]
关键参数:
file:要上传的文件路径或URLtype:媒体类型('image'、'document'、'audio'、'video')media_id:上传后返回的媒体IDcaption:可选的媒体说明文字
注意事项:
- 媒体有大小限制(图片5MB、视频16MB、文档100MB)
- 上传的媒体在30天后过期
- 支持的格式因类型而异(图片:JPEG/PNG,文档:PDF/DOC等)
4. 管理联系人
何时使用:用户想要查看或管理WhatsApp Business联系人
工具序列:
WHATSAPP_GET_CONTACTS- 获取联系人列表 [必需]
5. 获取消息状态
何时使用:用户想要检查已发送消息的送达状态
工具序列:
WHATSAPP_GET_MESSAGE_STATUS- 检查消息状态 [必需]
状态值:
sent:消息已发送到WhatsApp服务器delivered:消息已送达收件人设备read:收件人已阅读消息failed:消息发送失败
通用注意事项
- WhatsApp Business API有严格的消息策略——遵守24小时规则
- 速率限制因账户层级而异(标准/高级)
- 始终先使用
RUBE_SEARCH_TOOLS验证当前可用的工具和参数schema - 测试时使用WhatsApp Business测试号码避免影响真实用户
- 模板审批可能需要24-48小时
兼容工具
Claude CodeCursor
标签
后端开发
