跳转到主要内容

如何使用 WABA 和电话号码 Webhook 事件

摘要

本指南介绍了 Wati 中与 WhatsApp Business Accounts (WABA) 和电话号码相关的 webhook 事件。这些事件可帮助您实时监控账户状态变更、政策更新、电话号码质量更新和删除事件。您可以使用这些 webhook 自动发送通知、触发工作流，并使您的内部系统与 Wati 保持同步。

注意：有关 Wati webhook 的更多信息，请参阅 Wati 开发者文档。

说明

1. WABA 状态审核更新

当 WhatsApp Business Account 的审核状态发生变化时，会触发此 webhook。

  • 触发条件：WhatsApp Business Account (WABA) 的审核状态发生变化

  • 事件：wabaStatusReviewUpdate

  • 状态：WABA 审核状态已更新

示例 webhook 负载

{
  "eventType": "wabaStatusReviewUpdate",
  "accountReviewStatus": "APPROVED",
  "wabaId": "330039560200863"
}

WABA 审核状态值

状态值

描述

APPROVED

WhatsApp Business Account 已获批准，可与 API 配合使用。

REJECTED

WhatsApp Business Account 因违反政策而被拒绝，无法与 API 配合使用。

PENDING

审核流程仍在进行中，WhatsApp Business Account 尚无法与 API 配合使用。

DEFERRED

审核决定已推迟，WhatsApp Business Account 当前无法与 API 配合使用。

用例

  • 自动监控 WhatsApp Business Account 审核状态的变更

  • WABA 获批或被拒时通知管理员

  • WABA 获批后触发入职工作流

  • WABA 处于待定或推迟状态时暂停 API 相关工作流

  • 使内部系统与 WABA 审核更新保持同步

2. WABA 账户已删除

当 WhatsApp Business Account 被删除时，会触发此 webhook。

  • 触发条件：WhatsApp Business Account (WABA) 已删除

  • 事件：accountDeleted

  • 状态：WABA 账户已删除

示例 webhook 负载

{
  "eventType": "accountDeleted",
  "wabaId": "message.WabaId"
}

用例

  • 检测何时移除了 WhatsApp Business Account

  • 通知管理员已删除的 WABA 账户

  • 从内部系统中移除已断开连接的 WABA 账户

  • 触发账户删除后的清理工作流

  • 使账户记录与 Wati 更新保持同步

3. WABA 账户内容已更新

当 WhatsApp Business Account 收到与账户相关的更新（如政策违规、封禁或限制）时，会触发此 webhook。

  • 触发条件：WhatsApp Business Account (WABA) 收到与账户相关的更新，如政策违规、封禁或限制

  • 事件：accountUpdated

  • 状态：WABA 账户已更新

示例 webhook 负载

