> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# whatsapp.template.correct_category_detection

> 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.

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](https://docs.ycloud.com/pt/api-reference/guides/api-fundamentals/configure-webhooks.md).

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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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](https://docs.ycloud.com/pt/api-reference/guides/api-fundamentals/configure-webhooks.md).

### 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](https://datatracker.ietf.org/doc/html/rfc3339). 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages) para ver todos os códigos. |
| `category` | string | Não | Categoria de modelos do WhatsApp.<ul><li>`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).</li><li>`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.</li><li>`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.</li></ul> |
| `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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

Para orientações passo a passo dos cenários, consulte [exemplos anotados](https://docs.ycloud.com/pt/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.