Disparador: Recordatorio de cita

El disparador Recordatorio de cita arranca un workflow cuando falta un número de horas antes de que empiece una cita agendada en el módulo de Citas. Es el disparador pensado para bajar el ausentismo: le recordás al contacto su turno sin que un agente tenga que acordarse de hacerlo a mano.

⚠️ Importante: en producción, el barrido que alimenta este disparador corre con un valor fijo de 24 horas antes (appointments:send-reminders --hours=24, cada hora). El campo "Horas antes" del Inspector es un filtro que tenés que dejar en 24 para que coincida — cualquier otro valor (por ejemplo 2 o 48) hace que el workflow nunca se dispare, porque el evento que llega siempre trae 24.

Cuándo se dispara

Cuando el barrido diario detecta que faltan ~24 horas para que arranque la cita.

Configuración del disparador

• Horas antes: dejalo en 24 — es el único valor que hoy coincide con el barrido real del sistema.

Variables disponibles

• $appointment.id, $appointment.starts_at, $appointment.ends_at, $appointment.status, $appointment.calendar_id
• $contact.name, $contact.phone

Ejemplo de workflow

"Recordatorio 24h antes": Disparador Recordatorio de cita (Horas antes = 24) → Acción "Enviar mensaje de WhatsApp": "Hola {{$contact.name}}, te recordamos tu cita mañana {{$appointment.starts_at}}. Respondé CONFIRMAR o CANCELAR."

Consejos

• No armes un segundo workflow con "Horas antes = 2" para un recordatorio doble: hoy nunca se va a disparar, porque el barrido del sistema solo emite el evento a las 24 horas fijas. Si necesitás un recordatorio más cercano a la cita, consultá con el equipo de producto sobre agregar esa frecuencia al barrido.
• Sumale una acción de espera de respuesta y, si el contacto escribe "CANCELAR", encadenala con una acción que cancele la cita.

Solución de problemas

• Si el recordatorio nunca llega, confirmá primero que Horas antes = 24 — cualquier otro valor no va a coincidir con el barrido real del sistema.
• Si además de eso el recordatorio llega tarde o no llega, revisá que la cita tenga fecha de inicio (starts_at) correctamente cargada; sin esa fecha el sistema no puede calcular cuándo avisar.