whatsapp.template.correct_category_detection

Use whatsapp.template.correct_category_detection para processar este evento em seu endpoint de webhook.

Gatilhos

Ocorre quando a Meta detecta conteúdo que não é de utilidade (utility) no Envio Direto de Utilidade (Utility Direct Send). Inscreva-se por meio da API de endpoint de webhook. Inscreva-se em whatsapp.template.correct_category_detection ao configurar seu endpoint de webhook. Inscreva-se neste evento por meio da API de endpoint de webhook. Este evento relata a detecção de categoria para o Envio Direto de Utilidade (Utility Direct Send); use whatsapp.business_account.updated para observar restrições da conta.

Sintaxe

A YCloud envia uma solicitação HTTP POST para a URL de webhook configurada. A estrutura a seguir mostra uma variante do payload. Os valores entre colchetes angulares são marcadores de posição; seus tipos estão listados em Parâmetros. Campos opcionais e outras variantes são descritos abaixo.

{
  "id": "<ID>",
  "type": "whatsapp.template.correct_category_detection",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappTemplate": {
    "officialTemplateId": "<OFFICIAL_TEMPLATE_ID>",
    "wabaId": "<WABA_ID>",
    "name": "<NAME>",
    "language": "<LANGUAGE>",
    "category": "<CATEGORY>",
    "previousCategory": "<PREVIOUS_CATEGORY>"
  }
}

Parâmetros

Valide o cabeçalho HTTP YCloud-Signature antes de processar o corpo JSON. Consulte a validação de assinatura.

Envelope do evento

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	Sim	ID exclusivo do evento. Tamanho mínimo: `6`. Tamanho máximo: `128`.
`type`	string	Sim	Sempre `whatsapp.template.correct_category_detection`.
`apiVersion`	string	Sim	A versão da API usada para renderizar este evento.
`createTime`	string (date-time)	Sim	O momento em que este evento foi criado, formatado no padrão RFC 3339. Ex.: `2022-06-01T12:00:00.000Z`.

Payload do evento

Parâmetro	Tipo	Obrigatório	Descrição
`whatsappTemplate`	object	Não	Payload do `whatsappTemplate` específico do evento.

Os quatro campos comuns do envelope são obrigatórios. Os campos do payload dependem da variante do evento. Em cada tabela de objetos, Obrigatório se aplica quando o objeto pai correspondente estiver presente. Campos opcionais podem ser omitidos; um exemplo não torna um campo obrigatório.

whatsappTemplate

Parâmetro	Tipo	Obrigatório	Descrição
`officialTemplateId`	string	Não	ID oficial do modelo atribuído pelo WhatsApp. Este ID é usado para identificar o modelo no sistema do WhatsApp.
`wabaId`	string	Sim	ID da conta do WhatsApp Business.
`name`	string	Sim	Nome do modelo. Tamanho máximo: `512`. Padrão: `[a-z0-9]{1,512}`.
`language`	string	Sim	Código de idioma do modelo. Consulte Supported Languages para ver todos os códigos.
`category`	string	Não	Categoria de modelos do WhatsApp. `AUTHENTICATION`: permite que as empresas autentiquem usuários com senhas de uso único (OTP), potencialmente em várias etapas do processo de login (por exemplo, verificação de conta, recuperação de conta, desafios de integridade). `MARKETING`: inclui promoções ou ofertas, atualizações informativas ou convites para os clientes responderem/agirem. Qualquer conversa que não se qualifique como utilidade (utility) ou autenticação é considerada uma conversa de marketing. `UTILITY`: facilita uma solicitação ou transação específica acordada ou informa o cliente sobre uma transação em andamento, incluindo notificações pós-compra e extratos de faturamento recorrentes.
`previousCategory`	string	Não	Este campo indica a categoria anterior do modelo (ou `null`, para modelos recém-criados após 1º de abril de 2023). Compare este valor com o valor do campo `category` do modelo, que indica a categoria atual do modelo.

Exemplo

O JSON a seguir é o corpo entregue ao seu receptor. IDs, números de telefone e outros valores de conta são ilustrativos. A Meta detectou conteúdo de marketing em uma mensagem de Envio Direto de Utilidade (Utility Direct Send). Inscreva-se neste evento por meio da API de endpoint de webhook.

{
  "id": "evt_direct_send_category_123",
  "type": "whatsapp.template.correct_category_detection",
  "apiVersion": "v2",
  "createTime": "2026-09-17T08:00:00.000Z",
  "whatsappTemplate": {
    "officialTemplateId": "official-template-id",
    "wabaId": "whatsapp-business-account-id",
    "name": "auto_generated_sample",
    "language": "en_US",
    "category": "MARKETING",
    "previousCategory": "UTILITY"
  }
}

Após verificar a assinatura e aceitar o evento de forma durável, retorne uma resposta 2xx. Processe tarefas demoradas de forma assíncrona.

HTTP/1.1 200 OK

Para orientações passo a passo dos cenários, consulte exemplos anotados.

Primeiros passos

Guias

Endpoints

Webhook reference

whatsapp.template.correct_category_detection

Gatilhos

Sintaxe

Parâmetros

Envelope do evento

Payload do evento

whatsappTemplate

Exemplo

​Gatilhos

​Sintaxe

​Parâmetros

​Envelope do evento

​Payload do evento

​whatsappTemplate

​Exemplo

Gatilhos

Sintaxe

Parâmetros

Envelope do evento

Payload do evento

whatsappTemplate

Exemplo