Registro e importación de plantillas de WhatsApp
Cómo crear un modelo de mensaje (plantilla) en Meta Business, esperar la aprobación e importarlo a Quaza, mapeando las variables del sistema (nombre del cliente, valor, vencimiento, enlace del boleto). Las plantillas son obligatorias para iniciar conversación fuera de la ventana de 24h — es lo que permite disparar factura, aviso de vencimiento y aviso de atraso por la API Oficial.
Cuándo usar plantillas
En WhatsApp, tras 24h sin que el cliente responda, la empresa solo puede iniciar contacto con un mensaje modelo aprobado por Meta — la plantilla. Así dispara Quaza los avisos automáticos. Los mensajes libres solo valen dentro de la ventana de 24h después de que el cliente escribe.
| Necesita plantilla |
No necesita |
| Aviso de factura disponible, vencimiento y atraso enviados por el sistema. |
Responder al cliente dentro de 24h de su último mensaje (texto libre). |
| Cualquier disparo iniciado por la empresa (cobranza, aceptación, comunicado). |
Conversación de atención ya en curso en el chat. |
Requisitos
- Número activo en la API Oficial (integración "Meta business") — ver la guía de activación
.
- Acceso de administrador a Meta Business de la empresa para crear los modelos.
- Acceso al módulo de plantillas de Quaza.
Paso a paso
1Crear el modelo en Meta Business
Ingresá a business.facebook.com, abrí el Portafolio empresarial del número y andá al Administrador de WhatsApp.
Configuración → Cuentas de WhatsApp → Administrador de WhatsApp → Plantillas de mensaje → Gestionar plantillas
En el Administrador de WhatsApp, abrí "Plantillas de mensaje" → "Gestionar plantillas".
- Hacé clic en Crear modelo y elegí la categoría Utilidad (no Marketing).
- Poné un nombre en minúsculas con guion bajo, identificando la función. Se recomienda terminar con
_meta_business para diferenciar. Ej.: aviso_vencimiento_meta_business.
- Definí el idioma de la mensajería del cliente y el tipo de variable Número.
- Completá el encabezado (opcional) y el cuerpo del mensaje, usando variables numeradas
{{1}}, {{2}}, {{3}} donde entran los datos.
- Revisá la vista previa a la derecha y enviá a análisis.
En el editor, el cuerpo usa variables numeradas — ej.: "Hola {{1}}, tu factura de {{2}} vence el {{3}}".
2Esperar la aprobación de Meta
Tras enviar, el modelo queda En análisis. La aprobación lleva de 24 a 48h. Cuando se aprueba, el estado cambia y la plantilla queda disponible para importar.
Lista de modelos: seguí el estado (En análisis → Aprobado) y la categoría de cada uno.
Si el modelo es rechazado, Meta informa el motivo. Los errores más comunes son categoría equivocada (Marketing en vez de Utilidad) y texto promocional — mirá los
consejos de aprobación
.
3Importar la plantilla a Quaza
Comunicación → Plantilla WhatsApp → Importar plantillas
- Hacé clic en Importar plantillas.
- Seleccioná la configuración de WhatsApp (el número) de donde vendrán los modelos y hacé clic en Avanzar.
- Quaza lista los modelos aprobados de esa cuenta. Marcá los que querés traer y hacé clic en Importar.
4Mapear las variables de Quaza
Cada variable numerada de la plantilla ({{1}}, {{2}}…) debe apuntar a un dato del sistema. En la plantilla importada, asociá cada número a la variable correspondiente de Quaza.
En Quaza, en Editar plantilla, cada variable recibe el dato del sistema (cliente, valor, vencimiento).
El resultado, en la vista previa de la conversación, queda con los datos reales en lugar de las variables:
Vista previa del mensaje: las variables de Quaza (ej.: {$cliente.primeiroNome}) se sustituyen por los datos reales en el envío.
Una vez importado y con las variables mapeadas, la plantilla se puede usar en los disparos automáticos de factura y cobranza. Marcá una como predeterminada de la función para que el sistema la use en los avisos.
Variables de Quaza
Son los campos que Quaza sustituye por los datos reales al enviar. Las más usadas en avisos financieros:
| Variable |
Qué inserta |
{$cliente.primeiroNome} |
Primer nombre del cliente. |
{$financeiro.valorAtualizado} |
Valor a pagar actualizado. |
{$financeiro.reg_vencimento} |
Fecha de vencimiento. |
{$financeiro.linkBoleto} |
Enlace directo del boleto. |
{$financeiro.linkBoletoPortal} |
Enlace del boleto en el portal del cliente. |
{$financeiro.hashBoleto} |
Código/identificador del boleto. |
{$debitodetalhe.mesReferenciaFormatado} |
Mes de referencia de la cobranza. |
La lista completa de variables disponibles aparece en el botón "Ver leyenda" de la pantalla de plantilla, separada por Cliente, Contrato, Plan de venta y Factura.
Modelos listos (aviso de factura)
Sugerencias de cuerpo para los tres avisos financieros. Usá {{1}} para el nombre, {{2}} para el valor y {{3}} para la fecha.
Aviso anticipado (antes de vencer)
Hola {{1}}, tu factura está disponible.
Valor a pagar: {{2}}
Vencimiento: {{3}}
Aviso el día del vencimiento
Hola {{1}}, recordatorio: tu factura vence el {{2}}.
Valor a pagar: {{3}}
Aviso vencido (después del vencimiento)
Hola {{1}}, identificamos que tu factura está en atraso.
Valor a pagar: {{2}}
Vencimiento: {{3}}
En Quaza, mapeá: {{1}} → {$cliente.primeiroNome}, {{2}} → {$financeiro.valorAtualizado}, {{3}} → {$financeiro.reg_vencimento}.
Consejos para que la plantilla sea aprobada
- Seleccioná la categoría Utilidad manualmente. Meta suele preseleccionar Marketing, que cuesta más y exige opt-in del contacto.
- Escribí texto transaccional y objetivo (factura, vencimiento, valor). Evitá lenguaje promocional, "imperdible", exceso de emojis y MAYÚSCULAS.
- No prometas ni ofrezcas nada que no sea el aviso en sí — eso lleva el modelo a Marketing o causa rechazo.
- Usá las variables numeradas y completá ejemplos reales al crear (no dejes campos vacíos ni "prueba").
- Revisá la vista previa antes de enviar a análisis.
Glosario
| Término |
Qué es |
| Plantilla (modelo) |
Mensaje preaprobado por Meta, obligatorio para iniciar conversación fuera de la ventana de 24h. |
| Categoría Utilidad |
Plantillas transaccionales (factura, aviso). Más baratas y sin exigencia de opt-in. |
| Categoría Marketing |
Plantillas promocionales. Costo mayor y exigen opt-in del contacto. |
| Variable numerada |
Los marcadores {{1}}, {{2}}… del modelo, donde entran los datos. |
| Variable de Quaza |
El campo del sistema (ej.: {$cliente.primeiroNome}) que sustituye la variable numerada en el envío. |
| En análisis |
Estado del modelo mientras Meta evalúa (24 a 48h). |
| Ventana de 24h |
Período tras el último mensaje del cliente en que la empresa responde libremente. Fuera de ella, solo con plantilla. |
| Plantilla predeterminada |
El modelo que el sistema usa por defecto para una función (ej.: aviso de vencimiento). |
Errores frecuentes
-
Categoría Marketing por error. Meta preselecciona Marketing; cambialo a Utilidad antes de enviar a análisis.
-
Importar antes de aprobar. Quaza solo lista modelos ya aprobados en la cuenta. Si no aparece, el modelo aún está En análisis (o fue rechazado).
-
Variables sin mapear. Si
{{2}} no se asocia a una variable de Quaza, el envío sale con el dato faltante o falla.
-
Texto en Quaza distinto del aprobado. El texto de la plantilla es el que Meta aprobó; en Quaza mapeás variables, no reescribís el cuerpo.
-
Ninguna plantilla predeterminada. La función de aviso necesita al menos una plantilla predeterminada habilitada, si no el disparo no ocurre.
-
Importar del número equivocado. En la importación, seleccioná la configuración (número) correcta — cada cuenta tiene sus propios modelos.
Preguntas frecuentes
¿Por qué necesito plantilla para mandar factura?Porque el disparo parte de la empresa, fuera de la ventana de 24h. WhatsApp solo lo permite con un modelo aprobado por Meta.
¿Dónde creo la plantilla?En Meta Business: Administrador de WhatsApp → Plantillas de mensaje → Gestionar plantillas → Crear modelo. Luego importás en Quaza.
¿Cuánto tiempo lleva la aprobación?De 24 a 48h. Mientras tanto el modelo queda "En análisis" y no aparece para importar.
¿Qué categoría elegir?Utilidad, para avisos transaccionales (factura, vencimiento, atraso). Marketing cuesta más y exige opt-in.
¿Cómo entra el nombre del cliente en el mensaje?Por las variables: la plantilla tiene {{1}} y en Quaza la asociás a {$cliente.primeiroNome}. En el envío, se vuelve el nombre real.
¿Puedo reutilizar la misma plantilla para varios números?Los modelos pertenecen a cada cuenta (número). Importá de la configuración correcta; si usás varios números, creá/importá en cada uno.
La plantilla no aparece en la importación. ¿Por qué?Probablemente aún está En análisis o fue rechazado en Meta. Solo los modelos aprobados aparecen para importar.
¿Puedo editar el texto después de importado?El texto aprobado es el que Meta validó. En Quaza ajustás el mapeo de las variables; cambiar el cuerpo exige un nuevo modelo en Meta.
¿Cómo sabe el sistema qué plantilla usar en el aviso?Por la plantilla marcada como predeterminada de la función. Mantené al menos una predeterminada habilitada para cada tipo de aviso.
¿Puedo incluir el enlace del boleto?Sí, con las variables {$financeiro.linkBoleto} o {$financeiro.linkBoletoPortal} mapeadas en la variable correspondiente.
Mi plantilla fue rechazada. ¿Y ahora?Mirá el motivo informado por Meta, ajustá (en general categoría o texto promocional) y reenviá. Mirá los consejos de aprobación arriba.
Documentos relacionados