通过 companion 桥接程序采集 WhatsApp
使用您自行托管的 companion 桥接程序，将销售代表 WhatsApp Business 上的每一条对话直接采集进“对话”时间线。此功能默认关闭且为可选项，需要接受服务条款提示。
该连接器通过您组织自行托管的 companion 桥接程序，将销售代表在 WhatsApp Business 上的消息采集进“对话”时间线。这些消息会和您其他的对话一同存放，因此 AI 摘要、洞察和跟进监控等功能都能直接在其之上运行。
开始前：服务条款提示
💡 通过 WhatsApp 网页版会话采集对话处于 WhatsApp 服务条款的灰色地带，可能导致该号码被封禁。请使用专用号码，风险自负。我们不托管 WhatsApp 会话：在您自己环境中运行的 companion 程序，才是通过二维码配对并监听消息的部分。
工作原理
- 您在自己的环境中运行一个 companion 桥接程序（一个开源的 WhatsApp 网页版服务）。
- 该 companion 通过二维码与 WhatsApp Business 配对，并监听收发的消息。
- 每条消息发生时，companion 会向您组织的接入 URL 发送一个已签名的 POST 请求。
- 消息会被存储，并根据电话号码关联到对应的联系人或线索（号码未知时会新建一个线索），并显示在“对话”时间线中。
如何连接
- 前往“设置”、“集成”，打开“WhatsApp：通过 companion 采集”卡片。
- 设置一个强配对密钥，并勾选同意选项（我理解服务条款的相关风险）。点击保存。
- 复制显示的接入 URL，并使用该 URL 和相同的配对密钥配置 companion 程序。
- 返回卡片，点击“启用”。若未勾选并保存同意选项，系统将不会接受采集请求。
只要连接器处于关闭状态，或同意选项未保存，接入 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 接受秒或毫秒格式，用于对时间线进行排序。