登录开始免费试用
Meta Tech Provider

将 Coexistence 号码用作 Chatwoot WhatsApp Cloud 收件箱

Chatwoot 的 WhatsApp Cloud 收件箱需要三个值：WhatsApp Business Account ID、号码 ID 和访问令牌。Coexistence 号码三者都能提供。用它们创建收件箱，再把该号码的 Webhook 目标地址设为 Chatwoot 的 Webhook URL，并填入相同的验证令牌，团队就可以同时在 Chatwoot 和手机上回复消息。

3 values

WABA ID、号码 ID 和访问令牌：这是 Chatwoot 手动设置 WhatsApp Cloud 时要求填写的内容。

smb_message_echoes

Chatwoot 会处理这一 Coexistence 事件，因此从 WhatsApp Business 应用发出的回复会出现在对话中。

Per number

Meta 允许每个商业号码使用自己的 Webhook 回调 URL，以覆盖应用的默认设置。

如何将 Coexistence 号码连接到 Chatwoot？

分两步，按以下顺序进行。

先在 Chatwoot 中添加收件箱，选择 WhatsApp，再选择 WhatsApp Cloud 提供商并使用手动设置。填写号码、号码 ID、WhatsApp Business Account ID 和访问令牌。这些信息都可以在 EasyCoexistence 控制台的该连接页面中查看，助手也可以通过 get_api_credentials 获取。随后 Chatwoot 会为这个收件箱显示一个 Webhook URL 和一个 Webhook 验证令牌。

然后在 EasyCoexistence 中，把该号码的 Webhook 目标地址设为这个 URL，并填入相同的验证令牌。Meta 会向 Chatwoot 发送验证请求，Chatwoot 作出响应，此后发给该号码的每条消息都会进入收件箱。中间没有任何环节，因此也没有需要保持运行的工作流。

1Copy credentialsWABA id, phone number id, token
2Create Chatwoot inboxWhatsApp Cloud, manual setup
3Copy webhook + tokenShown by Chatwoot
4Set destinationSame URL and verify token

从手机发出的回复会显示在 Chatwoot 中吗？

会。在 Coexistence 号码上，于 WhatsApp Business 应用中输入的回复，会由 Meta 以 smb_message_echoes 事件的形式上报。Chatwoot 的 Webhook 任务能识别这个字段，并把该消息记为对应对话中的外发消息。其源代码直接描述了这种情形：企业同时在 Chatwoot 和应用中回复，消息同步到 Chatwoot。

这让分工在实际中行得通。店主可以继续在手机上回复老客户，团队则在电脑前处理共享收件箱，双方都能看到对方发出的内容，无需转发截图。

从 Chatwoot 发出的消息通过同一号码的 Cloud API 发送，所以手机上也会显示。

为什么 Chatwoot 收件箱不应填写应用密钥？

因为这些投递是用您没有的密钥签名的。Meta 用拥有该订阅的应用的应用密钥为每个 Webhook 签名，这个应用就是 EasyCoexistence 应用，而该密钥从不对外共享。

按 Chatwoot 当前的源代码，对于手动配置的 WhatsApp Cloud 渠道，只有在已存储应用密钥，或该渠道是通过 Chatwoot 自己的 Embedded Signup 创建时，才会校验 X-Hub-Signature-256 标头。没有应用密钥的手动收件箱会接受这些投递；只要填了任何应用密钥，就会把每一条都当作未授权而拒绝。

这里起保护作用的是验证令牌。请选一个足够长的随机值，因为 Chatwoot 正是靠它来区分 Meta 的验证请求和其他人的请求。

Chatwoot 在这个号码上做不到什么？

无法同时在第二个位置接收 Webhook。Meta 只会把一个号码的 Webhook 发往一个目标地址，所以 Chatwoot 占用它时，n8n 工作流不会收到相同的事件。如果两者都需要，可以把目标地址指向您自己搭建的小型中继，由它把每次投递同时转发给 Chatwoot 和工作流。

Coexistence 的限制照常适用：API 每秒最多发送 20 条消息，自由文本只能在客户最后一条消息后的 24 小时内发出，超出之后需要使用消息模板。

WhatsApp Business 应用仍需至少每 14 天打开一次，EasyCoexistence 会为您监控这一点。

常见错误

  • 在 Chatwoot 收件箱中填写了应用密钥。投递是用 EasyCoexistence 应用的密钥签名的，因此 Chatwoot 会把每一条都当作未授权而拒绝。
  • 在 EasyCoexistence 中使用了与 Chatwoot 显示的不同的验证令牌。Meta 的验证会失败，收件箱永远收不到消息。
  • 选择了 Chatwoot 的 Embedded Signup，而不是手动流程。这会通过 Chatwoot 自己的 Meta 应用连接号码，属于另一个独立的连接。
使用 EasyCoexistence 完成这些操作

在 easycoexistence.com 连接号码，把凭据复制到 Chatwoot 的 WhatsApp Cloud 收件箱，再把 Webhook 目标地址设为 Chatwoot。每个号码每月 US$ 9 起，随号码增加降至 US$ 1，前 3 天免费。

常见问题

自托管的 Chatwoot 也适用吗？

适用。Webhook URL 使用您自己的 Chatwoot 域名，而不是 app.chatwoot.com，其余设置完全相同。

使用 Chatwoot 需要我自己的 Meta 应用吗？

不需要。号码通过 EasyCoexistence 连接，由它提供凭据并转发 Webhook。Chatwoot 的指南之所以介绍创建 Meta 应用，只是因为它假定您没有应用。

可以把多个号码接入 Chatwoot 吗？

可以。为每个号码创建一个 WhatsApp Cloud 收件箱，并把每个号码的 Webhook 目标地址设为对应收件箱的 URL 和验证令牌。

EasyCoexistence 能看到这些对话吗？

不能。Meta 会把 Webhook 直接发送给 Chatwoot，EasyCoexistence 从不存储对话内容。

继续阅读

Verifying a WhatsApp webhook endpointMeta calls your endpoint with a GET challenge before delivering anything. What it sends, what to return, and why a wrong answer fails silently.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.Connect WhatsApp to Activepieces on a Coexistence numberUse Activepieces' WhatsApp Business piece on a Coexistence number: paste the token and WABA id, point the webhook at the trigger, and leave the app secret empty.Receive WhatsApp webhooks in a Supabase Edge FunctionMake a Supabase Edge Function the webhook destination of a Coexistence number: answer Meta's verification, store messages in Postgres, reply through the Cloud API.MCP or a webhook: which one you actually needMCP acts when asked. A webhook reacts when something happens. Why an assistant cannot answer customers on its own, and why most systems need both.

准备开始了吗？

几分钟即可设置 WhatsApp Coexistence，而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间

Chatwoot WhatsApp Cloud 收件箱对接 Coexistence