HSM de WhatsApp

Visión General

El Componente de envío de mensajes listos de WhatsApp (popularmente conocido como whatsapp_hsm) es un nodo de acción centrado en el envío de notificaciones estructuradas y proactivas a los contactos. Su función principal es transmitir plantillas de mensajes comerciales preaprobadas por Meta (Mensajes Altamente Estructurados - HSM) fuera de la ventana de conversación estándar de 24 horas, permitiendo el envío de alertas, recordatorios de cobro, actualizaciones de estado y mensajes de reenganche.

Regla de bloqueo por atención abierta: Para evitar interferencias lógicas o interrupciones en el flujo de trabajo de los operadores humanos, el componente cuenta con un bloqueo nativo de seguridad: el sistema realiza un barrido previo y, si el número de destino ya tiene un ticket o una atención humana abierta, la HSM no será enviada. Para forzar el envío de manera prioritaria e independiente del estado actual del contacto, es obligatorio activar explícitamente el parámetro de bypass del componente.

Parámetros de Configuración

La parametrización del componente conecta la cuenta de Meta con las variables del flujo, dividiéndose en los siguientes criterios:

• Conexión: Menú desplegable para seleccionar a través de qué cuenta o número oficial de WhatsApp Business API se transmitirá la notificación activa al destinatario. (Se recomienda utilizar nomenclaturas ficticias o estandarizadas de canales en el entorno de diseño).

• Plantilla: Permite elegir cuál de las plantillas homologadas y aprobadas por Meta en la cuenta comercial se utilizará (ej.: teste_var).

• Variables (Cuerpo): Campos de entrada dinámicos generados automáticamente con base en los marcadores de posición de la plantilla seleccionada (ej.: {{1}} *). Sirven para completar la información personalizada que se inyectará en el mensaje enviado.

• Departamento / Usuario / Campañas (Asignación y trazabilidad): Menús opcionales para vincular el ticket generado por el envío a una cola de atención específica, a un operador fijo o a una campaña de marketing interna con fines de informes analíticos.

• _Enviar a ( Campo obligatorio):_* Campo de entrada numérico que contiene el teléfono del destinatario (con código de área/DDD) que recibirá el envío. Acepta valores estáticos o inyección de variables del flujo.

• No abrir atención (clave de alternancia - Toggle Switch): Parámetro crítico de control. Cuando desactivado, el envío de la HSM abre automáticamente un ticket en el panel si el cliente responde. Cuando activado, el sistema envía la notificación como un envío aislado (notificación pura) e ignora el bloqueo de seguridad, garantizando la entrega del contenido incluso si el contacto tiene una atención abierta con un humano.

• Múltiples salidas (clave de alternancia - Toggle Switch): Cuando se habilita, altera la morfología del bloque en el editor gráfico de flujos, poniendo a disposición puertos de ramificación distintos basados en los estados de entrega y lectura o en las interacciones con la publicación (como clics en botones de respuesta rápida de la plantilla).

Constructor Visual

El constructor adapta dinámicamente su interfaz gráfica en tiempo real, sirviendo como un asistente de validación antes del envío:

• Módulo de previsualización integrado: Al seleccionar una plantilla en el campo Plantilla, la interfaz renderiza una caja de visualización que simula exactamente cómo aparecerá el mensaje en el dispositivo del cliente final, mostrando los marcadores de variables (ej.: Buenos días, soy el {{1}}, ¿todo bien?).

• Formulario dinámico de entradas: El bloque detecta cuántos marcadores de datos existen en el cuerpo, encabezado o pie de página de la plantilla de Meta y genera un campo de texto obligatorio (*) para cada uno de ellos en el bloque Variables, garantizando que ningún mensaje se envíe con fragmentos vacíos o rotos.

Operadores Especiales

Las propiedades lógicas de este componente gestionan la interpolación de datos con los servidores de Meta y el enrutamiento de respuestas:

• Tokenización de cadenas para variables: Los campos de entrada de variables aceptan tanto valores textuales fijos como etiquetas de datos del propio flujo (ej.: inyectar la variable {{cliente.nome}} dentro del campo del marcador {{1}}). En el momento del envío, el motor compila ese payload y lo envía estructurado a la API de WhatsApp.

• Disparo por interacción de botón (Respuestas rápidas): Si la plantilla aprobada por Meta tiene botones de respuesta rápida y el parámetro Múltiples salidas está activo, cada botón se convierte en una línea física de conexión en el editor de flujo. Esto permite diseñar caminos de automatización condicionados a qué botón hizo clic el usuario al responder a la HSM.

Ejemplos Prácticos

La tabla a continuación muestra el comportamiento del componente ante diferentes escenarios operativos de entrega:

Plantilla elegida	Variable inyectada en el {{1}}	Estado de la clave "No abrir atención"	Estado del cliente en el panel	Comportamiento del sistema
teste_var	Agente de prueba	Desactivada (por defecto)	Sin tickets abiertos.	Éxito: El mensaje se entrega y, si el cliente responde, se genera una nueva atención en la plataforma.
teste_var	Agente de prueba	Desactivada (por defecto)	En atención con el soporte técnico.	Envío bloqueado: El sistema aborta el envío de la HSM para no violar la atención que ya está siendo gestionada por una persona.
aviso_cobranca	Valor: R$ 150,00	Activada	En atención con el departamento comercial.	Envío forzado: El sistema ignora el ticket abierto y entrega la notificación de cobro de forma transparente en el dispositivo del cliente.