---
title: "WhatsApp 对接 CRM：3 种集成方式与数据同步"
description: "WhatsApp CRM 集成详解：现成连接器、中间件或 API 加 webhook 三种方式，数据流向、字段映射、同意状态同步，以及选型检查清单。"
canonical: "https://omnichannels.ai/zh/blog/whatsapp-crm-integration-guide/"
language: "zh"
updated: "2026-11-02"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
category: "integration"
primaryQuery: "whatsapp crm integration"
keywords: ["WhatsApp CRM 集成", "WhatsApp 对接 CRM", "WhatsApp HubSpot 集成", "WhatsApp Salesforce 集成", "WhatsApp Zoho CRM", "WhatsApp Business API webhook", "WhatsApp CRM 字段映射"]
published: "2026-11-02"
author: "OmniChannels.ai Editorial Team"
reviewer: "BroadNet Messaging Solutions Team"
readingMinutes: 10
answer: "WhatsApp CRM 集成是把 WhatsApp Business API 与 CRM 连接起来，使入站消息、送达状态和出站发送都与联系人记录关联。有三种实现方式：现成连接器、中间件或自动化工具、直接使用 API 和 webhook。请根据所需逻辑的复杂度、由谁维护，以及对同意状态同步的严格程度来选择。"
takeaways: ["WhatsApp CRM 集成包含两条数据流：CRM 通过 API 触发出站消息，入站消息和送达状态则通过 webhook 回传并更新联系人。", "三种方式分别是现成连接器（最快，灵活性最低）、中间件或自动化工具（较均衡）、直接使用 API 加 webhook（控制力最强，需要开发人员）。", "请用规范化的 E.164 手机号匹配联系人，绝不要用姓名匹配，并把同意来源和时间戳作为 CRM 字段保存。", "webhook 事件可能重复到达或乱序，所以应保存原始事件、快速确认，再异步处理并去重。", "24 小时客服窗口之外由企业发起的消息必须使用已审核的模板，因此 CRM 需要记录最后一条入站消息的时间。"]
faq: 
  - q: "什么是 WhatsApp CRM 集成？"
    a: "它是 WhatsApp Business API 与 CRM 之间的连接，让对话、消息状态和同意状态与正确的联系人或线索绑定。通常由 CRM 的工作流触发出站消息，webhook 再把入站消息和送达状态回传，更新记录和时间线。仅使用 WhatsApp Business App 没有这样的 API 连接。"
  - q: "可以把 WhatsApp Business App 连接到 CRM 吗？"
    a: "一般不行。CRM 集成通过 WhatsApp Business Platform 实现，也就是商业解决方案提供商使用的 API，而不是可免费下载的 Business App。您需要把号码注册到该平台，号码的使用方式也会随之改变。把目前客服在手机上使用的号码迁移之前，请先阅读我们对 API 与 Business App 的对比。"
  - q: "哪些 CRM 可以连接 WhatsApp？"
    a: "任何能调用 HTTP API 或运行 webhook 的 CRM，都可以直接或通过自动化工具连接 WhatsApp Business API。我们在集成页面中记录了 HubSpot、Salesforce、Zoho CRM、Microsoft Dynamics 365、Zendesk 和 Freshdesk 的对接模式。内置动作是否可用取决于您的 CRM 订阅，请核对自己的套餐。"
  - q: "WhatsApp CRM 集成需要开发人员吗？"
    a: "不一定。简单的触发，例如商机阶段变化时发送一个模板，可以在自动化工具或 CRM 工作流中完成。自定义字段逻辑、带去重的双向同步、同意检查、重试，以及任何需要规模化的功能，则需要开发人员。无论如何都要规划监控，因为没有告警的集成会悄无声息地失败。"
  - q: "如何在 CRM 中处理 opt-in 和同意？"
    a: "按渠道保存同意字段，并记录来源、时间戳和展示给用户的文案。每次营销发送前先检查，用户退订时立即更新。WhatsApp 的商业政策只允许您联系已提供号码并 opt-in 的人，所以 CRM 应当是该状态的权威记录系统。"
  - q: "AI 智能体可以从 WhatsApp 读取和更新我的 CRM 吗？"
    a: "如果把 AI 智能体接入您的系统，例如通过 Model Context Protocol（MCP），它就可以使用工具查询和更新记录。请给它最小的权限，记录每一次操作，并保留转人工的通道。我们的 MCP 服务器向 MCP 客户端开放消息 API；CRM 操作则需要您自己掌控的连接器。"
