Para qué sirve#
Las plantillas son mensajes pre-aprobados por Meta que permiten escribir primero a un contacto o retomar una conversación cuando ya pasó la ventana de 24 horas. Connecto las lee y las crea directamente en Meta, así nunca tienes que escribir a mano el nombre exacto de una plantilla.
Quién puede usarlo: administradores (crear, eliminar, editar variables, marcar la predeterminada). La lista también alimenta el selector de plantillas del chat para los asesores.
Dónde: Ajustes de sistema → Canales de mensajería → Detalle de canal → pestaña Plantillas. Está disponible para WhatsApp, Messenger e Instagram. Telegram y el chat web no usan plantillas.
La lista de plantillas#
Se carga sola al abrir la pestaña y se vuelve a leer de Meta cada vez que pulsas Actualizar. Se muestran todas las plantillas de la cuenta, salvo la de ejemplo «hello_world», que Connecto ignora siempre.
| Columna | Qué muestra |
|---|---|
| Nombre | Nombre de la plantilla. Si fue rechazada, debajo aparece el motivo |
| Mensaje | Encabezado (si tiene), texto completo, pie de página y botones |
| Categoría | Utilidad, Marketing, Autenticación o Servicio |
| Idioma | Código del idioma (por ejemplo es, en_US) |
| Estado | Ver tabla de estados |
| Por defecto | Solo WhatsApp: interruptor para dejarla como plantilla predeterminada (solo en plantillas aprobadas) |
| Variables | Lápiz para editar cómo se llena cada variable (si la plantilla tiene) |
| (sin título) | Botón Eliminar plantilla |
Si no hay plantillas: «Todavía no hay plantillas creadas para esta cuenta.» Si Meta no responde: «No se pudieron cargar las plantillas.» o «Error de red al cargar las plantillas.»
Estados de aprobación#
| Estado en pantalla | Significado |
|---|---|
| Aprobada | Lista para usar |
| Pendiente de revisión | Meta la está revisando |
| Rechazada | Meta la rechazó; el motivo aparece bajo el nombre |
| Pausada | Meta la pausó |
| Deshabilitada | Meta la deshabilitó |
| En apelación | Se apeló el rechazo |
| Pendiente de eliminación, Eliminada, Archivada | Fase de baja de la plantilla |
| Límite excedido | Se superó un límite de la cuenta |
| Marcada | Meta la marcó para revisión |
| Restablecida | Volvió a quedar vigente |
Tiempos de aprobación (los decide Meta): en WhatsApp lo normal es de unos minutos hasta 24 horas; Utility y Authentication suelen aprobarse en minutos; Marketing puede tardar hasta 24 horas; en casos poco frecuentes hasta 48 horas. En Messenger e Instagram suelen aprobarse solas en segundos o pocos minutos.
Motivos de rechazo que verás#
| Motivo | Texto en pantalla |
|---|---|
| Formato inválido | «Formato inválido — falta el ejemplo de la variable {{1}} o está mal colocada.» |
| Categoría incorrecta | «El texto no encaja con la categoría elegida — para Utility, debe sonar a actualización de una solicitud/caso existente, no a un saludo genérico.» |
| Contenido no corresponde | «El contenido no corresponde a la categoría — mismo motivo que "categoría incorrecta".» |
| Contenido abusivo | «Meta detectó contenido considerado abusivo o spam.» |
| Idioma inválido | «El idioma indicado no es válido.» |
| Estafa | «Meta la marcó como posible estafa o fraude.» |
Botones de la barra superior#
| Botón | Qué hace |
|---|---|
| Instrucciones | Abre una guía paso a paso para crear una plantilla de la red del canal |
| Crear plantilla nueva | Abre el formulario de creación |
| Actualizar | Vuelve a leer las plantillas desde Meta |
Crear una plantilla#
- Pulsa Crear plantilla nueva. Se abre una ventana con el formulario a la izquierda y la vista previa (cómo se verá el mensaje en WhatsApp) a la derecha.
- Completa los campos de la tabla.
- Pulsa Crear y enviar plantilla a revisión.
- Se abre Confirmar envío a revisión con el mensaje completo. Pulsa Sí, crear y enviar a revisión (o Volver a editar).
- La plantilla aparece en la lista en estado Pendiente de revisión (WhatsApp) o Aprobada (Messenger e Instagram, cuando Meta la aprueba al instante). Pulsa Actualizar para ver los cambios.
| Campo | Qué hace | Reglas |
|---|---|---|
Nombre (nombre_plantilla) | Nombre de la plantilla | Solo minúsculas, números y guion bajo. No se puede cambiar después. Máximo 120 caracteres |
| Categoría (solo WhatsApp) | Utility, Marketing o Authentication | Por defecto Utility. En Messenger e Instagram la categoría es siempre Utility y el selector no aparece |
| Idioma | Idioma de la plantilla. Cada idioma es una plantilla distinta | Lista de más de 60 idiomas; por defecto «Español (es)» (o «Inglés (EE. UU.)» si usas Connecto en inglés) |
| Encabezado (opcional, solo WhatsApp) | Una línea de texto en negrita sobre el mensaje | Máximo 60 caracteres, texto simple, sin variables y sin formato (* _ ~ y comilla invertida) |
| Texto | Cuerpo del mensaje | Obligatorio. Usa {{1}}, {{2}}… (hasta 5, en orden y sin saltos). Debe llevar al menos una variable. No puede empezar ni terminar con una variable |
| Pie de página (opcional, solo WhatsApp) | Línea pequeña bajo el mensaje | Máximo 60 caracteres y sin variables |
| Variables | Una fila por cada {{n}} detectada | Obligatorio indicar su valor de ejemplo (ver más abajo) |
| Botones (opcional, solo WhatsApp) | Hasta 10 botones | Ver más abajo |
La barra de formato inserta los símbolos de WhatsApp: Negrita (*texto*), Cursiva (_texto_), Tachado (~texto~), Monoespaciado (tres comillas invertidas), Código en línea (comilla invertida), lista con viñetas (- ), lista numerada (1. ) y cita (> ).
Variables y ejemplos#
Meta exige un ejemplo por cada variable para validar el formato. Por cada {{n}} hay un solo campo con lista desplegable:
- Elige un dato del contacto:
contacto.nombre,contacto.apellidoocontacto.nombrescompletos. Al usar la plantilla, la variable se llena sola con ese dato. A Meta se le envía un nombre de ejemplo («Juan», «Pérez» o «Juan Pérez»). - O escribe un valor personalizado (hasta 500 caracteres). Ese valor sirve como ejemplo para Meta y como valor por defecto al usar la plantilla.
Si dejas una variable personalizada sin valor, el sistema avisa: «Escribe el valor de la variable {{n}}: todas las variables deben tener valor para mostrar el mensaje completo.»
Botones (solo WhatsApp, no Authentication)#
Con el selector + Agregar botón… puedes añadir:
| Tipo | Qué es | Reglas |
|---|---|---|
| Respuesta rápida | Botón que el contacto pulsa para responder | Hasta 10 |
| Visitar sitio web | Abre un enlace fijo | Hasta 2. La URL debe empezar con https:// (máximo 2000 caracteres, sin espacios ni variables) |
| Llamar por teléfono | Marca un número | Hasta 1. Formato internacional, por ejemplo +573001234567 (7 a 15 dígitos) |
Todos: texto de máximo 25 caracteres, sin variables y sin repetirse. Máximo 10 botones en total. Los botones de sitio web y teléfono van primero y las respuestas rápidas se agrupan al final. Con 4 o más botones la plantilla no se ve en WhatsApp Desktop. Las plantillas de categoría Authentication no admiten botones, encabezado ni pie personalizados.
Mensajes de error al crear#
| Mensaje | Causa |
|---|---|
| «Faltan campos requeridos.» | Falta el nombre o el texto |
| «El nombre solo puede tener minúsculas, números y guion bajo.» | Nombre con otros caracteres |
| «El cuerpo debe incluir al menos una variable: {{1}}.» | El texto no tiene variables |
| «Máximo 5 variables por plantilla ({{1}} a {{5}}).» | Más de 5 variables |
| «Las variables deben numerarse en orden y sin saltos: {{1}}, {{2}}, {{3}}…» | Numeración con huecos |
| «Meta no permite que el texto empiece ni termine con una variable: agrega texto antes de la primera y después de la última.» | Variable al inicio o al final |
| «Falta un ejemplo para {{n}} — Meta lo exige para validar el formato de la plantilla.» | Variable sin ejemplo |
| Errores de botones y encabezado/pie | Se explican con el motivo exacto (por ejemplo «Botón 1: la URL debe empezar con https://») |
| «Solo un administrador puede crear plantillas.» | Usuario sin permiso |
| «No se pudo determinar la WhatsApp Business Account de este número.» | Falta el WABA ID y no se pudo deducir |
Editar las variables de una plantilla existente#
En la columna Variables pulsa el lápiz (Editar variables). En la ventana «Variables de la plantilla» elige, para cada variable, si se llena sola con contacto.nombre, contacto.apellido o contacto.nombrescompletos, o si es Personalizado (se escribe al usar la plantilla). Pulsa Guardar. Este valor se guarda en Connecto y no cambia la plantilla en Meta.
Plantilla por defecto (solo WhatsApp)#
El interruptor de la columna Por defecto deja una plantilla como la predeterminada para iniciar conversación (pasa el mouse para ver «Plantilla por defecto para iniciar conversación (solo una por canal)»). Solo puede haber una por canal: al marcar otra, la anterior se desmarca. Solo se puede marcar en plantillas Aprobadas. El modal «Iniciar conversación» del chat la deja preseleccionada. Si la quitas, el canal se queda sin predeterminada.
Eliminar una plantilla#
- Pulsa Eliminar plantilla en su fila.
- Se abre «Eliminar plantilla»: «Se eliminará de Meta la plantilla «nombre» (idioma). Esta acción no se puede deshacer; para volver a tenerla hay que crearla de nuevo y esperar otra aprobación.»
- El sistema te advierte si:
- Era la plantilla por defecto: «el canal se quedará sin plantilla por defecto.»
- Hay campañas pendientes (programadas, en ejecución o pausadas) que la usan: «Hay N campaña(s) pendientes que usan esta plantilla y fallarán al enviar.»
- Pulsa Sí, eliminar.
Reglas: se elimina solo ese idioma de la plantilla. También se borran sus valores de variables guardados y, si era la predeterminada, esa marca. Meta no deja reutilizar el nombre de inmediato: si vas a recrearla, usa otro nombre. Si la plantilla ya no existe en Meta: «La plantilla ya no existe en Meta; actualiza la lista.»
<!-- Fuente: tenant-app/views/partials/plantillas_canal.php, tenant-app/public/api/channel_templates.php, channel_template_crear.php, channel_template_default.php, channel_template_eliminar.php, tenant-app/public/api/plantilla_variables.php, shared/src/Core/MetaTemplates.php, shared/i18n/es.php -->