用途
该技能用于将 AI 智能体或自动化流程与 WhatsApp 集成,从而对 WhatsApp 数据进行操作和管理。根据资料描述,其核心目标是让用户或智能体能够与 WhatsApp 数据交互,管理聊天(Chats)、用户(Users)、群组(Groups)、联系人(Contacts)和状态(Statuses)。
主要能力
该技能提供了一系列预置动作(actions),涵盖消息发送与商业资料管理两大方向。
消息发送类动作包括:
- 发送文本消息(send-text-message)
- 发送图片消息(send-image-message)
- 发送视频消息(send-video-message)
- 发送音频消息(send-audio-message)
- 发送文档消息(send-document-message)
- 发送贴纸消息(send-sticker-message)
- 发送位置消息(send-location-message),包含坐标及可选名称/地址
- 发送联系人消息(send-contacts-message),可发送一张或多张联系人卡片(vCard)
- 发送交互式列表消息(send-interactive-list-message),包含最多 10 个可选项并按分组组织
- 发送交互式按钮消息(send-interactive-buttons-message),包含最多 3 个回复按钮
- 发送模板消息(send-template-message),即发送预先审核通过的模板消息
- 发送表情回应(send-reaction),针对特定消息发送表情
- 标记消息已读(mark-message-as-read)
商业资料类动作包括:
- 获取商业资料(get-business-profile),可检索 About 文本、地址、描述、邮箱和网站等信息
- 更新商业资料(update-business-profile)
此外,当预置动作不满足需求时,可通过 Membrane 代理(proxy)直接向 WhatsApp API 发送请求,支持 GET、POST、PUT、PATCH、DELETE 方法以及自定义请求头和请求体。
使用方式
首先安装 Membrane CLI:
npm install -g @membranehq/cli@latest
然后登录:
membrane login --tenant --clientName=<agentType>
该命令会打开浏览器进行认证,或在无交互环境(headless)下输出授权 URL,需用户在浏览器中打开并在登录完成后,用 membrane login complete <code> 完成登录。agentType 可选值包括 claude、openclaw、codex、warp、windsurf 等,用于调整工具以适配不同运行环境。
连接 WhatsApp:
membrane connection ensure "https://web.whatsapp.com" --json
用户在浏览器中完成认证后,输出中会包含连接 id。若连接状态为 BUILDING,可使用以下命令轮询直到就绪:
npx @membranehq/cli connection get <id> --wait --json
状态为 READY 表示连接可用;CLIENT_ACTION_REQUIRED 表示需要用户或代理执行操作(如认证或提供输入);CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错。
搜索动作:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
运行动作:
membrane action run <actionId> --connectionId=CONNECTION_ID --json
传入 JSON 参数:
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
通过代理发送请求:
membrane request CONNECTION_ID /path/to/endpoint
常用选项包括 -X, --method(HTTP 方法)、-H, --header(请求头,可重复)、-d, --data(请求体)、--json(发送 JSON 体并设置 Content-Type)、--rawData(原样发送)、--query(查询参数,可重复)、--pathParam(路径参数,可重复)。
任何命令均可添加 --json 以获得机器可读的 JSON 输出。
适用场景
资料中提到,WhatsApp 主要供个人进行日常沟通使用,同时也提供面向客户支持和营销的商业解决方案。因此该技能可能适用于需要通过 WhatsApp 发送多种类型消息或管理商业资料信息的集成场景。
限制
- 资料未提供具体的收费、价格或套餐信息。
- 资料未提供具体的速率限制、配额或消息发送限制说明。
- 资料未提供关于群组、状态(Statuses)等数据管理的具体动作或操作步骤的详细信息。
- 资料未提供支持的平台范围、部署环境要求等细节。
- 交互式列表消息最多 10 个可选项,交互式按钮消息最多 3 个回复按钮,模板消息需预先审核通过。