Todos os produtos
Search

Este produto

    Chat App Message Service:ChatAppAudit

    Central de documentação

    Chat App Message Service:ChatAppAudit

    Última atualização: Jun 28, 2026

    Configure uma URL de callback HTTP para receber notificações sobre o status de revisão dos modelos de mensagem.

    Especificação do protocolo

    Item

    Descrição

    Protocolo

    HTTP + JSON

    Método de codificação

    UTF-8

    Pré-requisitos

    Solicitação

    O sistema pode enviar vários relatórios de revisão simultaneamente via push.

    Exemplo de solicitação

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

    Parâmetros da solicitação

    V1

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    WabaId

    String

    Sim

    ID da WhatsApp Business Account (WABA).

    Nota

    Após criar uma WABA, obtenha o ID na plataforma Business Manager.

    TemplateCode

    String

    Sim

    Código do modelo.

    Nota

    Obtenha o código do modelo na página Template Design no console do Chat App Message Service ou chame a operação ListChatappTemplate.

    Language

    String

    Sim

    Idioma do modelo.

    AuditStatus

    String

    Sim

    Status de revisão do modelo de mensagem. Valores válidos:

    • pass: Modelo de mensagem aprovado.

    • fail: Modelo de mensagem rejeitado.

    • auditing: Modelo de mensagem em revisão.

    • unaudit: Modelo de mensagem pendente de revisão.

    • disabled

    • paused

    Reason

    String

    Não

    Motivo da falha na revisão.

    Nota

    Este valor é retornado quando AuditStatus for fail.

    V2

    Nota

    Use a V2 quando o fornecedor independente de software (ISV) gerenciar as contas do WhatsApp Business (WABAs) e os números de telefone dos clientes.

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    WabaId

    String

    Sim

    ID da WABA.

    Nota

    Após criar uma WABA, obtenha o ID na plataforma Business Manager.

    TemplateCode

    String

    Sim

    Código do modelo.

    Nota

    Obtenha o código do modelo na página Template Design no console do Chat App Message Service ou chame a operação ListChatappTemplate.

    Language

    String

    Sim

    Idioma do modelo.

    AuditStatus

    String

    Sim

    Status de revisão do modelo de mensagem. Valores válidos:

    • pass: Modelo de mensagem aprovado.

    • fail: Modelo de mensagem rejeitado.

    • auditing: Modelo de mensagem em revisão.

    • unaudit: Modelo de mensagem pendente de revisão.

    • disabled

    • paused

    Reason

    String

    Não

    Motivo da falha na revisão.

    Nota

    Este valor é retornado quando AuditStatus for fail.

    Type

    String

    Sim

    Tipo de notificação. Valores válidos:

    • template: Alteração no status do modelo de mensagem.

    • phoneNameUpdate: Alteração no status do nome do número de telefone.

    • phoneQualityUpdate: Alteração na classificação de qualidade do número de telefone.

      • GREEN: Alta qualidade

      • YELLOW: Qualidade média

      • RED: Baixa qualidade

      • UNKNOWN: Desconhecido

    • wabaReviewUpdate: Alteração no status de revisão da WABA.

    • wabaAccountUpdate: Alteração na WABA.

    • templateCategoryUpdate: Alteração no tipo do modelo de mensagem.

    • templateQualityUpdate: Alteração na classificação de qualidade do modelo de mensagem.

    Nota

    Se Type retornar template, os parâmetros do relatório de revisão V2 serão idênticos aos do relatório V1.

    PhoneNumber

    String

    Não

    Número de telefone.

    Nota

    • Se Type retornar phoneNameUpdate, phoneQualityUpdate ou wabaAccountUpdate, PhoneNumber conterá um valor.

    • Se Type retornar wabaReviewUpdate ou template, PhoneNumber não terá valor.

    Status

    String

    Não

    Status.

    Nota

    • Valores válidos quando Type for phoneNameUpdate:

      • APPROVED: Nome do número de telefone aprovado.

      • REJECTED: Nome do número de telefone rejeitado.

      • DEFERRED: Revisão do nome do número de telefone adiada.

    • Valores válidos quando Type for phoneQualityUpdate. Indicam os motivos da alteração na classificação de qualidade do número de telefone.

      • ONBOARDING: Número de telefone em registro.

      • UPGRADE: Aumento no limite de mensagens enviáveis pelo número.

      • DOWNGRADE: Redução no limite de mensagens enviáveis pelo número.

      • FLAGGED: Tag adicionada ao número de telefone.

      • UNFLAGGED: Tag removida do número de telefone.

    • Valores válidos quando Type for wabaAccountUpdate:

      • DISABLED_UPDATE:

        • SCHEDULE_FOR_DISABLE: WABA bloqueada.

        • DISABLE: WABA desativada.

        • REINSTATE: Bloqueio da WABA removido.

      • VERIFIED_ACCOUNT: WABA verificada.

      • ACCOUNT_RESTRICTION: Restrição aplicada à WABA por violação de política da WhatsApp Business Platform. Valores válidos:

        • RESTRICTED_BIZ_INITIATED_MESSAGING: Envio de mensagens iniciadas pela empresa proibido.

        • RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION: Adição de novos números de telefone proibida.

        • RESTRICTED_CUSTOMER_INITIATED_MESSAGING: Envio de mensagens iniciadas pelo cliente proibido.

      • ACCOUNT_VIOLATION: WABA violou uma política.

      • PHONE_NUMBER_ADDED: Número de telefone adicionado à WABA.

      • PHONE_NUMBER_REMOVED: Número de telefone removido da WABA.

      • BUSINESS_VERIFICATION_STATUS_UPDATE: Status de verificação da empresa atualizado na plataforma Business Manager da Meta.

        • BUSINESS_VERIFIED: Empresa aprovada.

        • BUSINESS_REJECTED: Empresa rejeitada.

        • MORE_INFORMATION_REQUESTED: Mais informações necessárias para a empresa.

        • BUSINESS_REVOKED: Solicitação de revisão revogada pela empresa.

      • ACCOUNT_DELETED: WABA excluída.

    • Valores válidos quando Type for wabaReviewUpdate:

      • APPROVED: WABA aprovada.

      • REJECTED: WABA rejeitada.

    • Nenhum valor é retornado para este parâmetro quando Type for template.

    CurrentLimit

    String

    Não

    Limite diário máximo de mensagens para o número de telefone.

    Nota

    • Valores válidos quando Type for phoneQualityUpdate:

      • TIER_50

      • TIER_250

      • TIER_1K

      • TIER_10K

      • TIER_100K

      • TIER_UNLIMITED

      • TIER_UN_SET

    • Nenhum valor é retornado para este parâmetro quando Type for template, phoneNameUpdate, wabaReviewUpdate, wabaAccountUpdate, templateCategoryUpdate ou templateQualityUpdate.

    Resposta

    O endpoint deve retornar um código de status HTTP 200 em até 3 segundos. O corpo da resposta deve ser um objeto JSON no formato a seguir. Caso contrário, o sistema considera o push como falho e tenta novamente.

    Exemplo de resposta

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

    Parâmetros da resposta

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    code

    Number

    Sim

    Código da resposta.

    msg

    String

    Não

    Descrição do código da resposta.

    Novas tentativas

    Se a tentativa inicial de push falhar, o serviço tentará novamente após 1 minuto e, depois, após 5 minutos. Uma tentativa falha se o endpoint retornar um código de status HTTP diferente de 200 ou se a solicitação atingir o tempo limite. Após três falhas consecutivas, o serviço interrompe as novas tentativas.