SuperAPI AI 工具集

whatsapp

办公与效率

查看项目

更新于 10-15 09:11

技能介绍

用途

该技能用于将 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 个回复按钮,模板消息需预先审核通过。