Cómo consultar plantillas e identificar recategorización vía API – Blip | Blip Help

Índice:

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:

Campo	Descripción
category	Categoría actual de la plantilla (ej: MARKETING, UTILITY)
previous_category	Categoría anterior antes de la recategorización
status	Estado de la plantilla (ej: APPROVED)
language	Idioma de la plantilla
components	Contenido del mensaje (body, variables, etc.)

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:

category	previous_category	Interpretación
MARKETING	UTILITY	La plantilla fue recategorizada
MARKETING	null	La plantilla no fue recategorizada

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