Entradas del Workflow
- Que son las entradas de workflow y como funciona la sintaxis de placeholder
{{variable}} - Variables de entrada comunes disponibles para diferentes tipos de trigger
- Como definir entradas personalizadas para workflows manuales
- Como usar entradas dentro de los pasos del workflow
Las entradas del workflow son valores dinamicos que transportan datos del evento trigger hacia los pasos de tu workflow. Usan la sintaxis de placeholder {{variable}}, que se reemplaza con datos reales cada vez que el workflow se ejecuta. Esto es lo que hace que tus workflows sean flexibles -- en lugar de codificar valores fijos, usas placeholders que se adaptan a cada ejecucion especifica.
Como funciona la sintaxis de placeholder
En cualquier lugar donde puedas ingresar texto en un paso del workflow, puedes insertar un placeholder envolviendo el nombre de una variable en llaves dobles. Cuando el workflow se ejecuta, cada placeholder se reemplaza con el valor real del evento trigger o del contexto del sistema.
Por ejemplo, si escribes lo siguiente en un paso de mensaje:
Hello {{client.name}}, your appointment is confirmed for {{event.date}}.
El sistema reemplaza {{client.name}} con el nombre real del cliente (ej.: "Maria Silva") y {{event.date}} con la fecha real (ej.: "2025-03-15"), produciendo:
"Hello Maria Silva, your appointment is confirmed for 2025-03-15."
Variables de entrada comunes
Las variables disponibles para tu workflow dependen del tipo de trigger y del evento que lo disparo. Aqui hay algunos ejemplos comunes:
| Variable | Descripcion |
|---|---|
{{client.name}} | El nombre del cliente asociado al evento |
{{client.phone}} | El numero de telefono del cliente |
{{client.email}} | La direccion de email del cliente |
{{event.date}} | La fecha de un evento o cita programada |
{{trigger.channel}} | El canal a traves del cual ocurrio el evento trigger (ej.: WhatsApp, web chat) |
{{message.text}} | El contenido de un mensaje recibido |
{{employee.name}} | El nombre del profesional asociado al evento |
Los nombres de variables usan notacion de punto para acceder a datos anidados. La parte antes del punto (ej.: client, event, trigger) indica la fuente de datos, y la parte despues del punto (ej.: name, date, channel) indica el campo especifico.
Usar entradas en los pasos
Al configurar cualquier paso en la seccion Pasos, simplemente escribe el placeholder {{variable}} directamente en los campos de texto. El sistema reconocera el placeholder y lo reemplazara en tiempo de ejecucion. Puedes combinar texto estatico con multiples placeholders en el mismo campo:
Dear {{client.name}}, you have an upcoming appointment on {{event.date}}. If you need to reschedule, reply to this message on {{trigger.channel}}.
Entradas personalizadas para workflows manuales
Cuando tu workflow usa un trigger manual, puedes definir campos de entrada personalizados que el profesional debe completar antes de ejecutar el workflow. Esto es util cuando el workflow necesita informacion que no esta disponible de un evento automatico.
Por ejemplo, puedes definir una entrada personalizada llamada report_date que el profesional ingresa al hacer clic en el boton executeManual. Ese valor queda entonces disponible como un placeholder {{variable}} en todos los pasos del workflow.
Las entradas personalizadas hacen que los workflows manuales sean mas versatiles, ya que el mismo workflow puede producir resultados diferentes dependiendo de lo que el profesional ingrese cada vez.
Siempre envuelve las referencias {{variable}} en acentos graves al escribir sobre ellas en documentacion o notas. La sintaxis de llaves dobles es interpretada por el sistema como un placeholder, por lo que dejarla sin escapar en contextos de documentacion puede causar errores de analisis.