Variables y Placeholders

Las variables permiten insertar datos dinamicos en tus automatizaciones y mensajes.

Sintaxis Basica

Placeholders

Los placeholders usan doble llave:

Ejemplos:

"Hola {{postulant.name}}" se convierte en "Hola Juan Perez"

"Tu score es {{matchScore}}%" se convierte en "Tu score es 85%"

Acceso a Propiedades

Punto (.) para acceder a propiedades:

• {{postulant.name}} - Nombre del candidato
• {{postulant.contact.email}} - Email anidado
• {{job.requirements[0]}} - Primer requisito

Corchetes para arrays:

• {{skills[0]}} - Primera skill
• {{interviews[1].date}} - Fecha de segunda entrevista

Variables Disponibles

Datos del Candidato (postulant)

Datos de la Vacante (job)

Datos de la Aplicacion (application)

Datos del Proceso (process)

Datos de la Empresa (company)

Datos de Eventos (event)

Datos del Trigger

Datos de Ejecucion

Datos de Tiempo

Filtros y Formateo

Filtros de Texto

Filtros de Numeros

Filtros de Fechas

Filtros de Arrays

Filtros Condicionales

default: Usa valor alternativo si es nulo

{{value | default:"Sin valor"}}

ifEmpty: Usa texto si esta vacio

{{value | ifEmpty:"No especificado"}}

ternary: Valor condicional

{{condition | ternary:"Si":"No"}} - "Si" si es true, "No" si es false

Expresiones

Operadores

Aritmeticos:

• {{a + b}} - Suma
• {{a - b}} - Resta
• {{a * b}} - Multiplicacion
• {{a / b}} - Division
• {{a % b}} - Modulo

Comparacion:

• {{a == b}} - Igualdad
• {{a != b}} - Diferente
• {{a > b}} - Mayor que
• {{a >= b}} - Mayor o igual
• {{a < b}} - Menor que
• {{a <= b}} - Menor o igual

Logicos:

• {{a AND b}} - Y logico
• {{a OR b}} - O logico
• {{NOT a}} - Negacion

Ejemplos de Expresiones

Calculo de salario:

{{salary * 12}} = Salario anual

Porcentaje:

{{(completed / total) * 100}}% = "75%"

Condicion:

{{score >= 80 ? "Aprobado" : "No aprobado"}} = "Aprobado"

Concatenacion:

{{firstName + " " + lastName}} = "Juan Perez"

Contexto de Variables

En Triggers

Cuando se dispara un trigger, las variables disponibles dependen del tipo de evento:

APPLICATION_CREATED:

• {{postulant.*}}
• {{job.*}}
• {{application.*}}
• {{trigger.data.*}}

TASK_MOVED:

• {{postulant.*}}
• {{process.*}}
• {{task.*}}
• {{trigger.previousStep}}
• {{trigger.newStep}}

MESSAGE_RECEIVED:

• {{postulant.*}}
• {{message.content}}
• {{message.channel}}
• {{thread.*}}

En Acciones

Las acciones pueden usar:

• Variables del trigger
• Variables de acciones anteriores
• Variables del contexto
• Variables estaticas

Ejemplo de flujo:

1. Trigger APPLICATION_CREATED

   • {{application.id}} disponible

2. Accion ANALYZE_CV

   • Resultado: {{previousAction.result.skills}}

3. Accion SEND_EMAIL

   • Puede usar ambos: {{application.id}} y {{skills}}

Guardar en Contexto

// Accion SET_VARIABLE guarda en contexto
{
  "actionType": "SET_VARIABLE",
  "configuration": {
    "name": "isQualified",
    "value": "{{matchScore >= 70}}"
  }
}

// Despues disponible como:
// {{isQualified}} → true/false

Variables en Mensajes

Email

Asunto:

"Bienvenido a {{company.name}}, {{postulant.firstName}}!"

Cuerpo:

"Hola {{postulant.name}},

Gracias por aplicar a {{job.title}}.

Tu aplicacion fue recibida el {{application.createdAt | format:'DD/MM/YYYY'}}.

Te mantendremos informado sobre el proceso.

Saludos, {{company.name}}"

WhatsApp

"¡Hola {{postulant.firstName}}!

Tu entrevista esta confirmada para:

• {{event.date | format:'dddd D MMMM'}}
• {{event.time}}
• {{event.location | default:'Via Zoom'}}

{{#if event.meetingUrl}} Link: {{event.meetingUrl}} {{/if}}

¿Te funciona este horario?"

Notificacion

Titulo: "Nueva aplicacion: {{postulant.name}}"

Mensaje: "Aplico a {{job.title}} desde {{application.source}}"

Bloques Condicionales

If/Else en Templates

{{#if condition}}
  Contenido si verdadero
{{else}}
  Contenido si falso
{{/if}}

Ejemplo:

{{#if event.meetingUrl}}
  Link de reunion: {{event.meetingUrl}}
{{else}}
  La reunion sera presencial en: {{event.location}}
{{/if}}

Unless

{{#unless condition}}
  Contenido si falso
{{/unless}}

Ejemplo:

{{#unless hasCv}}
  Recuerda subir tu CV para continuar.
{{/unless}}

Each (Loops)

{{#each items}}
  - {{this.name}}: {{this.value}}
{{/each}}

Ejemplo:

Documentos pendientes:
{{#each pendingDocuments}}
  - {{this.name}} (vence: {{this.dueDate | format:'DD/MM'}})
{{/each}}

Depuracion

Ver Variables Disponibles

En modo debug, puedes ver todas las variables:

Probar Expresiones

En el editor, preview de expresiones:

Buenas Practicas

Nombrado

DO:

• Nombres descriptivos
• camelCase para variables
• Documentar variables custom
• Usar defaults para opcionales

DON'T:

• Variables con nombres genericos (x, temp)
• Asumir que existen
• Hardcodear valores
• Expresiones muy complejas

Seguridad

Cuidado con:

• Datos sensibles en logs
• Inyeccion de codigo
• Variables de usuarios externos
• Exponer datos internos

Siempre:

• Validar entrada
• Usar filtros apropiados
• Escapar HTML si necesario
• Limitar acceso a datos

Proximos Pasos

• Ejecucion y Monitoreo - Ver logs
• Ejemplos Practicos - Casos de uso
• Flow Builder - Editor visual