WhatsApp Cloud API（BringWhatsApp）

独立扩展：通过 Meta WhatsApp Cloud API 在 CRM 内收发消息。每位业务员绑定自己的商业号码（类似个人邮箱账户），Webhook 入站入库，会话详情气泡面板回信。

与 BringCRM 助手（WhatsApp Web 侧栏 DOM 助手）是两条线，可并存。

安装

1. 安装扩展包 bring-whatsapp（或开发环境 npm run copy-dev 后 Rebuild）
2. 管理 → Rebuild / 清除缓存
3. 为角色开放 WhatsApp 账户 / 会话 / 消息 权限（安装脚本会尽量写入默认角色与导航）

管理员一次性配置

1. 在 Meta 开发者后台 创建应用并接入 WhatsApp
2. 管理 → Bring WhatsApp → WhatsApp Cloud API 设置：
3. 填写 校验令牌（Verify Token）、App Secret、Graph 版本（默认 v21.0）
4. 页头 保存；复制只读字段 Webhook URL（形如 https://你的域名/?entryPoint=WhatsAppWebhook）到 Meta
5. 在 Meta 应用 → WhatsApp → 配置：
6. 回调 URL = 上一步 Webhook URL
7. 校验令牌与 CRM 一致
8. 订阅 messages 及消息状态相关字段
9. 生产环境务必配置 App Secret（用于校验 X-Hub-Signature-256）

用户绑定号码

1. 打开 WhatsApp 账户 → 新建
2. 填写：
3. Phone Number ID（必填）
4. Access Token（长期/系统用户令牌）
5. WABA ID（拉取模板列表必填）
6. 显示号码、负责人（assignedUser）
7. 状态设为 启用

Webhook 按 metadata.phone_number_id 路由到对应启用账户。

会话与收发

1. 客户发来消息后，自动生成 WhatsApp 会话 与消息记录
2. 系统会按号码数字归一化，尝试软匹配客户（Account）/ 联系人（Contact）上的 whatsapp 字段
3. 打开会话详情：底部 聊天 面板为气泡时间线
4. 客服窗（约 24 小时）内：可发自由文本、图片/文件
5. 窗外：只能发 Meta 已审核通过的 模板消息（下拉选择模板后发送）

附件：入站媒体会下载到 CRM 附件；出站先上传到 CRM Attachment，再经 Cloud API 发出。

与 Web 助手的区别

	Cloud API（本扩展）	BringCRM 助手（浏览器扩展）
通道	Meta 官方 API	WhatsApp Web DOM
发信	CRM 内直接发	不代发（侧栏辅助跟进）
号码	商业 API 号	个人/Web 登录号
适用	正式客服收发、模板触达	销售在 Web 聊天时查客户

相关文档

• 绑定个人邮箱（同类「每用户绑定通道」思路）
• BringCRM 助手
• 功能介绍

---

← 返回 BringCRM 产品概览