{
  "eventType": "accountUpdated",
  "wabaId": "message.WabaId",
  "event": "message.Event",
  "violationInfo": {
    "violation_type": "message.ViolationType"
  },
  "banInfo": {
    "waba_ban_state": "message.WabaBanState",
    "waba_ban_date": "message.WabaBanDate"
  },
  "restriction_info": [
    {
      "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    }
  ]
}

限制类型

限制类型

描述

RESTRICTED_ADD_PHONE_NUMBER_ACTION

限制向 WABA 添加新电话号码。

RESTRICTED_BIZ_INITIATED_MESSAGING

限制业务发起的消息。

RESTRICTED_CUSTOMER_INITIATED_MESSAGING

限制客户发起的消息。

用例

  • 监控 WhatsApp Business Account 的政策违规情况

  • 自动检测账户封禁或限制

  • 就账户健康问题通知管理员

  • 在应用消息限制时触发工作流

  • 使合规性和监控系统与 WABA 更新保持同步

  • 跟踪限制到期日期以进行运营规划

4. 电话号码质量更新事件

当 WhatsApp 电话号码的消息质量、吞吐量或消息限制发生变化时，会触发此 webhook。

  • 触发条件：WhatsApp 电话号码的消息质量、吞吐量或消息限制发生变化

  • 事件：PhoneNumberQualityUpdatedEvent

  • 状态：电话号码质量已更新

示例 webhook 负载

{
  "eventType": "PhoneNumberQualityUpdatedEvent",
  "phoneNumber": "12177593225",
  "event": "THROUGHPUT_UPGRADE",
  "currentLimit": "TIER_UNLIMITED",
  "oldLimit": "",
  "channelId": null,
  "channelPhoneNumber": "17735704742"
}

消息限制和吞吐量值

值

描述

TIER_50

消息限制为 50。

TIER_250

消息限制为 250。

TIER_1K

消息限制为 1,000。

TIER_10K

消息限制为 10,000。

TIER_100K

消息限制为 100,000。

TIER_NOT_SET

该 business phone number 尚未用于发送消息。

TIER_UNLIMITED

该 business phone number 具有更高的吞吐量和无限的消息容量。

用例

  • 自动监控消息限制和吞吐量的变更

  • 检测电话号码质量的升级或降级

  • 当消息容量发生变化时通知管理员

  • 跟踪 WhatsApp 号码的消息层级升级

  • 根据吞吐量变化触发运营工作流

5. 电话号码已删除

当一个电话号码从 WhatsApp Business Account 中移除时，会触发此 webhook。

  • 触发条件：电话号码从 WhatsApp Business Account (WABA) 中移除

  • 事件：phoneNumberDeleted

  • 状态：电话号码已删除

示例 webhook 负载

{
  "eventType": "phoneNumberDeleted",
  "wabaId": "message.WabaId",
  "phoneNumber": "message.PhoneNumber"
}

用例

  • 检测何时从 WhatsApp Business Account 中移除了电话号码

  • 通知管理员已删除的 WhatsApp 号码

  • 从内部系统中移除已断开连接的电话号码

  • 触发电话号码删除后的清理工作流

  • 使账户和通道记录与 Wati 更新保持同步

常见问题解答 (FAQ)

WABA webhook 事件

1. Wati 中的 WABA 和电话号码 webhook 事件用于什么？

Wati 中的 WABA 和电话号码 webhook 事件用于实时监控账户状态变更、政策更新、电话号码质量更新和删除事件。这些 webhook 可以帮助自动发送通知、触发工作流，并使内部系统与 Wati 保持同步。

2. wabaStatusReviewUpdate webhook 事件是什么意思？

当 WhatsApp Business Account (WABA) 的审核状态发生变化时，会触发 wabaStatusReviewUpdate webhook 事件。

3. WABA 审核状态值是什么意思？

WABA 审核状态值的含义如下：

  • APPROVED 表示 WhatsApp Business Account 已获批准，可与 API 配合使用。

  • REJECTED 表示 WhatsApp Business Account 因违反政策而被拒绝，无法与 API 配合使用。

  • PENDING 表示审核流程仍在进行中，WhatsApp Business Account 尚无法与 API 配合使用。

  • DEFERRED 表示审核决定已推迟，WhatsApp Business Account 当前无法与 API 配合使用。

4. accountDeleted webhook 事件是什么意思？

当 WhatsApp Business Account (WABA) 被删除时，会触发 accountDeleted webhook 事件。

5. accountUpdated webhook 事件是什么意思？

当 WhatsApp Business Account 收到与账户相关的更新（如政策违规、封禁或限制）时，会触发 accountUpdated webhook 事件。

6. accountUpdated webhook 中可以包含哪些限制类型？

accountUpdated webhook 可以包含以下限制类型：

  • RESTRICTED_ADD_PHONE_NUMBER_ACTION 限制向 WABA 添加新电话号码。

  • RESTRICTED_BIZ_INITIATED_MESSAGING 限制业务发起的消息。

  • RESTRICTED_CUSTOMER_INITIATED_MESSAGING 限制客户发起的消息。

7. PhoneNumberQualityUpdatedEvent webhook 事件是什么意思？

当 WhatsApp 电话号码的消息质量、吞吐量或消息限制发生变化时，会触发 PhoneNumberQualityUpdatedEvent webhook 事件。

8. PhoneNumberQualityUpdatedEvent webhook 中的消息限制值是什么意思？

消息限制值表示 WhatsApp 电话号码的消息容量：

  • TIER_50 表示消息限制为 50。

  • TIER_250 表示消息限制为 250。

  • TIER_1K 表示消息限制为 1,000。

  • TIER_10K 表示消息限制为 10,000。

  • TIER_100K 表示消息限制为 100,000。

  • TIER_NOT_SET 表示该 business phone number 尚未用于发送消息。

  • TIER_UNLIMITED 表示该 business phone number 具有更高的吞吐量和无限的消息容量。

9. phoneNumberDeleted webhook 事件是什么意思？

当电话号码从 WhatsApp Business Account (WABA) 中移除时，会触发 phoneNumberDeleted webhook 事件。

相关文章
如何更新已连接的电话号码和业务组合
如何将您的 WhatsApp 电话号码连接到 Facebook 和 Instagram 页面
如何检查 WhatsApp Business 帐户 (WABA) 状态
如何为 WhatsApp 商业帐户（WABA）通知设置 webhooks
如何在 Wati 中为多个 WhatsApp 号码设置 Webhook
这是否解答了您的问题？