sources: 
  - title: "WhatsApp Business Messaging Policy"
    url: "https://whatsappbusiness.com/policy/"
  - title: "Webhooks overview: WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview"
  - title: "Send messages and the customer service window, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages"
  - title: "Template categorization, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization"
---

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

Canonical: https://omnichannels.ai/zh/blog/whatsapp-crm-integration-guide/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

本指南写给希望让 WhatsApp 对话和消息进入 CRM 的销售运营、CRM 管理员和开发人员。内容涵盖三种连接方式、两个方向上应当流动的数据，以及大多数项目容易忽略的同意与可靠性规则。

## 什么是 WhatsApp CRM 集成？

WhatsApp CRM 集成是 WhatsApp Business API 与 CRM 之间的连接，使消息、送达状态和同意状态附着在正确的联系人、线索或工单上。

它始终包含两条数据流：

- **出站：** CRM 中的某件事（表单提交、商机阶段、某个日期）通过 API 触发一条 WhatsApp 消息。
- **入站：** 客户的回复和送达状态通过 webhook 推送回来，匹配到联系人，并写入 CRM。

不要把它与只显示聊天记录的侧边栏小组件混为一谈。真正的价值来自这两条数据流，加上干净的联系人匹配。关于 webhook 机制的细节，请阅读[如何用 webhook 把 CRM 连接到全渠道收件箱](/zh/blog/connect-crm-omnichannel-inbox-webhooks/)。

## 开始之前需要准备什么？

您需要一个 WhatsApp Business API 号码、用于企业发起消息的已审核模板、能调用 API 或运行 webhook 的 CRM，以及有文档记录的同意流程。

检查清单：

1. 在 WhatsApp Business Platform 上注册的号码（不是免费的 Business App；参见 [API 与 Business App 对比](/zh/blog/whatsapp-business-api-vs-business-app/)）。参见[如何开通 WhatsApp Business API](/zh/blog/how-to-set-up-whatsapp-business-api/)和[准备情况检查清单](/zh/tools/whatsapp-api-readiness-checklist/)。
2. 为 CRM 将要触发的消息准备已审核的模板，并归入正确的[类别](/zh/blog/whatsapp-template-categories-approval/)。
3. 手机号以 [E.164](/zh/glossary/e164/) 格式保存（国家代码，不含空格和前导零）。
4. 每个联系人都有 opt-in 记录。
5. 为集成指定负责人，并设置故障告警渠道。

## WhatsApp 与 CRM 集成有哪三种方式？

您可以使用现成连接器、中间件或自动化工具，或者直接使用 API 和 webhook。三者是在速度与控制力之间的取舍。

| | 现成连接器 | 中间件或自动化工具 | 直接使用 API 和 webhook |
|---|---|---|---|
| 是什么 | 把消息服务商与 CRM 相连的现成应用或内置功能 | 位于 CRM 与 API 之间的可视化工作流工具（例如 Zapier、Make 或 n8n） | 您自己编写代码调用 REST API 并接收 webhook |
| 上手速度 | 最快 | 较快 | 最慢 |
| 灵活性 | 仅限连接器开放的功能 | 典型流程下较高 | 最高 |
| 谁来维护 | 连接器厂商 | 业务分析人员 | 您的开发人员 |
| 典型限制 | 字段映射固定；可能不覆盖所有渠道或自定义对象 | 工具本身的任务数、延迟和单次运行限制 | 需要研发投入、监控和测试 |
| 最适合 | 受支持 CRM 上的标准需求 | 没有开发人员的团队；原型验证 | 复杂逻辑、大流量、严格的同意规则 |

对任何声称连接器“开箱即用”的说法都要保持警惕。请追问：webhook 重复到达时它怎么处理？一个号码匹配两个联系人时怎么办？同意状态如何检查？

说明一下我们自己的做法：OmniChannels.ai 通过 REST API、webhook 和自动化工具集成，我们的集成页面也明确说明，这些 CRM 并没有对应的应用市场应用。

### 应该选哪种方式？

1. 如果您的 CRM 有覆盖您的用例和同意字段的连接器，就从它开始。
2. 如果需要触发器和字段更新但不想写代码，使用中间件。
3. 如果需要自定义逻辑、大流量或可审计性，直接使用 API，可以先用中间件过渡。
4. 无论选哪种，都先用您自己已验证的号码测试。

