Una actualización de pedido necesita un texto fijo y datos específicos de la compra. Una plantilla mantiene el texto aprobado separado de valores como el número de pedido.
¿Cuándo necesito una plantilla?
Usa una plantilla aprobada cuando envíes fuera de la ventana de servicio de 24 horas del cliente.
Dentro de una ventana abierta puedes responder con contenido libre. Enviar una plantilla no reabre esa ventana por sí solo; la respuesta del cliente sí lo hace.
La aprobación no sustituye el permiso del cliente. Sigue la política de mensajería de Meta para el mensaje que pretendes enviar.
¿Qué contiene una plantilla en Bird?
Una plantilla identifica contenido reutilizable, mientras que sus versiones contienen el texto de cada idioma.
Usa el slug al enviar. El nombre visible etiqueta la plantilla, pero no es el identificador que se usa para resolver un envío.
Elige authentication, marketing o utility al crear la plantilla. Bird mantiene fijas la categoría declarada y el slug tras la creación.
El contenido de un idioma incluye un bloque body obligatorio. También puede incluir un header, footer, buttons o carousel, según las reglas de contenido de la plantilla.
Para inspeccionar el contenido aprobado, lee live_version_id de la plantilla. Después recupera el idioma de esa versión mediante el comando de idioma.
Una plantilla sin versión activa no puede enviarse. Su borrador aún puede contener contenido que no ha pasado la revisión.
¿Qué idioma y categoría usará un envío?
Consulta available_languages para los idiomas disponibles. Consulta el category del propio idioma para la clasificación de precios de Meta.
El status de la plantilla resume sus idiomas. Una plantilla active tiene al menos un idioma disponible para envío. Otro idioma puede estar rechazado, pausado o deshabilitado.
Meta puede retirar la aprobación o disponibilidad de un idioma después del lanzamiento. Comprueba el estado del idioma al enviar en lugar de mantener una lista fija del despliegue.
Meta también puede reclasificar un idioma sin cambiar la categoría que declaraste. Usa la clasificación de ese idioma con las tarifas publicadas de WhatsApp al estimar costes.
Usa ejemplos para comprobar la categoría antes de enviar un idioma a revisión:
| Contenido de ejemplo | Lección sobre la categoría prevista |
|---|---|
Your order {{reference}} has shipped. | Una actualización de transacción específica sigue el patrón de utilidad |
Your code is {{code}}. | Un mensaje de autenticación usa la categoría authentication y sus reglas de redacción |
Get 20% off your next order. | Una oferta promocional pertenece a la vía de marketing |
Mantén los ejemplos ilustrativos. Meta revisa el idioma enviado y puede clasificarlo de forma distinta a la categoría que seleccionaste.
Configura on_missing_language para decidir qué ocurre cuando el idioma solicitado no tiene texto disponible. Bird asigna por defecto fail a las plantillas nuevas de WhatsApp. Cada idioma se aprueba y tarifica por separado, así que un sustituto silencioso podría enviar contenido inesperado a una tarifa no prevista.
Esa política aún permite una etiqueta más amplia: pt puede servir una solicitud para pt-BR. No sustituye la variante hermana pt-PT.
Elige fallback solo cuando sustituir con el idioma predeterminado configurado sea aceptable para tus destinatarios. Las plantillas gestionadas por Bird mantienen su política fija de idioma ausente.
¿Cómo cambio contenido enviado?
Crea un borrador nuevo. Escribe el idioma corregido. Envía esa versión a revisión.
Bird mantiene las versiones enviadas inmutables, por lo que editar la etiqueta de la plantilla no altera el contenido aprobado del mensaje.
| Campo | Qué te indica |
|---|---|
draft_version_id | Existe un borrador sin enviar |
pending_version_id | Una versión enviada aún tiene idiomas sin resolver |
live_version_id | Esta versión proporciona el contenido usado en los envíos |
La aprobación de un idioma puede hacer que toda su versión pase a activa. Otros idiomas de esa versión pueden seguir pendientes o rechazados.
Consulta el idioma de la versión enviada para seguir una revisión. La plantilla puede seguir mostrando una versión activa anterior mientras un reemplazo espera aprobación.
¿Cómo envío una plantilla?
Indica la plantilla. Proporciona las variables que requiere el idioma que pretendes enviar.
Encuentra las plantillas disponibles con:
bird whatsapp templates listUsa bird whatsapp templates get para inspeccionar la plantilla seleccionada. Recupera el contenido de su idioma antes de construir los components del envío, que llevan los valores de las variables de esa plantilla.
En el panel, el detalle de la plantilla proporciona un ejemplo cURL con los valores de ejemplo de esa plantilla. Sustituye el destinatario, las credenciales y las variables con los valores que pretendes usar antes de enviar.
Una plantilla creada necesita un remitente en la misma cuenta de WhatsApp Business Account. Sigue el procedimiento de envío. Rastrea el identificador de mensaje devuelto mediante los eventos de entrega.
Una respuesta 202 acepta la solicitud para procesamiento. Confirma la entrega a partir del resultado posterior antes de considerar el mensaje como recibido.
En resumen
Comprueba el idioma antes de enviar.
Una plantilla activa puede contener idiomas no disponibles. Usa
available_languagespara comprobar si el idioma del destinatario puede enviarse.Consulta la categoría del idioma.
Meta puede clasificar un idioma de forma distinta a la categoría que declaraste. El precio sigue la clasificación de Meta.
Edita mediante un borrador nuevo.
Bird congela las versiones enviadas. Crea un borrador nuevo para cambiar el contenido. Envía el idioma corregido a revisión.
Envía el contenido aprobado con sus variables.
Indica la plantilla y proporciona los valores que espera su idioma. Una solicitud aceptada no garantiza la entrega.