v2026.4.10
Fecha de lanzamiento: 29 de abril de 2026
✨ Nuevas Funcionalidades
Nodo Webhook Trigger en el Constructor de Flujos
Un nuevo tipo de nodo para recibir webhooks externos e iniciar flujos automáticamente a partir de eventos enviados por sistemas de terceros, como plataformas de ventas, ERPs, CRMs o cualquier servicio que envíe datos vía HTTP.
¿Para qué sirve?
- Recibir pedidos, eventos o notificaciones de sistemas externos e iniciar flujos automáticamente
- Mapear campos del payload del webhook directamente en variables del flujo
- Vincular o crear clientes y chats a partir de los datos recibidos
- Enrutar la ejecución del flujo según el tipo de evento (
body.event,body.type, etc.)
¿Cómo usar?
- Arrastra el nodo Webhook Trigger al constructor de flujos
- Configura el tipo de autenticación (Bearer, header personalizado, query param, HMAC o Público)
- Copia la URL del webhook generada y configúrala en el sistema externo
- Mapea los campos del body a variables del flujo
- (Opcional) Configura la vinculación con cliente y chat
- (Opcional) Configura el enrutamiento por evento para dirigir el flujo según el tipo de evento recibido
Autenticación configurable del Webhook
El nodo Webhook Trigger soporta cinco modos de autenticación:
| Tipo | Descripción |
|---|---|
| Bearer | Token en el header Authorization: Bearer <token> |
| Header personalizado | Token en cualquier header definido por el usuario |
| Query param | Token como parámetro en la URL (?token=xxx) |
| HMAC | Verificación de firma criptográfica (SHA-1, SHA-256, SHA-512) — compatible con servicios como Kiwify |
| Público | Sin autenticación |
El token se genera automáticamente (o puede definirse manualmente) y se almacena cifrado en la base de datos. Los administradores pueden revelar el token original cuando sea necesario.
Seguridad por IP y Origen
En la pestaña Seguridad del nodo es posible restringir las llamadas al webhook a:
- IPs específicas — lista de direcciones IPv4/IPv6 permitidas
- Dominios/Orígenes — lista de orígenes HTTP permitidos
Dejar en blanco acepta cualquier origen.
Modo "Escuchar" para pruebas en tiempo real
Al abrir el nodo en modo de edición, el botón Escuchar espera la llegada de un webhook real y muestra:
- El payload completo recibido (body, headers, query params)
- La IP y el origen del llamante (sugerencia para la lista de permitidos)
- Botón para mapear variables directamente desde el payload recibido
- Botón para copiar el camino de cada campo (ej.:
body.data[0].name)
El panel de Registros también permite expandir solicitudes anteriores y mapear variables desde ellas.
Vinculación con Cliente y Chat
En la pestaña Cliente & Chat se puede configurar la creación/actualización automática de clientes y chats a partir de los datos recibidos:
Vinculación con Cliente (Multi-key lookup)
- Añade campos del cliente mapeando el camino en el body (ej.:
body.user.email → Email) - Activa el ícono de búsqueda 🔍 en los campos que se usarán para localizar al cliente (lógica OR entre los campos marcados)
- Si el cliente no se encuentra, se crea automáticamente
- Reglas de actualización inteligente:
- Nombre: siempre actualizado
- Email / Teléfono: guardados en la columna directa si está vacía; de lo contrario, añadidos en
customer_contacts - Documento: actualizado solo si está vacío
- WhatsApp, Instagram, Telegram: añadidos en
customer_contactssin sobrescribir valores existentes
Vinculación con Chat
- Selecciona el canal (WhatsApp, email, Instagram, etc.)
- Indica el camino del contacto en el body (ej.:
body.user.phone) - El chat se crea o localiza automáticamente y se vincula al cliente
- El contacto del chat se añade en
customer_contactssi aún no existe
Enrutamiento por Evento
En la pestaña Eventos configura el enrutamiento condicional basado en un campo del payload:
- Define el camino del evento (ej.:
body.event,body.type) - Añade casos con valor y etiqueta — los valores soportan
- Cada caso genera una salida independiente en el nodo
- Un edge "else/fallback" siempre está incluido para eventos no mapeados
En el constructor de flujos, las salidas del nodo se muestran como handles de colores — naranja para cada caso, gris para el else.
🎯 Beneficios
- ✅ Integración nativa con sistemas externos sin código adicional
- ✅ Soporte a HMAC para plataformas que usan firmas criptográficas (Kiwify, etc.)
- ✅ Búsqueda de cliente por múltiples campos simultáneamente (OR) — evita duplicados
- ✅ Creación automática de clientes y chats con datos del webhook
- ✅ Enrutamiento del flujo por tipo de evento recibido
- ✅ Modo "escuchar" para mapear variables sin editar manualmente los caminos
- ✅ Token cifrado en la base de datos — seguridad por defecto