摘要
作為企業,保持關注您WhatsApp Business Account (WABA) 的任何變更至關重要,特別是在違反 WhatsApp 政策 時。通過與 Webhooks 合,您可以收到有關 WABA 更的實時通知,允許您快速調整行為並避免額外的警告和/或執行行動。
指導
開始之前
要完成本指南,您需要:
設定 商業管理員 戶
創建具有 Meta for Developers 用程序的 商業 類型並 將其連結到您的商業管理員
將 WhatsApp 作為產品添加到您的應用程序
確保您的應用程序已完成 應用程序審查 並請求
whatsapp_business_management限 若要將 WhatsApp 作為產品添加到您的應用程序,請按照以下步進行:前往 Facebook 的開發者入口網站 並點擊您的應用程序
在應用程序儀表板上,找到左側面板上的 產品 並點擊 添加產品
找到 WhatsApp 並點擊 設定
步 1:設定端點和配置 Webhooks
按照我們的 Webhooks 入門指南 建您的端點並配置您的 Webhooks。
步 2:將您的應用程序訂到您的 WABA
您需要將您的應用程序訂到 WABA 的 Webhooks 通知。您可以通过兩種方式實現:
步 3:冊戶更新
現在您的應用程序已訂 Webhooks,您可以定義要接收的更新類型。要跟您的 WABA 態,請選 account_update 項。这將在您的 WABA 反 WhatsApp 政策時通知您。要選此選項:
前往您的應用程序儀表板並找到 設定 項
點擊 Webhooks 後 管理
將出現一個對話框,顯示您可以訂的所有字段。點擊 訂
account_update將在 WABA 反政策時收到以下類型的通知:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "whatsapp-business-account-id",
"time": 1604703058,
"changes": [
{
"field": "account_update",
"value": {
"phone_number": "16505551111",
"event": "ACCOUNT_VIOLATION",
"violation_info": {
"violation_type": "ALCOHOL"
}
}
}
]
}
]
}
步 4:跟 WABA 限制
監視您的 Webhooks,以查看您的 WABA 是否因違反政策而受到限制。如果已對您的 WABA 加了限制,您將收到包含 restriction_info 字段的 Webhooks,該字段列出了對您的戶施加的所有限制及其到期時間。以下是報告限制的 Webhooks 示例:
限制添加新電話號碼:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION",
"expiration": TIMESTAMP
}
]
}
}限制發送 商業主動發送的消息:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}限制響應 用戶主動發送的消息:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}
按照這些步,您將能設定 WABA 的 Webhooks 並接收有關戶變更的實時通知,助您保持守 WhatsApp 政策,避免任何在問題。
常見問題 (FAQ)
開始使用
1. 定 WABA Webhooks 之前我需要什麼?
您需要冊為 Meta Developer,設定商業管理員戶,創建具有商業類型的 Meta for Developers 用程序,將其連結到您的商業管理員,並將 WhatsApp 添加為產品。您的應用程序還必須完成應用程序審查並請求 whatsapp_business_management 限。
2. 如何將 WhatsApp 添加為我的應用程序的產品?
您可以通過前往 Facebook 開發者入口網站,開您的應用程序,選 添加產品,找到 WhatsApp 並點擊 設定 來添加 WhatsApp。
配置 Webhooks
3. 如何設定端點和配置 Webhooks?
您可以按照 Webhooks 入門指南創建您的端點和配置 Webhooks 置。
4. 如何將我的應用程序訂到 WABA Webhooks 通知?
您可以通過使用 API 叫或 Graph API Explorer 您的應用程序訂到 WABA Webhooks 通知。
5. 我可以訂哪些類型的更新?
要跟 WABA 態,您應該訂 account_update 字段,這將在政策違反和戶相關事件時通知您。
政策違反通知
6. 如何知道我的 WABA 是否違反了政策?
您將收到一個 Webhooks 通知,其中 event 字段設置為 ACCOUNT_VIOLATION,以及有關違反類型的詳細信息。
7. 政策違反通知中包括什麼信息?
違反通知包括電話號碼、事件類型和顯示具體政策違反的 violation_info 字段。
跟限制
8. 如何跟對我的 WABA 加的限制?
您將收到包含 restriction_info 字段的 Webhooks 通知,該字段列出了對您的戶施加的所有限制及其到期時間。
9. 我可能會收到哪些類型的限制通知?
您可能會收到添加新電話號碼、發送商業主動消息或響應用戶主動消息的限制通知。
10. 收到限制通知後我該怎麼做?
監視您的 Webhooks 並調整您的消息行為,以保持守 WhatsApp 的政策並避免進一步的執行行動。
