Disparador: Lembrete de agendamento

O disparador Lembrete de agendamento inicia um workflow quando falta um número de horas para o início de um horário marcado no módulo de Agenda. É o disparador certo para reduzir faltas: ele lembra o contato do compromisso automaticamente, sem depender de um agente lembrar de fazer isso na mão.

⚠️ Importante: em produção, a varredura que alimenta esse disparador roda com um valor fixo de 24 horas antes (appointments:send-reminders --hours=24, a cada hora). O campo "Horas antes" do Inspector é um filtro que você precisa deixar em 24 para que bata — qualquer outro valor (por exemplo 2 ou 48) faz o workflow nunca disparar, porque o evento que chega sempre traz 24.

Quando dispara

Quando a varredura diária detecta que faltam ~24 horas para o início do agendamento.

Configuração do disparador

• Horas antes: deixe em 24 — é o único valor que hoje bate com a varredura real do sistema.

Variáveis disponíveis

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

Exemplo de workflow

"Lembrete 24h antes": disparador Lembrete de agendamento (Horas antes = 24) → ação "Enviar mensagem de WhatsApp": "Olá {{$contact.name}}, passando para lembrar do seu horário amanhã às {{$appointment.starts_at}}. Responda CONFIRMAR ou CANCELAR."

Dicas

• Não monte um segundo workflow com "Horas antes = 2" para um lembrete duplo: hoje ele nunca vai disparar, porque a varredura do sistema só emite o evento no marco fixo de 24 horas. Se precisar de um lembrete mais próximo do horário, confirme com a equipe de produto sobre adicionar essa frequência à varredura.
• Adicione um passo de espera por resposta e, se o contato escrever "CANCELAR", encadeie uma ação que cancele o agendamento.

Solução de problemas

• Se o lembrete nunca chegar, confirme primeiro que Horas antes = 24 — qualquer outro valor não vai bater com a varredura real do sistema.
• Se mesmo assim chegar atrasado ou não disparar, confira se o agendamento tem a data de início (starts_at) corretamente preenchida — sem ela o sistema não consegue calcular quando avisar.