先说明一个核心结论：如果你想让扣子（Doubao）上的AI Agent直接对接WhatsApp Business，帮海外客户自动回复咨询、推送订单状态、处理售后问题，目前没法通过扣子界面点选完成。扣子最新版还搞不定WhatsApp直连，所以必须老老实实地走“扣子→Webhook→第三方中转平台→WhatsApp Business API”这条链路。从流程上看，核心要点是先让Meta完成最新绿标认证，再在中间平台配置好Webhook、消息转换与API调用，最后把长期有效的访问令牌集成到HTTP请求中。这部分配置完全需要手动完成。
准备工作：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」开关。把刚才从HookMyApp拿到的Webhook URL粘贴到「Endpoint URL」栏，Token填到「Secret Token」栏，然后保存。
这么一配置，扣子就能把用户发来的消息——文本、按钮点击、图片描述这些——以JSON格式推送给你指定的HookMyApp地址。不过有个细节要注意：扣子默认只转发用户主动发的消息，系统事件比如消息送达回执不会自动推送。这部分如果要实现，得靠HookMyApp反向调用扣子来搞定。
在HookMyApp配置消息路由与格式转换
回到HookMyApp的项目面板，进入「Transformers」，新建一个「Incoming Transformer」，来源选「From Doubao」。然后把下面的JSON路径映射规则贴进去：
```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”的状态码，以及完整的消息流转路径。
消息路由验证要点
测试消息走通后，建议检查一下日志中是否有异常状态码，如果出现400或500错误，多半是Token或者JSON映射规则出了问题。确保每个环节的返回码都是200，才算配置到位。
部署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调用的完整闭环就走通了。