すべてのプロダクト
Search

このプロダクト

    Chat App Message Service:ChatAppAudit

    ドキュメントセンター

    Chat App Message Service:ChatAppAudit

    最終更新日:Dec 25, 2025

    HTTP URL を指定して、メッセージテンプレートの審査通知を取得します。

    プロトコル仕様

    項目

    説明

    プロトコル

    HTTP + JSON

    エンコーディング方式

    UTF-8

    前提条件

    • Alibaba Cloud アカウントを登録し、AccessKey ペアを作成済みであること。 詳細については、「AccessKey ペアの作成」をご参照ください。

    • メッセージ受信確認の概要と設定を確認し、そのモード、タイプ、設定プロセスを理解していること。 その後、それに応じてメッセージ受信確認を設定します。

    リクエスト

    一度に複数の審査レポートがプッシュされる場合があります。

    リクエストの例

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

    リクエストパラメーター

    V1

    パラメーター

    タイプ

    必須

    説明

    WabaId

    String

    はい

    WhatsApp Business Account (WABA) ID。

    説明

    WABA を作成した後、Business Manager プラットフォームで WABA ID を取得します。

    TemplateCode

    String

    はい

    テンプレートコード。

    説明

    Chat App Message Service コンソールの [テンプレートデザイン] ページで取得するか、ListChatappTemplate 操作を呼び出して取得します。

    Language

    String

    はい

    テンプレート言語。

    AuditStatus

    String

    はい

    メッセージテンプレートの審査ステータス。 有効な値：

    • pass：メッセージテンプレートは承認済みです。

    • fail：メッセージテンプレートは拒否されました。

    • auditing：メッセージテンプレートは審査中です。

    • unaudit：メッセージテンプレートは審査待ちです。

    • disabled

    • paused

    Reason

    String

    いいえ

    審査が失敗した理由。

    説明

    AuditStatus の戻り値が fail の場合に値が返されます。

    V2

    説明

    V2 は、独立系ソフトウェアベンダー (ISV) が顧客の WhatsApp Business Account (WABA) と電話番号を管理する必要がある場合に使用されます。

    パラメーター

    タイプ

    必須

    説明

    WabaId

    String

    はい

    WABA ID。

    説明

    WABA を作成した後、Business Manager プラットフォームで WABA ID を取得します。

    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: 電話番号の品質評価が変更されます。

      • 緑：高品質

      • 黄：中品質

      • 赤：低品質

      • 不明：不明

    • wabaReviewUpdate：WABA の審査ステータスが変更されます。

    • wabaAccountUpdate：WABA が変更されます。

    • templateCategoryUpdate：メッセージテンプレートのタイプが変更されます。

    • templateQualityUpdate：メッセージテンプレートの品質評価が変更されます。

    説明

    Type の戻り値が template の場合、V2 の審査レポートのパラメーターは V1 の審査レポートのパラメーターと同じです。

    PhoneNumber

    String

    いいえ

    電話番号。

    説明

    • Type の戻り値が phoneNameUpdate、phoneQualityUpdate、または wabaAccountUpdate の場合、PhoneNumber の値が返されます。

    • Type の戻り値が wabaReviewUpdate または template の場合、PhoneNumber の値は返されません。

    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 Platform のポリシーに違反した場合、WABA は制限されます。 有効な値：

        • RESTRICTED_BIZ_INITIATED_MESSAGING：WABA は、ビジネス主導のメッセージを送信できません。

        • RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION：WABA は、新しい電話番号を追加できません。

        • RESTRICTED_CUSTOMER_INITIATED_MESSAGING：WABA は、顧客主導のメッセージを送信できません。

      • ACCOUNT_VIOLATION：WABA はポリシーに違反しました。

      • PHONE_NUMBER_ADDED：電話番号が WABA に追加されました。

      • PHONE_NUMBER_REMOVED：電話番号が WABA から削除されました。

      • BUSINESS_VERIFICATION_STATUS_UPDATE: Meta の Business Manager プラットフォームにおける企業の認証ステータスが更新されます。

        • BUSINESS_VERIFIED：企業は承認済みです。

        • BUSINESS_REJECTED：企業は拒否済みです。

        • MORE_INFORMATION_REQUESTED：企業は追加情報を提供する必要があります。

        • BUSINESS_REVOKED：企業が審査申請を取り消しました。

      • ACCOUNT_DELETED：WABA は削除されました。

    • Type の戻り値が wabaReviewUpdate の場合の有効な値：

      • APPROVED：WABA は承認済みです。

      • REJECTED：WABA は拒否されました。

    • Type の戻り値が template の場合、このパラメーターの値は返されません。

    CurrentLimit

    String

    いいえ

    電話番号が 1 日に送信できるメッセージの最大数。

    説明

    • Type の戻り値が phoneQualityUpdate の場合の有効な値：

      • TIER_50

      • TIER_250

      • TIER_1K

      • TIER_10K

      • TIER_100K

      • TIER_UNLIMITED

      • TIER_UN_SET

    • Type の戻り値が template、phoneNameUpdate、wabaReviewUpdate、wabaAccountUpdate、templateCategoryUpdate、または templateQualityUpdate の場合、このパラメーターの値は返されません。

    応答

    コールバックの受信を確認するには、ご利用のエンドポイントが 3 秒以内に HTTP 200 ステータスコードを返す必要があります。 応答本文は、次のフォーマットの JSON オブジェクトである必要があります。 そうでない場合、システムは審査レポートのプッシュに失敗したと判断し、再度プッシュを試みます。

    応答の例

    {
  "code" : 0,
  "msg" : "Successful"
}

    応答パラメーター

    パラメーター

    タイプ

    必須

    説明

    code

    Number

    はい

    応答コード。

    msg

    String

    いいえ

    応答コードの説明。

    リトライ

    最初のプッシュ試行が失敗した場合、サービスは 1 分後、さらに 5 分後にリクエストをリトライします。 ご利用のエンドポイントが 200 以外の HTTP ステータスコードを返すか、リクエストがタイムアウトした場合、試行は失敗とみなされます。 3 回の試行が失敗した後、サービスはリトライを停止します。