easyCoexistence
登录开始免费试用
Meta Tech Provider

smb_app_state_sync Webhook

smb_app_state_sync 携带 WhatsApp Business 应用本身的状态,主要是 Coexistence 号码连接时进行的联系人同步。它与携带对话的 history 分开,并且只存在于 Coexistence 号码上。

2

Coexistence 专用同步字段:此字段和 history。

24 hours

完成接入后,必须开始同步的时间窗口。

0

未使用 Coexistence 完成接入的号码上的对应情况。

它携带什么

应用侧状态,实际指的是企业原本保存在手机上的联系人。

每个拥有 WhatsApp 号码的联系人都可以同步到平台。这样,软件就能识别多年来一直保存在企业手机中的客户,而不会把对方当成新号码。这与对话本身不同,对话会到达 history 字段。两者分开,是因为一个是目录,另一个是对话记录。

与 history 一样,此字段只存在于 Coexistence 上。从未使用过该应用的号码没有应用状态可供同步。

它不携带什么

应用自己的工作工具,这些内容在平台侧没有对应表示。

  • 标签保存在设备上,软件无法读取。
  • 快捷回复、问候语和离开消息。
  • 目录、订单和状态。
  • 频道,以及语音或视频通话记录。

这对集成为何重要

因为它决定您的系统从第一天起是否知道是谁在发消息。

没有联系人同步时,每条入站消息都会以没有姓名的电话号码到达,将其匹配到客户记录就成了您的问题。有了同步,企业自己的联系人列表就可用,大部分匹配工作也已完成。

同时为两种情况做好规划是值得的,因为企业可能拒绝同步或错过时间窗口。如果集成假设联系人一定存在,打开它的人就会看到一整面原始号码。

常见错误

  • 假设联系人一定会存在。企业可能拒绝同步或错过时间窗口。
  • 期待此负载中包含标签或快捷回复。它们保留在设备上。
  • 把它与 history 混淆。history 携带的是对话,而不是联系人列表。
使用 EasyCoexistence 完成这些操作

EasyCoexistence 订阅运营字段并记录接入顺序,因此某个号码是否完成同步,以及同步了什么,都会显示在其时间线上。

常见问题

这是与 history 同步相同的东西吗?

不是。此字段携带应用状态,主要是联系人。history 携带对话。

它会运行多次吗?

初始同步是接入流程中的一次性步骤,与 history 一样有 24 小时时间窗口。

我会获得标签吗?

不会。标签是应用功能,没有对应的 API。

普通 Cloud API 号码上也存在此字段吗?

不会。普通 Cloud API 号码没有 WhatsApp Business 应用状态可供同步。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间

smb_app_state_sync