Templates de WhatsApp¶
Introducción¶
Los templates o plantillas de WhatsApp son mensajes preaprobados por Meta que permiten iniciar conversaciones con los clientes fuera de la ventana de 24 horas o enviar comunicaciones estructuradas (ejemplo: confirmaciones, recordatorios, encuestas).
Kewbot se conecta directamente a la API de Meta para sincronizar estos templates y permitir su uso en campañas, agentes y flujos automatizados.
Beneficios principales¶
- Rapidez: Los agentes y campañas utilizan mensajes predefinidos sin tener que escribirlos manualmente.
- Cumplimiento: Solo se usan mensajes aprobados por Meta, garantizando cumplimiento de políticas.
- Flexibilidad: Se pueden incluir variables dinámicas, botones interactivos y contenido multimedia.
- Automatización: Los botones pueden asociarse a destinos dentro del flujo de comunicación en Kewbot.
- Pruebas previas: Antes de lanzar una campaña, se puede enviar un test al propio número para verificar la apariencia final.
Las tres formas de enviar un template¶
Un mismo template puede enviarse por tres caminos distintos, y en cada uno los valores de las variables se obtienen de forma diferente:
| Camino | Origen de las variables |
|---|---|
| Campaña saliente | Columnas del archivo CSV cargado en la campaña. |
| Agente | El agente completa cada variable a mano antes de enviar. |
| Flujo (GOTO) | Se toman automáticamente de la conversación, según la configuración del template. |
En los dos primeros casos hay una persona o un archivo que aporta los datos. En el flujo no hay nadie: el envío es automático, por lo que las variables deben configurarse previamente en el template. Eso se explica más abajo, en Parámetros para envío desde flujo.
Listado¶
La página principal muestra todos los templates sincronizados:
- Nombre: Nombre del template tal como fue creado en Meta.
- Idioma: Idioma definido para el template.
- Estado: Puede ser APPROVED, REJECTED o PENDING.
- Categoría: Puede ser UTILITY (utilidad) o MARKETING.
- Última actualización: Fecha de la última sincronización con Meta.
- Flujo: Indica si el template puede usarse como destino dentro de un flujo:
- 🟢 Sin parámetros — no tiene variables, se puede usar tal cual.
- 🔵 Configurado — tiene variables y ya están configuradas.
- ⚪ Incompleto — tiene variables sin configurar. No aparece como opción al elegir destinos en los flujos.
- Acciones:
- 🔎 Ver detalle: Muestra toda la información del template.
- 🔄 Editar destino de botones: Configura los botones (si existen) hacia destinos de Kewbot.
- 📤 Enviar test: Permite enviar una prueba del template a un número específico.
👉 Cada vez que se realice un cambio en Meta, es necesario hacer clic en Sincronizar con Meta para actualizar la lista.
Detalle de Template¶
En el detalle se visualizan los elementos principales:
- Nombre: Identificador único del template.
- Idioma: Idioma del template.
- Estado: Estado actual en Meta (APPROVED, REJECTED, PENDING).
- Categoría: Tipo de template (ejemplo: marketing, utilidad).
- Header: Encabezado opcional, puede ser texto o multimedia.
- Body: Cuerpo principal del mensaje, admite variables dinámicas ({{1}}, {{2}}, etc.).
- Footer: Texto de pie de página.
- Botones: Si existen, se muestran en formato JSON.
- Vista previa dinámica: Muestra cómo verá el cliente el mensaje en WhatsApp, con variables y botones.
Configuración de flujo del template¶
Esta pantalla define cómo se comporta el template cuando se usa dentro de un flujo de Kewbot.
Auto-avance¶
Determina qué ocurre inmediatamente después de enviar el template:
- Sin destino (Template interactivo): el flujo queda esperando la respuesta del cliente. Se aplican los controles de timeout y de respuesta inválida.
- Con destino (Template informativo): el flujo continúa automáticamente hacia el destino elegido, sin esperar respuesta. Se usa cuando el template solo informa algo y la conversación debe seguir su curso.
Destino si la respuesta no coincide con botones¶
Se ejecuta cuando el cliente responde con texto libre en lugar de presionar un botón del template. Ver Contexto de template para el detalle.
Destinos de botones¶
Si el template incluye botones de respuesta rápida, cada uno puede derivar a un destino distinto del flujo.
Ejemplo:
- Botón Sí → derivar a un anuncio o regla de campaña.
- Botón No → enviar a un mensaje de agradecimiento o flujo alternativo.
Esto permite que los templates de WhatsApp no sean solo mensajes estáticos, sino puntos interactivos dentro del flujo conversacional.
⚠️ Los destinos de botones se comparten entre todos los templates de la empresa que tengan un botón con el mismo texto. Si se cambia el destino de un botón "Sí", el cambio afecta a todos los templates que usen ese mismo texto.
Parámetros para envío desde flujo¶
Si el template tiene variables, esta sección define de dónde se toma el valor de cada una cuando el envío se dispara desde un flujo.
⚠️ Esta configuración se aplica solo al envío desde flujo. Las campañas siguen tomando los valores del CSV y los agentes los siguen completando a mano. Cambiar esta configuración no afecta a ninguno de esos dos caminos.
Variables disponibles¶
| Variable | Descripción |
|---|---|
_NAME |
Nombre del contacto registrado en el PhoneBook. |
_PHONE_NUMBER |
Número de teléfono del contacto. |
_ATTR.xxxx |
Atributo personalizado del PhoneBook, donde xxxx es el nombre de la clave. |
[[variable]] |
Variable de la conversación, generada por un nodo anterior del flujo (una entrada de datos, una consulta a un sistema externo, etc.). |
Se pueden combinar con texto fijo. Por ejemplo, Estimado _NAME produce Estimado Martínez, Roberto.
Valor por defecto¶
Cada parámetro necesita además un valor por defecto, que se usa cuando la variable no tiene contenido en el momento del envío.
Esto es necesario porque WhatsApp rechaza los mensajes con parámetros vacíos. Sin valor por defecto, el template no se enviaría y el cliente no recibiría nada.
El valor por defecto reemplaza al parámetro completo, no solo a la parte que falta. Si la expresión es
_NAME de _ATTR.empresay el contacto no tiene el atributo empresa cargado, se envía el valor por defecto entero, no un texto a medias.
Responsabilidad del diseño del flujo¶
Kewbot no puede verificar de antemano si una variable de conversación va a existir cuando el flujo llegue al template. Es responsabilidad de quien diseña el flujo asegurarse de que los nodos previos hayan generado esas variables.
Si no existen, el envío se realiza igual usando los valores por defecto.
Botones con URL dinámica¶
Algunos templates tienen un botón cuya dirección web se completa parcialmente en cada envío. En esos casos la pantalla muestra la parte fija de la dirección, que no se puede modificar, y un campo para el valor que se agrega al final.
⚠️ Solo debe cargarse la parte variable. Si se pega la dirección completa, el enlace queda duplicado y no funciona.
Templates con documento o video¶
Si el template tiene un documento o un video en el encabezado, la dirección del archivo también es un parámetro y debe configurarse.
El archivo tiene que estar en una dirección accesible públicamente, porque WhatsApp necesita descargarlo al momento del envío.
Templates no disponibles para flujo¶
Un template queda marcado como Incompleto y no aparece como opción al elegir un destino cuando:
- tiene parámetros sin configurar, o sin valor por defecto;
- tiene una variable en el encabezado de texto (no soportado).
Una vez completada la configuración, el estado pasa a Configurado y el template queda disponible en los selectores de destino de todos los módulos.
Cambios hechos en Meta¶
Si el template se modifica en Meta y se agrega una variable nueva, al sincronizar con Meta el sistema detecta que falta configurarla y el template vuelve automáticamente al estado Incompleto, hasta que se complete el parámetro nuevo.
Envío de Prueba¶
Antes de usar un template en producción (campañas o agentes), se puede enviar un test:
- Al hacer clic en Enviar test, se abre un pop-up solicitando el número de destino (con código de país, sin “+”).
- Si el envío es exitoso, el número indicado recibe el mensaje exactamente como lo verá un cliente final.
Esto asegura que el contenido, formato y variables se visualicen correctamente.
Notas y Ejemplos¶
- Los templates deben crearse y aprobarse en Meta. Kewbot solo los sincroniza y los hace utilizables.
- Es recomendable probar cada template con el envío de test antes de incluirlo en campañas.
- Ejemplo de uso:
- Template sample_issue_resolution: pregunta si el cliente resolvió un problema.
- Botón “Sí” → redirige a un flujo de campañas salientes.
- Botón “No” → redirige a un anuncio de agradecimiento.
- La configuración de parámetros de flujo se ignora en campañas y en el envío desde agente.
- Después de modificar un template en Meta, siempre hay que sincronizar y revisar que el estado de Flujo siga siendo el esperado.
- Ejemplo de uso en flujo:
- Template recordatorio_visita: informa fecha y hora de una visita técnica.
- Parámetro nombre →
_NAME, por defecto Estimado cliente. - Parámetro fecha →
[[fecha_visita]], generada por una consulta a un sistema externo previa en el flujo.