Saltar al contenido principal
GET
Listar biblioteca de plantillas

Conceptos

Meta mantiene una biblioteca de plantillas ya hechas para casos de uso habituales: confirmación de pedido, aviso de entrega, código de verificación. Las plantillas creadas a partir de ella no pasan por revisión: nacen aprobadas. Este endpoint lista lo que está disponible para tu WABA.
La biblioteca la define Meta y varía según la categoría y el idioma. No puedes añadir plantillas a ella.
Para crear una plantilla normal, que sí pasa por revisión, usa Referencia de la API.

Cómo descubrir qué modelos existen

La lista es de Meta y cambia con el tiempo, así que se consulta en vez de memorizarse. El endpoint de arriba devuelve los modelos disponibles para tu WABA, y cada uno viene con su tema y su caso de uso.
En la Graph API de Meta, la búsqueda (GET /message_template_library) acepta los filtros topic, usecase, industry y language, además de search y name. Nuestra ruta hoy no reenvía esos filtros: devuelve la lista, y el filtrado es tuyo. Los valores de abajo sirven para que reconozcas el tema y el caso de uso de cada modelo que venga en la respuesta.

Temas y casos de uso

Los casos de uso que Meta publica, por tema: El nombre del modelo suele terminar en número, como delivery_update_1 o low_balance_warning_1: es el que va en library_template_name.

Crear a partir de un modelo

La creación usa el mismo endpoint de Referencia de la API, pero el cuerpo es otro: en vez de components, van el nombre del modelo y las entradas que acepta.
El texto del cuerpo es de Meta: no escribes el mensaje, solo activas o desactivas las frases que el modelo ofrece (add_contact_number, add_learn_more_link, add_security_recommendation, add_track_package_link) e informas los datos de los botones que pide.
Un modelo usado tal cual ya nace aprobado. La doc de Meta dice que personalizar cambia eso: “If you choose Customize template, your template will have to go through review before you are able to send messages.” Si cambias el contenido, vuelve a la fila normal de revisión.

Autorizaciones

Authorization
string
header
requerido

Secret Key generada en el panel de Seguridad de Omni Z-API

Parámetros de ruta

wabaId
string
requerido

ID de la WABA (obtenido con Listar WABAs)

Ejemplo:

"428083093730937"

Respuesta

Plantillas de la biblioteca

data
object[]