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:

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:

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.

Si un valor no coincide con el tipo de variable, el sistema no lo guarda y no muestra ningún error. La variable permanece vacía en tu correo electrónico, el valor no se guarda en la lista de correo y no se envía a los webhooks. Esto ayuda al sistema a procesar grandes volúmenes de datos de contactos entrantes.

Para ver las variables de contacto que ha recibido el evento, abre el registro de eventos.

Si no puedes cambiar el formato de los datos por tu parte, elimina la variable en la configuración del evento y crea una variable de String con el mismo nombre.

Si tu flujo copia contactos a una lista de correo, elimina también esta variable en la lista de correo. De lo contrario, el valor no se guardará allí. Tus plantillas seguirán funcionando sin cambios, ya que el nombre de la variable sigue siendo el mismo.

Comprueba los nombres de las variables

Los nombres de las variables en tu plantilla y en el evento deben coincidir exactamente. Si no es así, el valor no aparecerá en tu correo electrónico:

• Utiliza únicamente letras latinas básicas (a–z). Las letras acentuadas, como la é o la ü, y las letras de otros alfabetos que se parecen a las latinas crean una variable diferente, aunque el nombre parezca correcto.
• Utiliza guiones bajos en lugar de puntos. El sistema interpreta data.price como la variable precio del array de datos.
• Respeta exactamente las mayúsculas y minúsculas. Productos y productos son dos variables diferentes.
• Mantén las etiquetas HTML fuera de las llaves {{ }}. Por ejemplo, utiliza <b>{{name}}</b>, no {{<b>name</b>}}.

Para saber cómo mostrar arrays de datos en un correo electrónico, consulta Envía arrays de datos con Automatización.

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 String de 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:

*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