WhatsApp 对接 CRM：3 种集成方式与数据同步

WhatsApp 与 CRM 之间应映射哪些字段？

只映射少量稳定的标识符和状态字段，除非确有需要，否则不要把消息内容放进 CRM。

请提前把这些创建为自定义属性；上线后再修改字段类型会很麻烦。

如何在 WhatsApp 和 CRM 之间同步同意状态？

把 CRM 作为 opt-in 的权威记录系统，并在每次由企业发起的营销消息发送前检查。WhatsApp 商业政策只允许您联系已提供号码并同意接收您信息的人，并要求您尊重屏蔽、停止或退订的请求。

一套可行的规则：

1. 采集同意时，明确说明对方将在哪个渠道收到什么内容。
2. 按渠道保存同意状态，并记录来源、时间戳和文案。
3. 收到退订消息或被屏蔽时，立即更新同意状态。
4. 发送步骤要读取字段本身，而不是缓存的名单。
5. 把服务对话（对客户自己发起的消息的回复）与营销发送分开。

请阅读多渠道营销活动的 opt-in 与同意，并用 opt-in 同意声明生成器生成文案。

如何让集成保持可靠？

快速确认 webhook，先存储再处理，并让处理过程具备幂等性。

• 先存储，再确认，最后处理。 在处理程序里执行缓慢的 CRM 调用会导致重试和重复。
• 按消息 ID 去重； 同一事件出现两次时视为空操作。
• 预期事件会乱序。 迟到的 SENT 不能覆盖 DELIVERED。
• 为 CRM 调用限速， 出错时退避重试。
• 安全地匹配联系人。 规范化号码，有意识地处理两个联系人使用同一号码的情况，绝不只按姓名合并。
• 绝不在 webhook 处理程序中重发。 在单独的任务里检查状态后再决定是否重试。
• 保护端点。 使用 HTTPS、不可猜测的路径，并校验请求体结构。Meta 对其自身的 webhook 记录了 mTLS；我们的 webhook 请参阅相关页面。
• 监控。 对 webhook 失败、队列深度和入站事件骤降设置告警。

我们记录了哪些 CRM 和工具？

我们在集成页面记录了多个系统的对接模式。它们都不是应用市场应用，每一页讲的都是如何在该产品中使用 REST API 和 webhook。

CRM 内部有哪些动作可用取决于您在该厂商的套餐，请以其文档为准。

AI 智能体能同时对接 CRM 和 WhatsApp 吗？

可以，前提是给智能体受控的工具。Model Context Protocol（MCP）是一项开放标准，让 AI 助手可以调用外部工具。我们的 MCP 服务器以您提供的令牌所具有的权限，向 MCP 客户端开放消息 API（发送、模板、送达报告）；读取或更新 CRM 记录则需要您自己掌控的连接器。建议先从只读查询开始，逐项增加写入动作，并记录一切。参见 WhatsApp MCP 服务器指南和客服 AI 智能体。

案例：吉达的一家房地产中介

“Red Sea Homes”是一家虚构的中介公司，希望每个房源咨询都能收到 WhatsApp 回复，并让每段对话都出现在线索记录上。

1. 门户网站的咨询创建一条线索，手机号为 E.164 格式，并带有来自表单的同意勾选框。
2. 工作流检查同意状态，然后发送一个已审核的实用型（Utility）模板确认咨询，并保存消息 ID。
3. 客户回复；webhook 更新“最后入站时间”，并指派线索负责人。
4. 负责人在 24 小时内通过收件箱发送自由格式消息回复。沉默之后，下一次跟进使用已审核的模板，并且类别正确、已获同意。
5. 阶段变为“已预约看房”时，前一天发送提醒模板。
6. 团队每周复盘发送失败和号码不匹配的情况。

消息侧的做法请参见WhatsApp 房产线索跟进。

应避免哪些错误？

• 用姓名或未规范化的号码匹配联系人。
• 跳过同意字段，全靠记忆。
• 在 webhook 处理程序里做处理，结果超时。
• 在被归为实用型的模板里放营销内容；类别由 Meta 决定。
• 忘记 24 小时窗口之外只能发送模板。
• 让两个系统编辑同一个字段，却没有规定谁优先。
• 没有告警，导致失效的 webhook 数周都无人察觉。

OmniChannels.ai 如何提供帮助

OmniChannels.ai 由 BroadNet Technologies 提供技术支持，提供 REST/JSON API、用于送达状态的 webhook、供客服处理对话的 Omni Inbox，以及面向 AI 智能体的 MCP 服务器。BroadNet 是 Meta 官方认可的商业解决方案提供商（Business Solution Provider），我们的团队会与您一起办理 WhatsApp 开通和注册。开发人员可以从 API 文档和 WhatsApp API 指南开始；测试权限开放给您自己已验证的号码，不提供即时自助注册。