通过 companion 桥接程序采集 WhatsApp

使用您自行托管的 companion 桥接程序，将销售代表 WhatsApp Business 上的每一条对话直接采集进“对话”时间线。此功能默认关闭且为可选项，需要接受服务条款提示。

该连接器通过您组织自行托管的 companion 桥接程序，将销售代表在 WhatsApp Business 上的消息采集进“对话”时间线。这些消息会和您其他的对话一同存放，因此 AI 摘要、洞察和跟进监控等功能都能直接在其之上运行。

开始前：服务条款提示

工作原理

• 您在自己的环境中运行一个 companion 桥接程序（一个开源的 WhatsApp 网页版服务）。
• 该 companion 通过二维码与 WhatsApp Business 配对，并监听收发的消息。
• 每条消息发生时，companion 会向您组织的接入 URL 发送一个已签名的 POST 请求。
• 消息会被存储，并根据电话号码关联到对应的联系人或线索（号码未知时会新建一个线索），并显示在“对话”时间线中。

如何连接

1. 前往“设置”、“集成”，打开“WhatsApp：通过 companion 采集”卡片。
2. 设置一个强配对密钥，并勾选同意选项（我理解服务条款的相关风险）。点击保存。
3. 复制显示的接入 URL，并使用该 URL 和相同的配对密钥配置 companion 程序。
4. 返回卡片，点击“启用”。若未勾选并保存同意选项，系统将不会接受采集请求。

只要连接器处于关闭状态，或同意选项未保存，接入 URL 就会拒绝所有推送请求。这样可以确保您在接受提示之前不会采集任何内容。

POST 格式（companion 契约）

companion 发送单条消息或一批消息，并使用配对密钥（HMAC-SHA256）对请求体进行签名，放在 X-Sellio-Signature 请求头中，格式为 sha256=<hex>。

POST /api/inbound/whatsapp-capture/YOUR_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 of the body with the secret>
Content-Type: application/json

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "from": "15551230000",
      "to": "15559990000",
      "direction": "in",
      "body": "message text",
      "timestamp": 1700000000,
      "name": "Contact name"
    }
  ]
}

messageId 用于确保同一条消息即使被重发，也不会产生重复记录。direction 为 “in”（接收）或 “out”（销售代表发出）。timestamp 接受秒或毫秒格式，用于对时间线进行排序。

在系统内打开这篇文章 →