大多数 WhatsApp 集成项目都卡在同一个地方,而且从来不是团队做了预算的那部分。消息收发第一个下午就能跑通。吃掉剩下几周的,是它周围的管道:你可以用哪个号码、号码归谁、同意的证据存在哪里、你用什么身份把客户对上,以及你的系统必须了解一个自己无法控制的 24 小时时钟。
本文讲的是把 WhatsApp Business API 接进现有技术栈到底需要什么:哪些决定一旦做错就很贵、哪些约束其实是工程问题而不是政策问题,以及在什么情况下你根本不该做集成。
号码是一项承诺,不是一个设置
一个电话号码在同一时间只能绑定一家 Business Solution Provider。前期的大多数决定都从这一条推导而来。
用一个当前没有在 WhatsApp 上激活的专用号码。 已经在跑个人版或 WhatsApp Business 应用的号码必须迁移,而迁移意味着该号码会中断服务。不做规划就把主客服线拉进来,是一个团队在周一早上发现这条约束的典型方式。
在真正上量之前,要预留一道验证关卡。 Meta Business Manager 里的企业验证,是让你跨过入门档位的东西:在它通过之前,你每天只能触达少量独立收件人——测试够用,跑活动毫无意义。尽早启动:它需要公司文件和一个可核验的网站,而且是最容易卡在别人手上的一步。
弄清这项资产归谁。 如果号码是由 BSP 代你持有,日后离开需要的是携号转移,而不是一次导出。签约之前就问,别等到想走的时候。切换的机制见如何选择 WhatsApp BSP。
同意是一条记录,不是一个勾选框
每个集成都需要一个存放 opt-in 的地方,而且必须是一条你能拿给别人看的记录:谁同意的、什么时候、从哪个界面、针对哪段文字。
常见的错误是存一个布尔值。布尔值告诉你客户已订阅;它不告诉你能否证明,也经不起"哪个渠道"这个问题——为邮件收集的同意并不自动覆盖 WhatsApp。请保存时间戳、来源和当时展示的确切文案,并把它挂在联系人身上,而不是丢进一个没人能查询的表单提交日志里。
规则本身,以及在 GDPR 下如何留存证据,见我们的 WhatsApp opt-in 指南。
没人预先规划的身份问题
WhatsApp 以电话号码为索引。而大多数电商系统和 CRM 以邮箱为索引。把两者集成,就意味着你必须明确决定"客户"到底是什么。
重复记录会立刻出现:同一个人既是一条只有邮箱的记录,又是一条只有电话的记录。你会发现号码以五种格式存着,有些没有国家码,在规范成 E.164 之前和任何东西都对不上。你还会发现有些客户的 WhatsApp 号码并不是下单时留的号码。
在写入时规范化,而不是在读取时,并且一开始就决定:一段会话的主键是电话号码还是 CRM ID。等积累了几千段会话再做,那就是一次数据迁移。
24 小时窗口是一条工程约束
政策文档把客服窗口描述成一条规则。在你的系统里,它表现为一种状态:客户给你发消息,窗口打开,只要窗口开着你就能自由回复;一旦关闭,要再次触达就必须使用预先审核过的模板,而模板要花钱、还带类别。
这意味着你的应用在决定怎么发之前,必须知道窗口是否开着。跳过这一步的系统,要么把所有消息都当模板发,为本可免费的消息付费;要么尝试自由回复而静默失败。两种情况下,这个缺陷在看板上都看不见,直到账单寄来。
模板本身也带状态:每一条都要提交审核,而审核不是即时的。凡是有时间要求的,都要提前很久排队提交。窗口与消息类型的机制见24 小时窗口和 WhatsApp Business API 营销。
有什么回流,应该落在哪里
只会发送的集成只建了一半。上线前就要决定技术栈的其余部分接收什么:
每条消息的送达与已读状态,并关联到客户——否则你分不清一次失败的活动和一次不受欢迎的活动。
入站消息,路由到有人能看见的地方。这是团队最容易低估的要求:开一个渠道,就产生了回答它的义务。
会话本身,至少是摘要,落在客户档案上。看不到自动助手已经说过什么的客服,一定会和它自相矛盾。
第二个月会坏掉的东西
质量评级。 Meta 会根据收件人的反应给你的号码打分:拉黑和举报会把它压下去,而评级偏低会削减你的发送上限。这就是惩罚买来的名单和过度发送的机制,它是缓慢劣化的,不会大声报错。
在最糟糕的时刻被拒的模板。 一条听起来像营销、却按 utility 提交的模板会被拒绝或重新归类,而依赖它的活动就错过了窗口。
没有人回复。 最常见的失败是组织层面的,不是技术层面的:入站量来了,却没有排班。对客户来说,一个没人回的 WhatsApp 比没有 WhatsApp 更糟。
什么时候不该做集成
如果你的月度量很小、场景就是一对一对话,免费的 WhatsApp Business 应用完全够用,API 只是你不需要的额外负担。当你需要自动化、同一号码上多人协作,或者要和订单数据打通时,API 才配得上它的复杂度。
如果没有人手看这个收件箱,就别打开它。如果你的名单不是以这个渠道的同意收集来的,就别导入:质量评级会找上你。如果唯一目标是群发,先把账算清楚:每一条由企业发起的消息都有价格,见 WhatsApp Business API 要花多少钱。
行得通的顺序
先号码和验证,因为它们有外部等待时间。其次是同意记录,因为证据没法事后补。第三是身份规范化,赶在会话量把它变成迁移之前。然后是"知道窗口状态"的发送逻辑,再然后是模板,最后才是自动化。把这个顺序倒过来的团队,一周就能交一个演示,然后花一个季度让它变得可以安全使用。
管道铺好之后叠在上面的那层礼宾服务,见 TikJoy 的 WhatsApp AI Concierge。