Todos los productos
Search

Este producto

    Chat App Message Service:ChatAppAudit

    Centro de documentos

    Chat App Message Service:ChatAppAudit

    Última actualización: Sep 05, 2026

    Configure una URL de callback HTTP para recibir notificaciones sobre el estado de revisión de las plantillas de mensajes.

    Especificación del protocolo

    Elemento

    Descripción

    Protocolo

    HTTP + JSON

    Método de codificación

    UTF-8

    Requisitos previos

    Solicitud

    Es posible que se envíen varios informes de revisión simultáneamente.

    Ejemplo de solicitud

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

    Parámetros de la solicitud

    V1

    Parámetro

    Tipo

    Obligatorio

    Descripción

    WabaId

    String

    Sí

    ID de la cuenta de WhatsApp Business (WABA).

    Nota

    Después de crear una WABA, obtenga su ID en la plataforma Business Manager.

    TemplateCode

    String

    Sí

    Código de la plantilla.

    Nota

    Obtenga el código de la plantilla en la página Template Design de la consola de Chat App Message Service o mediante la operación ListChatappTemplate.

    Language

    String

    Sí

    Idioma de la plantilla.

    AuditStatus

    String

    Sí

    Estado de revisión de la plantilla de mensajes. Valores válidos:

    • pass: La plantilla de mensajes fue aprobada.

    • fail: La plantilla de mensajes fue rechazada.

    • auditing: La plantilla de mensajes se encuentra en revisión.

    • unaudit: La plantilla de mensajes está pendiente de revisión.

    • disabled

    • paused

    Reason

    String

    No

    Motivo del rechazo en la revisión.

    Nota

    Se devuelve un valor cuando el valor de retorno de AuditStatus es fail.

    V2

    Nota

    Utilice la versión V2 cuando el proveedor de software independiente (ISV) gestione las cuentas de WhatsApp Business (WABA) y los números telefónicos de sus clientes.

    Parámetro

    Tipo

    Obligatorio

    Descripción

    WabaId

    String

    Sí

    ID de la WABA.

    Nota

    Después de crear una WABA, obtenga su ID en la plataforma Business Manager.

    TemplateCode

    String

    Sí

    Código de la plantilla.

    Nota

    Obtenga el código de la plantilla en la página Template Design de la consola de Chat App Message Service o mediante la operación ListChatappTemplate.

    Language

    String

    Sí

    Idioma de la plantilla.

    AuditStatus

    String

    Sí

    Estado de revisión de la plantilla de mensajes. Valores válidos:

    • pass: La plantilla de mensajes fue aprobada.

    • fail: La plantilla de mensajes fue rechazada.

    • auditing: La plantilla de mensajes se encuentra en revisión.

    • unaudit: La plantilla de mensajes está pendiente de revisión.

    • disabled

    • paused

    Reason

    String

    No

    Motivo del rechazo en la revisión.

    Nota

    Se devuelve un valor cuando el valor de retorno de AuditStatus es fail.

    Type

    String

    Sí

    Tipo de notificación. Valores válidos:

    • template: Cambio en el estado de la plantilla de mensajes.

    • phoneNameUpdate: Cambio en el estado del nombre asociado al número telefónico.

    • phoneQualityUpdate: Cambio en la calificación de calidad del número telefónico.

      • GREEN: Alta calidad

      • YELLOW: Calidad media

      • RED: Baja calidad

      • UNKNOWN: Desconocida

    • wabaReviewUpdate: Cambio en el estado de revisión de la WABA.

    • wabaAccountUpdate: Modificación en la WABA.

    • templateCategoryUpdate: Cambio en el tipo de la plantilla de mensajes.

    • templateQualityUpdate: Cambio en la calificación de calidad de la plantilla de mensajes.

    Nota

    Si el valor de retorno de Type es template, los parámetros del informe de revisión de V2 coinciden con los del informe de revisión de V1.

    PhoneNumber

    String

    No

    Número telefónico.

    Nota

    • Si el valor de retorno de Type es phoneNameUpdate, phoneQualityUpdate o wabaAccountUpdate, se devuelve un valor para PhoneNumber.

    • Si el valor de retorno de Type es wabaReviewUpdate o template, no se devuelve ningún valor para PhoneNumber.

    Status

    String

    No

    Estado.

    Nota

    • Valores válidos cuando el valor de retorno de Type es phoneNameUpdate:

      • APPROVED: El nombre del número telefónico fue aprobado.

      • REJECTED: El nombre del número telefónico fue rechazado.

      • DEFERRED: Se pospuso la revisión del nombre del número telefónico.

    • Valores válidos cuando el valor de retorno de Type es phoneQualityUpdate. Estos valores indican los motivos por los que cambió la calificación de calidad del número telefónico.

      • ONBOARDING: El número telefónico se encuentra en proceso de registro.

      • UPGRADE: Aumentó la cantidad de mensajes que puede enviar el número telefónico.

      • DOWNGRADE: Disminuyó la cantidad de mensajes que puede enviar el número telefónico.

      • FLAGGED: Se agregó una etiqueta al número telefónico.

      • UNFLAGGED: Se eliminó una etiqueta del número telefónico.

    • Valores válidos cuando el valor de retorno de Type es wabaAccountUpdate:

      • DISABLED_UPDATE:

        • SCHEDULE_FOR_DISABLE: La WABA está bloqueada.

        • DISABLE: La WABA está deshabilitada.

        • REINSTATE: Se eliminó el bloqueo de la WABA.

      • VERIFIED_ACCOUNT: La WABA está verificada.

      • ACCOUNT_RESTRICTION: Si una WABA infringe una directiva de la plataforma WhatsApp Business, se aplica una restricción a la cuenta. Valores válidos:

        • RESTRICTED_BIZ_INITIATED_MESSAGING: La WABA no tiene permiso para enviar mensajes iniciados por la empresa.

        • RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION: La WABA no tiene permiso para agregar nuevos números telefónicos.

        • RESTRICTED_CUSTOMER_INITIATED_MESSAGING: La WABA no tiene permiso para enviar mensajes iniciados por el cliente.

      • ACCOUNT_VIOLATION: La WABA infringió una directiva.

      • PHONE_NUMBER_ADDED: Se agregó un número telefónico a la WABA.

      • PHONE_NUMBER_REMOVED: Se eliminó un número telefónico de la WABA.

      • BUSINESS_VERIFICATION_STATUS_UPDATE: Se actualizó el estado de verificación de la empresa en la plataforma Business Manager de Meta.

        • BUSINESS_VERIFIED: La empresa fue aprobada.

        • BUSINESS_REJECTED: La empresa fue rechazada.

        • MORE_INFORMATION_REQUESTED: La empresa debe proporcionar más información.

        • BUSINESS_REVOKED: La empresa revocó la solicitud de revisión.

      • ACCOUNT_DELETED: La WABA fue eliminada.

    • Valores válidos cuando el valor de retorno de Type es wabaReviewUpdate:

      • APPROVED: La WABA fue aprobada.

      • REJECTED: La WABA fue rechazada.

    • No se devuelve ningún valor para este parámetro cuando el valor de retorno de Type es template.

    CurrentLimit

    String

    No

    Cantidad máxima de mensajes que el número telefónico puede enviar por día.

    Nota

    • Valores válidos cuando el valor de retorno de Type es phoneQualityUpdate:

      • TIER_50

      • TIER_250

      • TIER_1K

      • TIER_10K

      • TIER_100K

      • TIER_UNLIMITED

      • TIER_UN_SET

    • No se devuelve ningún valor para este parámetro cuando el valor de retorno de Type es template, phoneNameUpdate, wabaReviewUpdate, wabaAccountUpdate, templateCategoryUpdate o templateQualityUpdate.

    Respuesta

    Su endpoint debe devolver un código de estado HTTP 200 en un plazo máximo de 3 segundos. El cuerpo de la respuesta debe ser un objeto JSON con el formato a continuación. De lo contrario, el sistema considera que el envío falló y lo reintenta.

    Ejemplo de respuesta

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

    Parámetros de la respuesta

    Parámetro

    Tipo

    Obligatorio

    Descripción

    code

    Number

    Sí

    Código de respuesta.

    msg

    String

    No

    Descripción del código de respuesta.

    Reintentos

    Si falla el intento inicial de envío, el servicio reintenta la solicitud después de 1 minuto y nuevamente tras 5 minutos. Un intento se considera con errores si su endpoint devuelve un código de estado HTTP distinto de 200 o si la solicitud excede el tiempo de espera. Después de tres intentos con errores, el servicio deja de reintentar.