借助 Coexistence 在 WhatsApp 上运行 Typebot 流程

Typebot 的哪些字段取自已连接的号码？

Typebot 的 WhatsApp 向导位于机器人的 Share 标签页，需要四项内容：应用密钥、System User Token、WhatsApp Business Account ID 和 Phone number ID。

其中三项直接来自该连接。控制台会显示该号码的 WABA id、phone number id 和访问令牌；如果由助手代您获取，get_api_credentials 工具会返回相同的值。把它们粘贴到对应字段即可。

应用密钥需要留空。Typebot 对入站流量只用它做一件事：校验 Meta 在每次投递中附加的 X-Hub-Signature-256 请求头。对于通过 Tech Provider 连接的号码，Meta 使用提供方的应用密钥签名，而该密钥从不共享，因此您在此填写任何值，都会让 Typebot 拒绝每一条真实消息。字段留空时，Typebot 会跳过该校验并接受投递。

Typebot 的 Callback URL 和验证令牌填在哪里？

填入该号码的 Webhook 目的地，而不是 Meta 应用的控制台。

Typebot 的向导会让您把 Callback URL 和 Verify Token 粘贴到您自己 Meta 应用的 WhatsApp 设置中。通过 EasyCoexistence 使用 Coexistence 时，不涉及您自己的应用：Meta 会把该号码的事件路由到连接上设置的目的地。因此请从 Typebot 的最后一步复制这两个值，并将它们设为目的地，可在控制台中设置，也可使用 set_webhook_destination。

随后 Meta 会向 Typebot 发送验证用的 GET 请求，Typebot 返回 challenge，此后发给该号码的每条消息都会到达机器人。Typebot 的验证令牌只能使用一次：验证成功的那一刻，它就会从 Typebot 的数据库中删除。之后如需再次设置目的地，请先重新运行向导，生成新的令牌。

机器人如何处理 24 小时窗口？

Typebot 回复的是主动给它发消息的人，这使几乎所有消息都落在客户服务窗口之内。客户每次发来消息，Meta 都会开启一个 24 小时窗口，窗口内可以不用模板发送任何服务类消息。因此只负责应答的机器人属于最简单的情形。

问题出在会等待的流程。Wait 块，或客户沉默超过一天后恢复的会话，会尝试在窗口之外发送自由文本消息，Meta 会以错误 131047 拒绝。Typebot 的会话过期超时默认为 4 小时，最多可设为 48 小时，它决定的是回头的客户何时开始新的对话，而不是 Meta 是否接受这条消息。

由于使用的是 Coexistence，团队仍能在 WhatsApp Business 应用中看到每一段对话，只要机器人不该回答，随时可以在手机上接手。

常见错误

• 把 Meta 应用密钥粘贴到 Typebot。消息使用 Tech Provider 的密钥签名，Typebot 会因签名无效而拒绝每一条消息。
• 重复使用旧的 Typebot 验证令牌。它在一次验证成功后即被删除，再次设置目的地需要从向导获取新的令牌。
• 分享 Callback URL。签名校验关闭后，知道该 URL 就能发起请求，因此请像对待密码一样保管它。

常见问题

继续阅读