Lembretes de eventos

Configure o GCM para enviar lembretes automáticos antes de cada evento no calendário — 24 horas, 12 horas, 2 horas antes, nos canais que escolher, com um template que você personaliza. A aba Lembretes fica em Configurações → Lembretes e é apenas para admins.

Abrir a aba Lembretes

Na barra lateral, clique em Configurações, depois na aba Lembretes. O formulário é um único cartão com um interruptor mestre no topo — desligar pausa todos os lembretes de evento sem perder sua configuração.

Como os lembretes funcionam

Uma edge function agendada roda a cada 15 minutos e procura eventos que começam dentro de qualquer dos seus offsets configurados. Para cada evento que bate, ela envia uma notificação por par (membro, canal) para cada membro marcado como participante ou convidado. Membros que optaram por não receber em um canal específico não recebem lembretes nesse canal.

Interruptor mestre

O interruptor grande no cabeçalho do cartão liga ou desliga os lembretes em toda a organização. Desligado significa que o cron pula sua organização inteira — nenhum lembrete sai até você ligar de novo. Útil para:

• Pausar durante uma semana de planejamento quando metade do seu calendário é rascunho.
• Reduzir ruído em temporadas de baixa presença.
• Testar um novo template sem spammar todo mundo.

Horário do lembrete

Escolha quando os lembretes disparam em relação ao início do evento. A linha de selos oferece cinco offsets prontos:

• 24h
• 12h
• 6h
• 2h
• 1h

Clique em um selo para selecionar; clique de novo (ou no X) para deselecionar. Você pode escolher mais de um — a maioria das igrejas usa 24h + 2h como par razoável (o lembrete do dia anterior mais o aviso do mesmo dia). Escolher os cinco inunda os membros com cinco lembretes por evento, o que é demais.

Pelo menos um offset precisa estar selecionado para o formulário poder salvar. O texto de erro sob a linha lembra.

Canais de notificação

Abaixo do horário fica uma lista de checkbox de categorias de canal: Push, E-mail, SMS, In-app, WhatsApp. Marque os canais nos quais quer enviar lembretes. Cada membro recebe um lembrete por canal marcado — eles não são roteados para um único canal "melhor", eles recebem todos.

TIP

Push + In-app é a combinação mais suave — os dois são silenciosos para membros que não optaram. E-mail + SMS é a mais confiável mas a mais intrusiva. Para uma congregação típica, Push + E-mail é um bom padrão.

Pelo menos um canal precisa estar selecionado. O texto de erro lembra.

Os canais disponíveis aqui espelham o que está configurado em Configurações → Canais e na página Canais. Se um canal não está ativado lá, ele ainda aparece nesta lista, mas o lembrete não envia de fato nele — o dispatcher loga um aviso de "canal desativado" e pula.

Template da mensagem

O corpo do lembrete é templated com tokens de merge. Dois campos:

• Título — a linha de assunto (e-mail), título da notificação (push, in-app) ou primeira linha de um SMS.
• Corpo — o corpo completo da mensagem.

Tokens disponíveis:

Token	Substituído por
{{event_title}}	O título do evento
{{event_date}}	Data formatada, no fuso da organização
{{event_time}}	Hora formatada, 24h
{{event_location}}	" em {location}" — inclui o espaço inicial se um local estiver definido, string vazia se não

Os padrões são:

• Título: Em breve: {{event_title}}
• Corpo: {{event_title}} em {{event_date}} às {{event_time}}{{event_location}}

Edite qualquer campo livremente — você pode tirar tokens, reordenar ou adicionar texto estático como "Não esqueça!" antes do título.

Prévia

O cartão Prévia no fim do formulário renderiza os dois campos com dados de exemplo (Culto de domingo, Dom, 15 mar, 10:00, no Auditório Principal) para você ver como a mensagem final vai ficar. A prévia atualiza enquanto você digita — sem precisar salvar.

Salvar

Clique em Salvar configurações de lembrete na barra fixa do rodapé. A barra aparece só quando você tem mudanças não salvas e fica visível enquanto rola, para você não perder mudanças pendentes. Um toast confirma.

O salvamento falha rápido se você deselecionou todos os horários ou todos os canais — a barra se desabilita até você corrigir.

O que é salvo onde

Todas as configurações vivem em uma única linha em event_reminder_config, uma linha por organização:

organization_id (PK com org)
is_enabled
reminder_offsets_hours    int[]
channel_slugs             text[]
title_template            text
body_template             text

O dispatcher do lado do cron lê essa linha, encontra eventos que batem e escreve uma notificação por destinatário na fila de envio do canal apropriado.

Canais vs lembretes — qual a diferença

A aba Lembretes escolhe quais canais são usados especificamente para o recurso de lembrete de evento. A página Canais configura como cada canal é conectado ao provedor. Você precisa dos dois:

• Página Canais: "WhatsApp está configurado com nossa sessão WAHA em https://waha.grace.org"
• Aba Lembretes: "Enviar lembretes 24h antes via Push + WhatsApp"

Se você marca um canal aqui mas não o configurou na página Canais, o dispatcher pula silenciosamente — não há erro, mas o lembrete simplesmente não sai nesse canal.

Armadilhas comuns

"Os lembretes saíram com 5 horas de diferença." O dispatcher usa organizations.timezone, não app_settings.app_timezone. Se esses dois divergirem (não deveria acontecer pela interface, mas pode se editaram o SQL direto), os lembretes disparam no fuso errado. Salve novamente as configurações regionais via Configurações → Identidade visual → Configurações regionais.

"Defini 24h mas os lembretes saem em horários aleatórios." O dispatcher roda a cada 15 minutos, então um lembrete de 24h para um evento às 10:00 pode disparar às 10:00, 10:15 ou 10:30 no dia anterior. É por design — rodar um cron por segundo para lembretes de baixo volume queimaria muita computação sem benefício.

"Membros que já compareceram receberam lembrete mesmo assim." Lembretes disparam com base na hora de início do evento, não em se o membro fez check-in. Uma vez que um evento passou, nenhum lembrete dispara para ele independente do estado do RSVP.

"Desabilitei SMS mas os lembretes ainda enviaram SMS." Você desabilitou na página Canais ou só na aba Lembretes? Desmarcar na aba Lembretes só afeta esse recurso; se um fluxo de trabalho ou o compositor de mensagens também mira SMS, eles continuam enviando.

Próximos passos

• Canais — configure os provedores que os lembretes usam.
• Calendário — os eventos que disparam lembretes vivem aqui.
• E-mail + notificações — provedor de e-mail para o canal de e-mail.