Anyy 使用 Meta 官方 Business Cloud API 接入 WhatsApp。用户私信通过签名 Webhook 进入 Gateway，回复则由已配置的企业号码发送。
准备材料
- 已启用 WhatsApp 产品的 Meta App；
- App ID、WhatsApp Business Account ID、Phone Number ID；
- 具备 Cloud API 权限的 Access Token；
- 自己生成的 Webhook Verify Token；
- Meta App Secret；
- 能转发到 Anyy Gateway 的公网 HTTPS 地址。
Meta 控制台的最新操作请以 Cloud API 官方文档 为准。
在 Dashboard 中连接
- 打开 Dashboard → Channel → Add account。
- 选择 WhatsApp 和 Business Cloud API webhook。
- 填入 App ID、Business Account ID、Phone Number ID。
- 输入 Access Token、Webhook Verify Token、App Secret。
- 私信策略建议先保留默认的
pairing。 - 保存后，按页面提示完成 Meta 的事件订阅和权限配置。
Anyy 的回调路径为：
/channels/whatsapp/ACCOUNT_ID/webhook
默认 ACCOUNT_ID 是 personal。将该路径通过 HTTPS 暴露给 Meta，并确保双方使用同一个 Verify Token。
私信访问控制
WhatsApp 支持 pairing、open、allowlist、disabled 四种私信策略。当前 Anyy Profile 不提供 WhatsApp 群聊能力。
核对手机身份后再批准：
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
平台限制
Meta 对面向欧洲经济区和巴西收件人的 AI Provider 有资格限制。Anyy 的自由文本回复还必须来自用户主动发起的消息上下文，并处于平台允许的响应窗口内。
WhatsApp 不是任意外呼通道
Anyy 不会猜测收件人，也不会绕过 Meta 的会话规则。应从已经授权的入站对话开始，并在定时发送或重试前确认平台政策。
验证连接
anyy channel doctor whatsapp
anyy channel reload
向企业号码发送一条私信，完成配对，再单独验证回复。
故障排查
| 现象 | 检查项 |
|---|---|
| Webhook Challenge 失败 | 公网 HTTPS 路由和 Verify Token |
| 事件返回 401 | App Secret 和 X-Hub-Signature-256 是否完整转发 |
| 能收不能发 | Access Token、Phone Number ID、权限和资格限制 |
| 发信人被忽略 | 私信策略、配对或 allowlist |
| 过一段时间后回复被拒绝 | 用户发起的响应窗口和 Meta 当前规则 |