必须通过“扣子→webhook→hookmyapp→whatsapp business api”链路实现对接，先完成meta官方绿标认证，再在hookmyapp配置webhook、消息转换与api调用，最后将长期有效访问令牌集成至http请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让扣子（Doubao）上的AI Agent直接对接WhatsApp Business，为海外客户自动回复咨询、推送订单状态、处理售后问题，必须绕过扣子官方不支持WhatsApp直连的限制，采用“扣子→Webhook→第三方中转平台→WhatsApp Business API”的链路。这要求你手动配置中间服务，不能仅靠扣子界面点选完成。
准备WhatsApp Business账户与Meta认证
登录 Meta Business Suite，进入「WhatsApp Manager」→点击「Add WhatsApp account」→选择「Business Account」→填写企业名称、国家/地区、营业执照扫描件（需清晰显示公司全称与注册号）→提交后等待人工审核。这一步不可跳过，【未通过Meta官方绿标认证的账号，无法调用WhatsApp Business API发送消息，所有后续配置将无效】。
审核通常耗时1–3个工作日，期间不要重复提交。若被拒，Meta会邮件说明原因，常见问题包括营业执照模糊、公司名称与Facebook主页不一致、地址不在支持国家列表内。
在HookMyApp平台创建WhatsApp集成项目
访问 hookmyapp.com → 登录或注册账号 → 点击「Create New Integration」→ 选择「WhatsApp Business API」模板 → 填写项目名称（如“Doubao-WhatsApp-Customer-Support”）→ 点击「Continue」。
系统自动生成唯一 Webhook URL 和验证 Token，这两项将用于下一步对接扣子。请立即复制保存，页面刷新后无法再次查看原始 Token。
进入「Settings」→ 打开「Webhook Events」→ 勾选「messages」、「message_status」、「errors」三项。其他事件（如「opt_in」）暂不启用，避免扣子未适配导致解析失败。
配置扣子（Doubao）接收并转发消息
打开扣子官网 → 进入「Agent Studio」→ 选择目标AI Agent → 点击「Settings」→ 找到「Webhook」模块 → 开启「Enable Webhook」开关 → 在「Endpoint URL」栏粘贴上一步获取的 HookMyApp Webhook URL → 在「Secret Token」栏填入对应 Token → 保存。
此时扣子已能将用户发来的消息（含文本、按钮点击、图片描述）以 JSON 格式 POST 到 HookMyApp。但注意：扣子默认只转发用户主动发送的消息，不会自动推送系统事件（如消息送达回执），这部分需由 HookMyApp 向扣子反向调用实现。
在HookMyApp中设置消息路由与格式转换
回到 HookMyApp 项目面板 → 进入「Transformers」→ 新建一个「Incoming Transformer」→ 选择「From Doubao」→ 粘贴以下 JSON 路径映射规则：
修复 WhatsApp Web 的 428 错误及代理配置问题，适用于连接断开（状态428）、需要配置代理或在新机器部署 OpenClaw 后出现的 WhatsApp 连接故障。
```json
{"from": "event.message.from", "to": "wa_phone", "type": "string"}
{"from": "event.message.text.body", "to": "wa_text", "type": "string"}
{"from": "event.message.id", "to": "wa_message_id", "type": "string"}```
再新建一个「Outgoing Transformer」→ 选择「To Doubao」→ 设置响应字段映射，关键字段必须为：【"response": {"text": "your reply content"}】，否则扣子无法识别并展示给用户。
最后，在「Routes」中将 Incoming Transformer 绑定到 WhatsApp 接收端，Outgoing Transformer 绑定到扣子 Webhook 回调端。测试时发送一条“Hello”，观察 HookMyApp 日志是否显示「200 OK」及完整消息流转路径。
部署WhatsApp消息发送逻辑
在 HookMyApp 的「Actions」中新建一个 Action → 类型选「HTTP Request」→ Method 设为 POST → URL 填写 WhatsApp Business API 的发送端点（格式为 https://graph.facebook.com/v19.0/{PHONE_NUMBER_ID}/messages）→ Headers 添加：
Authorization: Bearer {YOUR_WABA_ACCESS_TOKEN}
Content-Type: application/json
Body 使用如下模板（注意替换占位符）：
```json
{"messaging_product": "whatsapp", "to": "{{wa_phone}}", "type": "text", "text": {"body": "{{wa_text}}"}}```
其中 {YOUR_WABA_ACCESS_TOKEN} 必须是从 Meta Developer Portal 中「System Users」生成的长期有效令牌，【切勿使用短期调试令牌，72小时后失效会导致全部消息中断】。
将该 Action 关联到「Outgoing Transformer」的下游，完成从扣子指令→HookMyApp解析→WhatsApp API调用的闭环。
