如何对接 WhatsApp 客服？

本文档用于跨境商城后台配置 WhatsApp Business API 客服通道，实现商城前端一键唤起 WhatsApp 咨询、后端统一收发言聊、订单消息自动推送。

前置准备清单（对接必备，缺一不可）

1.Meta 企业 BM 账号（Facebook Business Manager）并完成企业主体认证
2.已注册 WABA（WhatsApp 企业业务账户）+ 未注册过 WhatsApp 的实体手机号（带国家区号，如 + 852/ +1）
3.Meta WhatsApp Cloud API 密钥：Access Token、Phone Number ID、AppID（从 Meta 开发者后台获取）
4.商城服务器 HTTPS 域名（Webhook 强制要求 https，不支持 http）、自定义 Webhook 验签令牌（随机字符串）
5.Meta 合规消息模板（主动触达订单、售后消息必须使用模板）

一、Meta 平台获取 API 密钥与 Webhook 参数

步骤 1：登录 Meta 开发者后台，进入 WhatsApp 产品控制台

1.访问 developers.facebook.com，使用绑定 BM 的企业邮箱账号登录，点击【创建应用】→业务类应用→关联已认证 BM 主体。
2.应用创建完成，在产品列表找到【WhatsApp→获取开始】，跳转 Cloud API 配置页面。
截图点位：Meta 控制台左侧应用菜单栏、WhatsApp 功能卡片位置

步骤 2：提取关键 API 参数

页面复制保存 3 项参数：
永久访问令牌 Access Token（正式密钥，临时令牌 24h 失效不可用）
Phone Number ID（绑定的企业手机号 ID）
App 编号 App ID

步骤 3：配置 Webhook 回调与事件订阅

1.进入 Webhook 设置，回调 URL 填写
2.输入自定义验签令牌（如Mall_WA_2026Verify），点击验证 URL
3.订阅事件：勾选messages、message_status、message_reads三项消息事件并保存

二、商城后端后台绑定 WhatsApp API

进入后台“商城设置-客服设置”，选用 WhatsApp 客服，完成信息填报即可启用客服通道。

• 选择客服类型为 WhatsApp 后，填入 WhatsApp 号码
• 内置号码格式校验机制，强制规范带国家码、无符号/空格/横线的标准格式，实时校验提示，杜绝号码填写错误导致的咨询失联问题
• 配置操作轻量化，复用现有第三方客服分发逻辑，无需改造原有客服体系，一键保存即可生效