Para qué sirve#
Una plantilla es un mensaje preaprobado por Meta. Es la única forma de escribirle a un contacto por WhatsApp (o por Messenger e Instagram) cuando ya pasó la ventana de 24 horas o cuando quieres iniciar la conversación tú. Se usan desde el Chat; los administradores las crean y gestionan en la configuración del canal.
Quién puede usarlas: cualquier usuario del Chat. Quién puede crearlas, eliminarlas o editar sus variables: solo administradores.
Redes que admiten plantillas: WhatsApp, Messenger e Instagram. Telegram, TikTok y el chat web no.
Enviar una plantilla desde el Chat#
Hay dos caminos y ambos terminan en el mismo selector.
Camino A: desde el aviso de ventana vencida
- Abre la conversación. Si la ventana venció verás la franja amarilla con el botón Continuar con plantilla (y la caja de mensaje bloqueada).
- Púlsalo: se abre la ficha rápida del contacto con el selector de plantillas de esa red.
Camino B: desde la ficha rápida del contacto
- En el Chat, pulsa Buscar contacto… y elige al contacto (o usa + para crearlo).
- En la ficha («Iniciar conversación») pulsa el botón de la red que quieras (por ejemplo WhatsApp). Si la ventana está vigente te lleva a la conversación; si venció o el contacto nunca ha escrito, abre el selector.
En el selector
- Si el contacto no tiene conversación previa por esa red, primero elige la Línea o canal en el menú «Selecciona un canal…» (si hay un solo canal activo se elige solo). Si no hay canales: «No hay canales activos para esta red.»
- Elige la Plantilla. Solo aparecen las plantillas aprobadas; las demás no se pueden usar. En el nombre se ve la categoría entre paréntesis y, si es la plantilla por defecto del canal, «★ por defecto» (ya viene preseleccionada).
- Llena las Variables: hay un campo por cada
{{1}},{{2}}… de la plantilla (máximo 5). Vienen rellenos según lo que el administrador definió: nombre del contacto, apellido, nombre completo o un texto fijo. Todos los campos son obligatorios: mientras alguno esté vacío el botón de enviar no hace nada. - A la derecha ves la Vista previa como un globo de WhatsApp, con el encabezado, el cuerpo con tus valores, el pie de página y los botones de la plantilla. Se actualiza mientras escribes.
- Pulsa Enviar plantilla y abrir conversación. Si todo sale bien: «Plantilla enviada — conversación abierta.» y la conversación se abre.
Mensajes que puedes ver: «Cargando plantillas…», «No se pudieron cargar las plantillas.» y, si la cuenta no tiene ninguna aprobada, «Esta cuenta todavía no tiene plantillas aprobadas. Créala en Configuración > Canales.»
Qué pasa al enviar#
- La conversación queda abierta y asignada a ti, aunque estuviera resuelta o sin asesor. Así se sabe quién decidió reabrir el contacto.
- Si el contacto no tenía conversación en ese canal, se crea una nueva.
- En el hilo se guarda el mensaje completo tal como lo recibe el contacto (encabezado, cuerpo con las variables ya reemplazadas y pie de página). Los botones de la plantilla no se muestran en el hilo.
- Se registra el costo del envío con la tarifa vigente de la categoría de la plantilla (Marketing, Utility, Authentication o Service), para la facturación de mensajería.
- Cada valor de variable admite hasta 1.024 caracteres.
- Un contacto bloqueado no puede recibir plantillas: «Este contacto está bloqueado: no se le pueden enviar mensajes mientras dure el bloqueo.»
- Otros errores posibles: «Este contacto no tiene un número de WhatsApp conocido.», «Este contacto no tiene un identificador de Messenger conocido.» (o de Instagram), «El canal no tiene access_token configurado.» y los rechazos de Meta, que se muestran con su motivo.
pages_utility_messaging.Cómo se llenan las variables#
| Tipo de variable | Qué se pone al usarla |
|---|---|
contacto.nombre | El primer nombre del contacto. |
contacto.apellido | Los apellidos del contacto. |
contacto.nombrescompletos | Nombre y apellidos. |
| Personalizado | Un texto fijo que escribió el administrador. |
Si el valor guardado no existe para ese contacto, el campo queda vacío y debes escribirlo tú.
Gestionar plantillas (administradores)#
Cómo llegar: en Configuración > Canales, en el canal de Messenger o Instagram, o en la pantalla de la línea de WhatsApp, pestaña Plantillas. Ver Configuración de canales y sesiones.
La lista se lee en vivo desde Meta y se actualiza con el botón Actualizar. Columnas:
| Columna | Qué muestra |
|---|---|
| Nombre | Nombre de la plantilla y, si Meta la rechazó, el motivo debajo. |
| Mensaje | Encabezado, cuerpo, pie de página y botones. |
| Categoría | Utilidad, Marketing, Autenticación o Servicio. |
| Idioma | Código del idioma (por ejemplo es). Cada idioma es una plantilla distinta. |
| Estado | Aprobada, Pendiente de revisión, Rechazada, Pausada, Deshabilitada, En apelación, Pendiente de eliminación, Eliminada, Límite excedido, Marcada, Archivada o Restablecida. |
| Por defecto | Interruptor, solo en WhatsApp y solo en plantillas aprobadas. |
| Variables | Cantidad de variables; el lápiz (Editar variables) permite cambiar cómo se llena cada una. |
| (Eliminar) | Botón Eliminar plantilla. |
Plantilla por defecto#
El interruptor Por defecto marca la plantilla que el selector preselecciona al iniciar conversación y la que el chat propone para continuar cuando pasaron más de 24 horas desde el último mensaje del contacto. Solo puede haber una por canal: al activar otra, la anterior se desmarca.
Crear una plantilla nueva#
- Pulsa Crear plantilla nueva.
- Completa el formulario (a la derecha ves la vista previa):
| Campo | Reglas |
|---|---|
| Nombre | Solo minúsculas, números y guion bajo (por ejemplo reabrir_conversacion). No se puede cambiar después. |
| Categoría (solo WhatsApp) | Utility (por defecto), Marketing o Authentication. |
| Idioma | Lista de idiomas; por defecto el de Connecto (es en español). |
| Encabezado (opcional) | Solo WhatsApp y no Authentication. Hasta 60 caracteres, texto simple, sin variables ni formato (* _ ~ y comillas invertidas). |
| Cuerpo | Obligatorio. Barra de formato: negrita, cursiva, tachado, monoespaciado, código, lista con viñetas, lista numerada y cita. |
| Pie de página (opcional) | Solo WhatsApp y no Authentication. Hasta 60 caracteres, sin variables. |
| Ejemplos de variables | Una fila por cada {{n}} detectada: elige un dato del contacto en la lista o escribe un valor (ese valor es el ejemplo que se manda a Meta). |
| Botones (opcional) | Solo WhatsApp y no Authentication. «Respuesta rápida», «Visitar sitio web» (URL fija que empiece con https://) y «Llamar por teléfono» (formato internacional). Texto de hasta 25 caracteres, sin variables y sin repetirse. Máximo 10 botones: 2 de sitio web, 1 de llamada y el resto respuestas rápidas. |
- Pulsa Crear y enviar plantilla a revisión y confirma en la ventana «Confirmar envío a revisión» (muestra el mensaje completo). La plantilla aparece como Pendiente de revisión.
Reglas del cuerpo:
- Debe incluir al menos una variable
{{1}}(no se pueden crear desde Connecto plantillas sin variables). - Hasta 5 variables, numeradas en orden y sin saltos (
{{1}},{{2}},{{3}}…). - El texto no puede empezar ni terminar con una variable.
- Para la categoría Utility el texto debe sonar a actualización de una solicitud ya existente; un saludo genérico lo rechaza Meta con el motivo «categoría incorrecta».
Los tiempos de aprobación los decide Meta: Utility y Authentication suelen aprobarse en minutos; Marketing puede tardar hasta 24 horas; en casos poco frecuentes hasta 48 horas. Si queda Rechazada, el motivo aparece bajo el nombre: corrígela y créala de nuevo con otro nombre.
Eliminar una plantilla#
- Pulsa Eliminar plantilla en su fila. Se abre la ventana de confirmación, que antes verifica qué se verá afectado:
- Si era la plantilla por defecto, el canal se queda sin una.
- Si hay difusiones programadas, en ejecución o pausadas que la usan, se avisa cuántas y que fallarán al enviar.
- Confirma con Sí, eliminar. Se borra ese idioma de la plantilla en Meta y sus valores por defecto de variables.
Meta no deja reutilizar el nombre de inmediato: si vas a recrearla, usa otro nombre.
Para ver los pasos oficiales dentro de Connecto, el botón de Instrucciones del canal abre una guía según la red (WhatsApp, Messenger o Instagram).
<!-- Fuente: tenant-app/public/chat.php, shared/js/chat.js, tenant-app/public/api/conversation_template_send.php, tenant-app/public/api/channel_templates.php, tenant-app/public/api/channel_template_crear.php, tenant-app/public/api/channel_template_default.php, tenant-app/public/api/channel_template_eliminar.php, tenant-app/views/partials/plantillas_canal.php, shared/src/Core/PlantillaVariables.php, shared/src/Core/MessagingWindow.php, shared/src/Core/MetaTemplates.php, shared/i18n/es.php -->