Índice:
- Introducción
- Qué puedes consultar
- Endpoint de la API
- Principales campos de la respuesta
- Cómo identificar plantillas recategorizadas
- Relación con el Portal Blip
- 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:
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. 😃