Cómo consultar plantillas e identificar recategorización vía API

Índice:

1. Introducción
2. Qué puedes consultar
3. Endpoint de la API
4. Principales campos de la respuesta
5. Cómo identificar plantillas recategorizadas
6. Relación con el Portal Blip
7. Buenas prácticas

Introducción

Con la evolución de las políticas de Meta, es común que las plantillas de mensajes pasen por recategorización automática (por ejemplo, de Utility a Marketing).

Pensando en ello, Blip ofrece una forma de consultar esta información vía API, permitiéndote tener mayor control y visibilidad — similar a lo que ya se muestra en el Portal.

Qué puedes consultar

A través de la API, es posible obtener:

• Categoría actual de la plantilla (category)

• Categoría anterior (previous_category)

• Estado de la plantilla (ej: APPROVED)

• Idioma

• Contenido del mensaje

• Indicación de si la plantilla fue recategorizada

Reglas importantes:

• Si el campo previous_category está заполнado, significa que la plantilla fue recategorizada.

• Para optimizar la consulta, es posible filtrar por el nombre de la plantilla usando el parámetro templateName, reemplazando la variable TEMPLATE_NAME en el ejemplo. Este parámetro es opcional y representa el nombre de la plantilla que deseas buscar.
   

Endpoint de la API

Request:

{
  "id": "{{$guid}}",
  "to": "postmaster@wa.gw.msging.net",
  "method": "get",
  "uri": "/message-templates-enriched?templateName={TEMPLATE_NAME}"
}

Principales campos de la respuesta

La respuesta de la API devuelve una lista de plantillas con diversa información. A continuación, los campos más relevantes para el análisis de recategorización:

Ejemplo de respuesta:

{
  "id": "2840164927483649",
  "category": "MARKETING",
  "components": [
    {
      "type": "BODY",
      "text": "Olá, {{1}}! ..."
    }
  ]
  "language": "pt_BR",
  "last_updated_time": "2026-03-20T20:25:51.000Z",
  "name”: “eventos_conversas”,
  “rejected_reason”: “NONE”,
  "status": "APPROVED",
  "previous_category": "UTILITY",
}

Cómo identificar plantillas recategorizadas

Para identificar si una plantilla fue recategorizada:

• Verifica si el campo previous_category existe y está заполнado

• Compáralo con el campo category

Ejemplo:

Relación con el Portal Blip

En el Portal, esta información aparece en la lista de plantillas:

• “Recategorized” = Yes → previous_category completado

• “Recategorized” = No → previous_category vacío

Es decir, la API replica exactamente la misma lógica mostrada en la interfaz.

Buenas prácticas

• Monitorea plantillas recategorizadas para evitar impactos en costos y entrega;

• Revisa contenidos que puedan ser interpretados como marketing;

• Crea alertas internas basadas en el campo previous_category;

• Utiliza esta consulta para auditoría y gobernanza de plantillas.

   

¡Importante!

Actualmente, Blip notifica por correo electrónico a todos los usuarios administradores de los bots que están vinculados a la WABA del template cada vez que ocurre un cambio en la categoría de las plantillas. Más información aquí.

Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