whatsapp-automation

用途

本技能用于通过 Rube MCP 调用 Composio 的 WhatsApp 工具包，自动化 WhatsApp Business 的日常操作，例如发送消息、管理模板、上传媒体和处理联系人。

前提条件

• 已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
• 通过 RUBE_MANAGE_CONNECTIONS 建立了有效的 WhatsApp 连接，toolkit 为 whatsapp。
• 需要 WhatsApp Business API 账号（不是普通 WhatsApp）。
• 每次先调用 RUBE_SEARCH_TOOLS 以获取当前的工具 schema。

设置方式

1. 获取 Rube MCP：在客户端配置中把 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥，添加端点即可使用。
2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 使用 whatsapp。
4. 如果连接不是 ACTIVE，按返回的授权链接完成 WhatsApp Business 设置。
5. 在运行任何工作流前，确认连接状态为 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：用上传后的 media ID 发送（必需）。或 WHATSAPP_SEND_MEDIA：用公开 URL 发送（替代）。

关键参数：

• media_url：媒体公开 URL（用于 SEND_MEDIA）。
• media_id：上传返回的 ID（用于 SEND_MEDIA_BY_ID）。
• type：媒体类型（'image'、'document'、'audio'、'video'、'sticker'）。
• caption：可选的媒体说明文字。

注意：上传的 media ID 是临时的，会过期；媒体大小限制因类型而异（图片 5MB、视频 16MB、文档 100MB）；支持格式：图片（JPEG、PNG）、视频（MP4、3GPP）、文档（PDF 等）；SEND_MEDIA 需要可公开访问的 HTTPS URL。

4. 回复消息

适用场景：回复收到的 WhatsApp 消息。

工具顺序：

• WHATSAPP_SEND_REPLY：对特定消息发送回复（必需）。

关键参数：

• message_id：被回复消息的 ID。
• to：接收方电话号码。
• body：回复文本内容。

注意：message_id 必须来自 24 小时窗口内收到的消息；回复在对话中显示为引用消息；原消息必须仍存在（未被删除）才能显示引用。

5. 管理商业资料与模板

适用场景：查看或管理 WhatsApp Business 资料。

工具顺序：

• WHATSAPP_GET_BUSINESS_PROFILE：获取商业资料详情（可选）。
• WHATSAPP_GET_PHONE_NUMBERS：列出已注册电话号码（可选）。
• WHATSAPP_GET_PHONE_NUMBER：获取特定号码详情（可选）。
• WHATSAPP_CREATE_MESSAGE_TEMPLATE：创建新模板（可选）。
• WHATSAPP_GET_MESSAGE_TEMPLATES：列出所有模板（可选）。

关键参数：

• phone_number_id：商务电话号码 ID。
• template_name：新模板名称。
• category：模板类别（MARKETING、UTILITY、AUTHENTICATION）。
• language：模板语言代码。

注意：新模板需经 Meta 审核后才能使用；模板名称必须为小写并使用下划线（不能有空格）；类别影响定价与审批标准；模板对页眉、正文和按钮有特定格式要求。

6. 分享联系人

适用场景：通过 WhatsApp 发送联系人信息。

工具顺序：

• WHATSAPP_SEND_CONTACTS：发送联系人卡片（必需）。

关键参数：

• to：接收方电话号码。
• contacts：联系人对象数组，包含 name、phone、email 等信息。

注意：联系人对象须符合 WhatsApp Business API 联系人 schema；每个联系人至少需要 name 字段；联系人中的电话号码应包含国家代码。

常见模式

• 24 小时消息窗口：客户必须先给你发消息以开启对话窗口；在其最后一条消息后的 24 小时内可发送自由格式消息；超过 24 小时后只能发送已批准模板消息；模板消息可重新开启对话窗口。
• 电话号码解析：调用 WHATSAPP_GET_PHONE_NUMBERS；提取你商务号码的 phone_number_id；在所有发送操作中使用该 phone_number_id。
• 媒体上传流程：调用 WHATSAPP_UPLOAD_MEDIA 上传文件；从响应中提取 media_id；用 media_id 调用 WHATSAPP_SEND_MEDIA_BY_ID；或直接用公开 URL 调用 WHATSAPP_SEND_MEDIA。

已知限制与注意事项

• 电话号码格式：始终使用 E.164 格式：+[国家代码][号码]（如 '+14155551234'）；不要包含短横线、空格或括号；必须包含国家代码，缺失的本地号码会失败。
• 消息限制：24 小时窗口外的企业主动消息需要模板；模板消息按会话收费；对每个电话号码和每个账号有速率限制。
• 媒体处理：上传的媒体会过期，上传后应尽快使用；媒体 URL 必须为可公开访问的 HTTPS；贴纸有特定要求（WebP 格式，512x512 像素）。
• 模板管理：模板审核最长可能需要 24 小时；被拒模板需修正后重新提交；模板变量使用双花括号：{{1}}、{{2}} 等。

快速参考

任务	工具 Slug	关键参数
发送消息	WHATSAPP_SEND_MESSAGE	to, body
发送模板	WHATSAPP_SEND_TEMPLATE_MESSAGE	template_name, to, language_code
上传媒体	WHATSAPP_UPLOAD_MEDIA	（文件参数）
按 ID 发送媒体	WHATSAPP_SEND_MEDIA_BY_ID	media_id, to, type
按 URL 发送媒体	WHATSAPP_SEND_MEDIA	media_url, to, type
回复消息	WHATSAPP_SEND_REPLY	message_id, to, body
发送联系人	WHATSAPP_SEND_CONTACTS	to, contacts
获取媒体	WHATSAPP_GET_MEDIA	media_id
列出电话号码	WHATSAPP_GET_PHONE_NUMBERS	（无）
获取电话号码	WHATSAPP_GET_PHONE_NUMBER	phone_number_id
获取商业资料	WHATSAPP_GET_BUSINESS_PROFILE	phone_number_id
创建模板	WHATSAPP_CREATE_MESSAGE_TEMPLATE	template_name, category, language
列出模板	WHATSAPP_GET_MESSAGE_TEMPLATES	（无）
检查模板状态	WHATSAPP_GET_TEMPLATE_STATUS	template_id

适用场景

适用于需要通过 MCP 自动化 WhatsApp Business 消息发送、模板管理、媒体上传、消息回复、联系人分享以及商业资料查询等任务的场景。

暂未提供的信息

资料未提供具体定价、价格细节、不同地区的可用性、性能数据或与其他平台的对比信息。