将 WhatsApp 注册检测添加到 CRM 工作流
设计一个 CRM 工作流,用于检查新联系人的 WhatsApp 注册状态,将结果存储为属性,并根据许可情况规划后续跟进。

一份分步式的 WhatsApp 检测 CRM 工作流指南:何时触发检测、如何规范化号码、应存储哪些属性和标签,以及如何规划后续跟进。
WhatsApp 检测 CRM 工作流会在创建联系人或其电话号码发生变更时运行注册检测,将结果和检测日期写回记录,并利用该标签决定联系人可进入的后续跟进序列。检测结果有助于规划沟通渠道;是否可以发送消息仍取决于联系人的 opt-in 状态。通过这种方式构建,CRM 能够保持最新的账号存在信号,而无需每晚重新检查整个数据库。
检测在联系人生命周期中的位置
关于此主题的供应商指南通常会将检测工具和 CRM 并列展示,但往往忽略了设计层面的问题:何时触发检测、存储什么内容,以及如何处理无法判定的结果。请从触发器开始规划。
- 创建联系人:通过表单、导入或销售代表录入线索时。
- 电话号码变更:现有记录的电话号码发生变化时,因为旧的检测结果已不再适用。
- 加入序列前:在加入 WhatsApp 序列之前,如果存储的检测结果已超过团队设定的重新检测窗口期。
避免进行全库定时检查。每完成一次检测都会产生费用,无论号码是否已注册,因此反复检查未变更的记录会消耗余额,且无法提供额外信息。
分步设计 WhatsApp 检测 CRM 工作流
- 规范化号码:使用记录的国家/地区字段将存储的电话值转换为 E.164 格式:包含国家代码、国家内号码,且不含前缀零。无法规范化的记录应标记为“需要审核”,而不是进行检测。
- 去重:如果两条记录共享同一个规范化后的号码,则仅检查一次并将结果写入两条记录。
- 调用实时检测:CRM 自动化或中间件步骤发送
POST /api/v1/check请求,包含X-API-Key请求头、E.164 格式号码以及针对 WhatsApp 注册检测选择的service_type。结果会在同一响应中返回,因此工作流无需轮询即可继续。 - 批量处理导入:对于包含数百条线索的 CSV 导入,
POST /api/v1/batch-check每次请求最多可处理 100 个号码。对于极大规模的历史数据库清理,批量文件任务更为合适:上传文件、等待处理、下载结果文件,然后按电话号码将行映射回原记录。 - 写回并标记:将结果和检测日期存储在记录中,然后让 CRM 自身的工作流规则应用标签并添加联系人。
请将 API 密钥存储在 CRM 的密钥管理或集成设置中,切勿将其存储在联系人字段或共享电子表格中。
值得存储的属性和标签
保持架构简洁,便于销售人员阅读。以下是团队定义的典型自定义属性集:
| 属性 | 建议值 | 用途 |
|---|---|---|
| WhatsApp 检测结果 | 已注册 / 未注册 / 无法判定 / 未检测 | 决定序列资格 |
| WhatsApp 最后检测时间 | 日期 | 支持重新检测规则 |
| WhatsApp 检测类型 | 注册、头像、商业账号 | 记录产生结果的检测类型 |
| WhatsApp 商业账号 | 是 / 否 / 未检测 | 仅在运行 WhatsApp 商业账号检测时填充 |
“无法判定”这一状态非常重要。无法判定的检测会返回非零业务代码,绝不应将其存储为“未注册”。同样,商业账号属性中的“否”仅表示未检测到商业账号信号;这并不代表该联系人是个人用户或未与公司关联。
尊重信号局限性的跟进规则
一旦存储了结果,工作流规则即可根据结果进行分支处理:
- 已注册且已获得 opt-in:符合 WhatsApp 序列资格,需遵守消息服务提供商的自身规则。
- 已注册但未获得 opt-in:在获得许可前,继续通过电子邮件或电话进行外联。WhatsApp Business Messaging Policy 要求企业在联系他人前必须获得 opt-in,并要求尊重退订请求,包括从联系人列表中移除。
- 未注册:通过电子邮件、短信或电话进行后续跟进,而非使用 WhatsApp 模板。
- 无法判定:暂缓处理以待后续重试,在获得明确结果前,不要将联系人加入仅限 WhatsApp 的步骤。
已注册结果仅代表检测时的平台账号存在信号。号码可能会被重新分配,因此设置重新检测窗口(例如在每次新活动开始前)可以防止标签过期。
操作集成
- 监控余额:仪表板显示余额、API 密钥、验证历史和批量任务状态;集成程序可在进行大规模导入前通过
GET /api/v1/balance读取余额。 - 遵守使用限制:API 文档记录了每用户的并发和超时控制。请根据这些限制调整并行工作进程,并查阅当前的 API 文档,而不是假设固定的请求速率。
- 单独记录失败情况:网络错误和无法判定的检测应记录在错误日志中并设置重试时间,而不应写入联系人的结果属性中。
- 保持格式一致:Meta 的 phone number format guidance 显示,不带加号和国家代码的号码可能会解析为错误的接收者,因此用于检测的规范化号码也应是用于发送的号码。
常见问题解答
团队如何避免为同一联系人的重复检测付费?
仅在创建联系人、电话号码变更或超过重新检测窗口后的加入序列时触发检测,并在调用 API 前对规范化号码进行去重。存储最后检测日期,以便自动化流程跳过近期已有完成结果的记录。
当检测无法判定时,CRM 应该存储什么?
存储一个单独的值(如“无法判定”),记录该次尝试,并安排重试。无法判定的检测并非已完成的“未注册”结果,因此不应将联系人永久移入非 WhatsApp 跟进流程。
哪种 API 调用适合数百条线索的 CRM 导入?
同步多号码端点 POST /api/v1/batch-check 每次请求最多可接受 100 个号码,并在同一响应中返回结果,因此可以通过几次请求处理数百条线索。极大规模的历史数据清理则适合使用批量文件任务。
商业账号结果可用于 B2B 分段吗?
它可以作为输入项之一。当选择 WhatsApp 商业账号检测时,结果会显示该账号是否为 WhatsApp 商业账号。它仅识别账号类型,并不确认公司是否已注册或是否拥有联系许可。
了解更多
选择符合您工作流下一步的产品信息。