全部產品
Search

搜尋本產品

    Chat App Message Service：ChatAppAudit（模板審核狀態訊息）

    文件中心

    Chat App Message Service：ChatAppAudit（模板審核狀態訊息）

    更新時間：Dec 25, 2025

    您可以通過指定HTTP URL來接收Chat App Message Service模板審核狀態。

    協議說明

    參數

    說明

    協議

    HTTP + JSON

    編碼

    UTF-8

    前提條件

    說明

    配置模板審核狀態訊息操作步驟參見：配置模板審核狀態訊息。

    請求說明

    單次推送可能包含多條審核狀態報表。

    請求範例

    [
 {    
 "WabaId": "9099999990****",        
 "TemplateCode": "744c4b5c79c9432497a075bdfca3****",    
 "Language": "en_US",    
 "AuditStatus": "unaudit",    
 "Reason": ""
 },
 {    
 "WabaId": "9099999990****",        
 "TemplateCode": "744c4b5c79c9432497a075bdfca*****",    
 "Language": "en_US",    
 "AuditStatus": "unaudit",    
 "Reason": ""
 }
]

    欄位說明

    V1版本

    名稱

    類型

    是否必選

    描述

    WabaId

    String

    是

    WABA的ID。

    說明

    WhatsApp完成註冊後請在WhatsApp官網擷取。

    TemplateCode

    String

    是

    模板編碼。

    說明

    模板編碼可通過Chat App Message Service控制台模板設計頁面，在模板列表查看或通過ListChatappTemplate介面擷取。

    Language

    String

    是

    範本語言。

    AuditStatus

    String

    是

    模板審核狀態。取值：

    • pass：審核通過

    • fail：審核失敗

    • auditing：審核中

    • unaudit：未審核

    • disabled：禁用

    • paused：暫停

    Reason

    String

    否

    模板審核不通過原因。

    說明

    當AuditStatus為fail時有值。

    V2版本

    說明

    V2版本一般適用於ISV在需要管理客戶WABA，號碼狀態等內容時使用。

    名稱

    類型

    是否必選

    描述

    WabaId

    String

    是

    WABA的ID。

    說明

    WhatsApp完成註冊後請在WhatsApp官網擷取。

    TemplateCode

    String

    是

    模板編碼。

    說明

    模板編碼可通過Chat App Message Service控制台模板設計頁面，在模板列表查看或通過ListChatappTemplate介面擷取。

    Language

    String

    是

    範本語言。

    AuditStatus

    String

    是

    模板審核狀態。取值：

    • pass：審核通過

    • fail：審核失敗

    • auditing：審核中

    • unaudit：未審核

    • disabled：禁用

    • paused：暫停

    Reason

    String

    否

    模板審核不通過原因。

    說明

    當AuditStatus為fail時有值。

    Type

    String

    是

    通知類型。取值：

    • template：訊息模板狀態變更

    • phoneNameUpdate：電話號碼名稱狀態變更

    • phoneQualityUpdate：電話號碼品質變更

      • GREEN：高品質

      • YELLOW：中等品質

      • RED：低品質

      • UNKNOWN：未知

    • wabaReviewUpdate：WABA審核狀態變更

    • wabaAccountUpdate：WABA賬戶變更

    • templateCategoryUpdate：模板類別更新

    • templateQualityUpdate：模板品質更新

    說明

    當值為template時，參數與V1版本一致。

    PhoneNumber

    String

    否

    號碼。

    說明

    • 當Type為phoneNameUpdate，phoneQualityUpdate，wabaAccountUpdate時有值；

    • 當Type為wabaReviewUpdate、template時沒有值。

    Status

    String

    否

    狀態。

    說明

    • 當Type=phoneNameUpdate時取值：

      • APPROVED：電話號碼名稱審核通過。

      • REJECTED：電話號碼名稱被拒絕。

      • DEFERRED：電話號碼名稱審核延遲。

    • 當Type=phoneQualityUpdate時取值 （電話號碼品質變化的原因）：

      • ONBOARDING：號碼註冊。

      • UPGRADE：號碼發送量升級。

      • DOWNGRADE：號碼發送量降級。

      • FLAGGED：號碼被標記。

      • UNFLAGGED：號碼取消被標記狀態。

    • 當Type= wabaAccountUpdate時取值：

      • DISABLED_UPDATE：

        • SCHEDULE_FOR_DISABLE：WABA已禁用。

        • DISABLE：WABA被封號。

        • REINSTATE：WABA已解鎖。

      • VERIFIED_ACCOUNT：已認證的WABA賬戶。

      • ACCOUNT_RESTRICTION：WABA違反WhatsApp Business開放平台政策時，會對該WABA施加限制，可能包括以下取值：

        • RESTRICTED_BIZ_INITIATED_MESSAGING：下行訊息受限。

        • RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION：限制添加電話號碼。

        • RESTRICTED_CUSTOMER_INITIATED_MESSAGING：上行訊息受限。

      • ACCOUNT_VIOLATION：WABA賬戶違反政策。

      • PHONE_NUMBER_ADDED：WABA 賬戶增加電話號碼。

      • PHONE_NUMBER_REMOVED：WABA 賬戶移除號碼。

      • BUSINESS_VERIFICATION_STATUS_UPDATE：Facebook商業平台驗證狀態更新

        • BUSINESS_VERIFIED：驗證通過。

        • BUSINESS_REJECTED：驗證被拒絕。

        • MORE_INFORMATION_REQUESTED：需要提供更多資訊。

        • BUSINESS_REVOKED：撤銷審核申請。

      • ACCOUNT_DELETED：刪除WABA賬戶

    • 當Type=wabaReviewUpdate時取值：

      • APPROVED ：WABA審核通過。

      • REJECTED：WABA審核被拒絕。

    • 當Type=template時沒有值。

    CurrentLimit

    String

    否

    號碼的發送量限制。

    說明

    • 當Type=phoneQualityUpdate時取值 ：

      • TIER_50

      • TIER_250

      • TIER_1K

      • TIER_10K

      • TIER_100K

      • TIER_UNLIMITED

      • TIER_UN_SET

    • 其它狀態沒有值。

    響應說明

    接收到回執後，需要在3s內響應，響應的HTTP狀態代碼必須為200，且響應體格式需如下所示，否則會推送失敗，觸發重新推送。

    響應範例

    {
  "code" : 0,
  "msg" : "成功"
}

    欄位說明

    名稱

    類型

    是否必選

    描述

    code

    Number

    是

    應答編碼。

    msg

    String

    否

    描述資訊。

    重新推送

    第一次推送失敗後，間隔1分鐘、5分鐘後會進行重推，直至推送成功為止。如果推送3次後仍失敗，不再重試。