Lembretes de visita

GET/api/cron/appointment-reminders

Varre agendamentos confirmados nas próximas 24h e dispara push de lembrete e/ou "visita começando" conforme a antecedência configurada nas preferências de notificação de cada representante. Pensada pra ser chamada a cada poucos minutos por um serviço de cron externo (ex.: cron-job.org) — não há cron nativo com essa frequência no plano Vercel Hobby.

Exemplos de uso

Autentica com CRON_SECRET, por header Authorization: Bearer ou por query string ?secret= — use o que o serviço de cron escolhido permitir configurar.

curl "https://empresa.primevisita.com.br/api/cron/appointment-reminders" \
  -H "Authorization: Bearer SEU_CRON_SECRET"

Parâmetros

AuthorizationHeaderstring

Descrição

Bearer <CRON_SECRET>. Alternativa ao parâmetro secret na query — use um dos dois.

Como encontrar

Valor da variável de ambiente CRON_SECRET deste projeto, configurado como header customizado no serviço de cron escolhido.

secretQuery stringstring

Descrição

Mesmo CRON_SECRET, como alternativa ao header Authorization — útil em serviços de cron que só permitem colar uma URL, sem configurar headers.

Como encontrar

Mesmo valor de CRON_SECRET, colado diretamente na URL configurada no serviço de cron: /api/cron/appointment-reminders?secret=....

Exemplos de saída

200 — resumo da execução

200

checked = agendamentos avaliados na janela; notified = quantos avisos foram efetivamente enviados (pode ser mais de um por agendamento: lembrete + visita).

{ "checked": 12, "notified": 3 }

Exemplos de erro

401 — não autorizado

401

CRON_SECRET não configurado no servidor, ou secret enviado (header ou query) não bate com o valor esperado.

{ "error": "unauthorized" }