Cómo asignar variables de eventos
Si tu webhook pasa variables con nombres personalizados o estructuras anidadas, puedes insertar una muestra JSON y asignar manualmente los campos del webhook a tus variables de eventos. Por ejemplo, para enviar un correo electrónico, el sistema debe saber qué campo incluye la dirección de correo electrónico, incluso si tiene un nombre diferente o está anidado dentro de un objeto.
En este artículo, hablaremos sobre cómo asignar variables en un evento personalizado.
Crea un evento y selecciona una estructura de datos
Ve a Automatización > Administrador de eventos y haz clic en Añadir nuevo evento. Selecciona un tipo de evento.
Leer también: Crear eventos.
En Estructura de datos, selecciona Personalizada como tipo de estructura.
Añade una estructura de datos entrantes
Para asignar variables, empieza por añadir una muestra de los datos que enviará tu webhook. Esto permite al sistema leer las variables disponibles y sugerirlas para su asignación.
Haz clic en Subir datos y decide cómo insertar los datos:
| Insertar código | Introduce o pega JSON en el campo de entrada. Haz clic en Subir. |
| Importar desde una URL | Ingresa un enlace a un archivo o solicitud para que el sistema pueda recuperar automáticamente los datos JSON. Haz clic en Obtener y previsualiza la estructura en el campo de abajo. |
Una vez que hayas agregado los datos, verás la etiqueta Datos recibidos junto al botón Subir.
Asigna variables
Asigne los campos del webhook a las variables de Automatización en las siguientes columnas:
| Campo del webhook | Selecciona un campo de la estructura del evento cargado. Si el campo forma parte de un objeto anidado, puedes expandir la estructura de datos para encontrarlo. Haz clic en la flecha y selecciona un valor. |
| Variable del evento | Introduce el nombre de una variable de Automatización. La lista de variables disponibles variará en función del tipo de evento. |
| Tipo de datos | String: Valores de texto, hasta 255 caracteres.
|
Para identificar los contactos que pasan por tu flujo, asigna las variables de email o phone. Asegúrate también de asignar cualquier otra variable de flujo relevante, como las condiciones de Filtro.
Utiliza variables no asignadas
Incluso si no asignas ciertas variables, estas están disponibles en Automatización. Variables no asignadas:
- Están disponibles en elementos con campos de contenido (mensajes, títulos y nombres).
- Se añaden automáticamente desde la estructura de datos.
- Se pasan como referencias JSONPath.
- Se reconocen como
Stringde forma predeterminada.
Para utilizar variables JSONPath en tu flujo, selecciona la opción Transferir datos adicionales al flujo en la configuración del evento.
Puedes añadir variables a los flujos activados por el evento creado.
Puedes insertar variables JSONPath en los siguientes elementos:
| Elemento* | Posición de variable |
| Asunto, preencabezado y cuerpo del correo electrónico. | |
| SMS, App de mensajería, WhatsApp, Viber | Texto del mensaje. |
| Acción | Cualquier campo que admita la inserción de variables, incluidos nombres de tratos, nombres de contactos, nombres de tareas y más. |
*Las variables asignadas en la estructura del evento se admiten en todos los elementos de tu flujo automatizado.
Utiliza la sintaxis {{$[path]}}, donde [path] es la ruta JSONPath de tu variable. Por ejemplo, si tu arreglo tiene la siguiente estructura:
{
"data": {
"user": {
"name": "Alex",
"contact_info": {
"email": "alex@example.com",
"phone": "(601) 484-5378"
}
},
"order": {
"number": "WORD-20250730",
"items_count": 2,
"total_price": 1899
}
}
}Tu mensaje puede aparecer así:
Hello, {{$['data']['user']['name']}}!
Your order #{{$['data']['order']['number']}} is being processed.
We'll give you a call if anything needs your attention. Thank you for choosing us!En este caso, las variables 'name' y 'number' podrían no estar asignadas en la estructura de tu evento.
Para ver los datos de cada evento ejecutado, ve a Administrador de eventos > Registro.
Última actualización: 07.08.2025
o