## 数据是如何流动的？分步图解

用文字描述，流程如下。

**出站**
1. CRM 工作流触发（例如，一条已同意的新线索）。
2. 工作流或中间件检查同意状态和最后一次入站时间。
3. 调用消息 API，传入联系人的 E.164 号码和已审核的模板；如果 24 小时窗口仍然开启，也可以发送自由格式消息。
4. API 返回消息 ID，您把它存到联系人时间线上。

**入站与状态**
5. WhatsApp 把客户的回复送达平台，平台向您的 webhook URL 推送一个事件。
6. 您的端点保存原始请求体，返回 2xx，并把事件放入队列。
7. 后台任务把发送者号码匹配到联系人（流程允许时可新建联系人），并记录消息。
8. 状态事件（我们规范化格式中的 SUBMITTED、SENT、DELIVERED、READ、FAILED、REJECTED）更新已存储的消息，状态绝不倒退。
9. 触发规则：指定负责人、创建任务、推进商机阶段或给联系人打标签。

Meta 对 WhatsApp 消息 webhook 的描述是：涵盖来自用户的消息，以及您所发消息的状态。我们的 [webhook 文档](/developers/webhooks/)介绍了送达状态、重试，以及事件丢失时的处理办法。各渠道的载荷字段不同，因此请记录原始事件，并依据您自己账户中的真实样本做映射。

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

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

| CRM 字段（建议） | 来源 | 方向 | 备注 |
|---|---|---|---|
| 手机号（E.164） | CRM 或表单 | CRM → API | 发送前先规范化；必要时用号码查询验证 |
| WhatsApp 同意状态（是/否/已撤回） | opt-in 采集 | 以 CRM 为准 | 每次营销发送前检查 |
| 同意来源和时间戳 | 表单、二维码、聊天或勾选框 | CRM | 保留展示给客户的文案 |
| 首选语言 | CRM | CRM → API | 决定模板语言 |
| 最后一条入站消息时间 | Webhook | API → CRM | 告诉您 24 小时窗口是否开启 |
| 最后一条消息状态 | Webhook | API → CRM | 只能向前更新 |
| 消息 ID | API 响应 | API → CRM | 用于把状态匹配到时间线条目 |
| 会话链接 | 收件箱 | API → CRM | 让销售一键打开对话 |
| 负责人或指派客服 | CRM 或收件箱 | 双向 | 规定冲突时以哪个系统为准 |
| 生命周期阶段或标签 | CRM | CRM → 收件箱 | 让客服看到商机背景 |

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

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

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

一套可行的规则：

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

请阅读[多渠道营销活动的 opt-in 与同意](/zh/blog/opt-in-consent-multichannel-campaigns/)，并用 [opt-in 同意声明生成器](/zh/tools/opt-in-consent-generator/)生成文案。

## 如何让集成保持可靠？

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

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

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

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

| 系统 | 典型模式 | 页面 |
|---|---|---|
| HubSpot | 工作流自定义代码或 webhook 动作，或使用自动化工具 | [HubSpot](/zh/integrations/hubspot/) |
| Salesforce | Flow HTTP 调用，或使用 Named Credential 的 Apex 调用 | [Salesforce](/zh/integrations/salesforce/) |
| Zoho CRM | 工作流 webhook 或 Deluge 函数 | [Zoho CRM](/zh/integrations/zoho-crm/) |
| Microsoft Dynamics 365 | Power Automate 流程 | [Dynamics 365](/zh/integrations/dynamics-365/) |
| Zendesk | 触发器驱动的 webhook；回复使用自动化工具 | [Zendesk](/zh/integrations/zendesk/) |
| Freshdesk | 自动化规则 webhook；回复使用自动化工具 | [Freshdesk](/zh/integrations/freshdesk/) |
| 自动化工具 | Zapier、Make、n8n | [Zapier](/zh/integrations/zapier/)、[Make](/zh/integrations/make/)、[n8n](/zh/integrations/n8n/) |

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

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

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

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

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

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

消息侧的做法请参见[WhatsApp 房产线索跟进](/zh/blog/real-estate-lead-follow-up-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 文档](/zh/developers/)和 [WhatsApp API 指南](/developers/whatsapp/)开始；测试权限开放给您自己已验证的号码，不提供即时自助注册。