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

> Se produce cuando Meta detecta contenido que no es de utilidad en Utility Direct Send. Suscríbete mediante la API de endpoint de webhook.

Usa `whatsapp.template.correct_category_detection` para gestionar este evento en tu endpoint de webhook.

## Disparadores

Se produce cuando Meta detecta contenido que no es de utilidad en Utility Direct Send. Suscríbete mediante la API de endpoint de webhook.

Suscríbete a `whatsapp.template.correct_category_detection` cuando [configures tu endpoint de webhook](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md).

Suscríbete a este evento mediante la API de endpoint de webhook. Este evento informa sobre la detección de categorías para Utility Direct Send; usa `whatsapp.business_account.updated` para observar las restricciones de la cuenta.

## Sintaxis

YCloud envía una solicitud HTTP `POST` a tu URL de webhook configurada. La siguiente estructura muestra una variante de carga útil. Los valores entre corchetes angulares son marcadores de posición; sus tipos se indican en **Parámetros**. Los campos opcionales y otras variantes se describen a continuación.

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

Valida el encabezado HTTP `YCloud-Signature` antes de procesar el cuerpo JSON. Consulta la [validación de firma](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md).

### Envoltorio del evento

| Parámetro | Tipo | Requerido | Descripción |
| - | - | - | - |
| `id` | string | Sí | ID único para el evento. Longitud mínima: `6`. Longitud máxima: `128`. |
| `type` | string | Sí | Siempre `whatsapp.template.correct_category_detection`. |
| `apiVersion` | string | Sí | La versión de la API utilizada para representar este evento. |
| `createTime` | string (date-time) | Sí | La hora a la que se creó este evento, formateada en [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). P. ej., `2022-06-01T12:00:00.000Z`. |

### Carga útil del evento

| Parámetro | Tipo | Requerido | Descripción |
| - | - | - | - |
| `whatsappTemplate` | object | No | Carga útil de `whatsappTemplate` específica del evento. |

Los cuatro campos comunes del envoltorio son requeridos. Los campos de la carga útil dependen de la variante del evento. En cada tabla de objetos, **Requerido** se aplica cuando su objeto principal está presente. Los campos opcionales se pueden omitir; una muestra no hace que un campo sea obligatorio.

#### whatsappTemplate

| Parámetro | Tipo | Requerido | Descripción |
| - | - | - | - |
| `officialTemplateId` | string | No | ID oficial de la plantilla asignado por WhatsApp. Este ID se utiliza para identificar la plantilla en el sistema de WhatsApp. |
| `wabaId` | string | Sí | ID de la cuenta de WhatsApp Business. |
| `name` | string | Sí | Nombre de la plantilla.Longitud máxima: `512`. Patrón: `[a-z0-9]{1,512}`. |
| `language` | string | Sí | Código de idioma de la plantilla. Consulta [Supported Languages](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages) para ver todos los códigos. |
| `category` | string | No | Categoría de plantillas de WhatsApp.<ul><li>`AUTHENTICATION`: Permite a las empresas autenticar a los usuarios con códigos de acceso de un solo uso, potencialmente en varios pasos del proceso de inicio de sesión (p. ej., verificación de cuenta, recuperación de cuenta, desafíos de integridad).</li><li>`MARKETING`: Incluye promociones u ofertas, actualizaciones informativas o invitaciones para que los clientes respondan o realicen una acción. Cualquier conversación que no califique como de utilidad o autenticación es una conversación de marketing.</li><li>`UTILITY`: Facilita una solicitud o transacción específica y acordada, o una actualización para un cliente sobre una transacción en curso, incluidas las notificaciones posteriores a la compra y los resúmenes de facturación periódicos.</li></ul> |
| `previousCategory` | string | No | Este campo indica la categoría anterior de la plantilla (o `null`, para las plantillas recién creadas después del 1 de abril de 2023). Compara este valor con el valor del campo `category` de la plantilla, que indica su categoría actual. |

## Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos.

Meta detectó contenido de marketing en un mensaje de Utility Direct Send. Suscríbete a este evento mediante la 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"
  }
}
```

Después de verificar la firma y aceptar el evento de forma duradera, devuelve una respuesta `2xx`. Procesa las tareas lentas de forma asíncrona.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

Para ver ejemplos prácticos de situaciones, consulta los [ejemplos comentados](https://docs.ycloud.com/es/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.