跳至主要內容

如何使用 WABA 和電話號碼 webhook 事件

摘要

本指南說明 Wati 中與 WhatsApp Business Accounts (WABA) 和電話號碼相關的 webhook 事件。這些事件可協助您即時監控帳戶狀態變更、政策更新、電話號碼品質更新及刪除事件。您可以使用這些 webhooks 自動化通知、觸發工作流程，並讓您的內部系統與 Wati 保持同步。

注意：如需 Wati webhooks 的詳細資訊，請參閱 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 Accounts 的政策違規

  • 自動偵測帳戶封鎖或限制

  • 通知管理員帳戶健康狀況問題

  • 套用訊息限制時觸發工作流程

  • 讓合規性和監控系統與 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

商家電話號碼尚未用於傳送訊息。

TIER_UNLIMITED

商家電話號碼具有較高的流量和無限的訊息容量。

使用情境

  • 自動監控訊息限制和流量變更

  • 偵測電話號碼品質升級或降級

  • 訊息容量變更時通知管理員

  • 追蹤 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 事件用於即時監控帳戶狀態變更、政策更新、電話號碼品質更新及刪除事件。這些 webhooks 可協助自動化通知、觸發工作流程，並讓內部系統與 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 表示商家電話號碼尚未用於傳送訊息。

  • TIER_UNLIMITED 表示商家電話號碼具有較高的流量和無限的訊息容量。

9. phoneNumberDeleted webhook 事件代表什麼意思？

當電話號碼從 WhatsApp Business Account (WABA) 中移除時，會觸發 phoneNumberDeleted webhook 事件。

相關文章
如何更新已连接的電話號碼和業務組合
如何將您的 WhatsApp 電話號碼連結到 Facebook 和 Instagram 專頁
如何檢查 WhatsApp Business 帳戶 (WABA) 狀態
設定 WhatsApp Business Account (WABA) 通知的 webhooks
如何在 Wati 中恢复您的 WhatsApp Business帳戶（WABA）因 Meta 限制或停用而受影響的狀態
是否回答了您的問題？