Triggers
Trigger: Evento de cita
El trigger Evento de cita ejecuta el flujo cuando cambia una cita de tu calendario (se abre en una pestaña nueva). Sirve para confirmar por WhatsApp, avisar al anfitrión o actualizar el CRM.
Para qué sirve
Sección titulada «Para qué sirve»Automatizar lo que pasa alrededor de una cita: confirmar por WhatsApp apenas se agenda, avisar al anfitrión de una cancelación o actualizar el CRM cuando alguien reprograma.
Cómo configurarlo paso a paso
Sección titulada «Cómo configurarlo paso a paso»- Entra a Flow studio y pulsa Crear flujo (o abre uno que ya tengas).
- En la barra de la izquierda del lienzo pulsa Agregar nodo, abre Triggers y elige Evento de cita. Si el flujo ya tenía un disparador, el editor pregunta si lo reemplaza: solo puede haber uno por flujo.
- Haz clic en el nodo. En el panel de la derecha, bajo Eventos que disparan este flujo, marca uno o varios: Cita agendada, Cita cancelada o Cita reprogramada. Al marcar Cita cancelada o Cita reprogramada, el listado de datos añade
cancelReasonopreviousStart. - Agrega y conecta los nodos siguientes con los datos de la cita, por ejemplo
{{trigger.guestName}}y{{trigger.meetLink}}. Las fechas llegan en UTC: conviértelas con{{trigger.timezone}}antes de mostrarlas. - Pulsa Guardar y luego Publicar (arriba a la derecha). Solo un flujo publicado arranca solo: sin publicar, el disparador no hace nada.
- Prueba con un caso real y revisa el resultado en Ejecuciones, en la barra de la izquierda. Por ejemplo: reserva una cita desde la página pública de una agenda.
Eventos disponibles
Sección titulada «Eventos disponibles»Eliges uno o varios eventos. Sin ninguno elegido, el flujo no arranca nunca.
| Evento | Se dispara cuando… |
|---|---|
| Cita agendada | Alguien reserva una cita, por la página pública o con el asistente |
| Cita cancelada | La cita se cancela desde el panel, el enlace del invitado o el asistente |
| Cita reprogramada | La cita cambia de fecha u hora |
Salidas
Sección titulada «Salidas»Todos los eventos entregan estos datos en trigger (por ejemplo, {{trigger.campo}}):
| Campo | Descripción |
|---|---|
event | Evento que disparó el flujo (por ejemplo booking.created) |
timestamp | Momento del evento |
bookingId | ID de la cita |
pageId | ID de la agenda |
pageTitle | Nombre de la agenda |
guestName | Nombre del invitado |
guestEmail | Correo del invitado |
guestPhone | Teléfono del invitado |
contactId | ID del contacto, si coincide con uno |
start | Inicio de la cita (UTC, formato ISO) |
end | Fin de la cita (UTC, formato ISO) |
timezone | Zona horaria de la agenda |
durationMinutes | Duración en minutos |
meetLink | Enlace de la videollamada |
hostUserId | ID del anfitrión |
Según el evento, se suma uno más:
| Evento | Campo extra | Descripción |
|---|---|---|
| Cita cancelada | cancelReason | Motivo de la cancelación |
| Cita reprogramada | previousStart | Inicio anterior (UTC, formato ISO) |
Las fechas llegan en UTC. Para mostrarlas al cliente, conviértelas a la zona que viene en timezone.
Ejemplos
Sección titulada «Ejemplos»- Confirmación: trigger con Cita agendada → WhatsApp (se abre en una pestaña nueva) con
{{trigger.guestName}}y{{trigger.meetLink}}. - Registro de cancelaciones: trigger con Cita cancelada → Contacto CRM (se abre en una pestaña nueva) para dejar el motivo (
{{trigger.cancelReason}}).
Protección contra bucles
Sección titulada «Protección contra bucles»Comparte con el Evento de conversación (se abre en una pestaña nueva) y el Evento CRM (se abre en una pestaña nueva) el mismo contador de profundidad. Cada flujo que nace de otro evento suma uno y el tope es 3. Al llegar al tope, ese evento no dispara ningún flujo y la cadena se corta. Así, un flujo que agenda una cita no puede dispararse a sí mismo para siempre.
Problemas comunes
Sección titulada «Problemas comunes»- No dispara — verifica que el flujo esté activo y que el evento esté elegido.
- La hora sale corrida —
startyendestán en UTC; usatimezonepara convertirlas.
