Recordatorios de eventos

Configura GCM para enviar recordatorios automáticos antes de cada evento en el calendario — 24 horas, 12 horas, 2 horas antes, en los canales que elijas, con una plantilla que personalizas. La pestaña Recordatorios vive en Configuración → Recordatorios y es solo para administradores.

Abre la pestaña de recordatorios

Desde la barra lateral, haz clic en Configuración, luego la pestaña Recordatorios. El formulario es una sola tarjeta con un interruptor maestro de activación en la parte superior — apagarlo pausa todos los recordatorios de eventos sin perder tu configuración.

Cómo funcionan los recordatorios

Una edge function programada se ejecuta cada 15 minutos y busca eventos que comienzan dentro de cualquiera de tus desplazamientos configurados. Para cada evento coincidente, envía una notificación por par (miembro, canal) a cada miembro que esté marcado como asistiendo o invitado. Los miembros que se han excluido de un canal específico no obtienen recordatorios en ese canal.

Interruptor maestro de activación

El interruptor grande en la cabecera de la tarjeta enciende o apaga los recordatorios a nivel de toda la organización. Apagado significa que el trabajo cron salta tu organización por completo — no salen recordatorios hasta que lo vuelvas a encender. Útil para:

• Pausar durante una semana de planificación cuando la mitad de tu calendario son borradores.
• Cortar ruido durante temporadas de baja asistencia.
• Probar una nueva plantilla sin spamear a todos.

Momento del recordatorio

Elige cuándo se disparan los recordatorios relativos al inicio del evento. La fila de insignias ofrece cinco desplazamientos preestablecidos:

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

Haz clic en una insignia para seleccionar; haz clic de nuevo (o haz clic en la X) para deseleccionar. Puedes elegir más de uno — la mayoría de las iglesias usa 24h + 2h como un par sensato (el empujón del día anterior más el aviso del mismo día). Elegir los cinco inunda a los miembros con cinco recordatorios por evento, que es demasiado.

Al menos un desplazamiento debe estar seleccionado para que el formulario se guarde. El texto de error debajo de la fila te lo recuerda.

Canales de notificación

Debajo del momento hay una lista de casillas de categorías de canal: Push, Correo, SMS, In-app, WhatsApp. Marca los canales en los que quieres que se envíen los recordatorios. Cada miembro recibe un recordatorio por canal marcado — no se enrutan a un único "mejor" canal, los reciben todos.

TIP

Push + In-app es la combinación más suave — ambos son silenciosos para los miembros que no se han suscrito. Correo + SMS es la más confiable pero la más intrusiva. Para una congregación típica, Push + Correo es un buen predeterminado.

Al menos un canal debe estar seleccionado. El texto de error te lo recuerda.

Los canales disponibles aquí reflejan lo que está configurado bajo Configuración → Canales y la página de Canales. Si un canal no está activado allí, aún aparece en esta lista pero el recordatorio no se enviará realmente en él — el despachador registra una advertencia de "canal desactivado" y lo salta.

Plantilla del mensaje

El cuerpo del recordatorio está plantillado con tokens de fusión. Dos campos:

• Título — la línea de asunto (correo), título de notificación (push, in-app) o primera línea de un SMS.
• Cuerpo — el cuerpo completo del mensaje.

Tokens disponibles:

Token	Reemplazado con
{{event_title}}	El título del evento
{{event_date}}	Fecha formateada, en la zona horaria de la organización
{{event_time}}	Hora formateada, 24h
{{event_location}}	" en {location}" — incluye el espacio inicial si se establece una ubicación, cadena vacía si no

Los predeterminados son:

• Título: Próximo: {{event_title}}
• Cuerpo: {{event_title}} el {{event_date}} a las {{event_time}}{{event_location}}

Edita cualquier campo libremente — puedes soltar tokens, reordenarlos o agregar texto estático como "¡No lo olvides!" antes del título.

Vista previa

La tarjeta de Vista previa en la parte inferior del formulario renderiza ambos campos con datos de muestra (Servicio dominical, Dom, 15 Mar, 10:00, en el auditorio principal) para que puedas ver cómo se verá el mensaje final. La vista previa se actualiza a medida que escribes — no se requiere guardado.

Guardar

Haz clic en Guardar configuración de recordatorios en la barra fija de la parte inferior. La barra aparece solo cuando tienes cambios sin guardar y permanece visible mientras te desplazas, así que no pierdes el rastro de las ediciones pendientes. Un toast confirma.

El guardado falla rápido si has deseleccionado todas las opciones de tiempo o todos los canales — la barra se desactiva a sí misma hasta que lo arregles.

Qué se guarda dónde

Todas las configuraciones viven en una sola fila en event_reminder_config, una fila por organización:

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

El despachador del lado del cron lee esta fila, encuentra eventos coincidentes y escribe una notificación por destinatario en la cola de envío del canal apropiado.

Canales vs recordatorios — qué es diferente

La pestaña Recordatorios elige qué canales se usan para la función de recordatorios de eventos específicamente. La página Canales configura cómo se conecta cada canal a su proveedor. Necesitas ambos:

• Página Canales: "WhatsApp está configurado con nuestra sesión WAHA en https://waha.gracia.org"
• Pestaña Recordatorios: "Enviar recordatorios 24h antes vía Push + WhatsApp"

Si marcas un canal aquí pero no lo has configurado en la página Canales, el despachador lo salta silenciosamente — no hay error, pero el recordatorio simplemente no sale en ese canal.

Errores comunes

"Los recordatorios salieron con 5 horas de diferencia." El despachador usa organizations.timezone, no app_settings.app_timezone. Si esos dos alguna vez no concuerdan (no debería ocurrir vía la interfaz, pero puede si se editó SQL directamente), los recordatorios se disparan en la zona equivocada. Vuelve a guardar la configuración regional vía Configuración → Marca → Configuración regional.

"Establecí 24h pero los recordatorios salen en momentos aleatorios." El despachador se ejecuta cada 15 minutos, así que un recordatorio de 24h para un evento a las 10:00 podría dispararse a las 10:00, 10:15 o 10:30 el día anterior. Eso es por diseño — ejecutar un cron por segundo para recordatorios de bajo volumen quemaría mucha computación sin beneficio.

"Los miembros que ya asistieron recibieron un recordatorio de todos modos." Los recordatorios se disparan basados en la hora de inicio del evento, no en si el miembro ha hecho check-in. Una vez que un evento ha pasado, no se disparan recordatorios para él independientemente del estado de RSVP.

"Desactivé SMS pero los recordatorios siguieron enviando SMS." ¿Lo desactivaste en la página Canales, o solo en la pestaña Recordatorios? Desmarcar en la pestaña Recordatorios solo afecta esta función; si un flujo de trabajo o el compositor de mensajería también apuntan a SMS, esos aún envían.

Próximos pasos

• Canales — configura los proveedores que usan los recordatorios.
• Calendario — los eventos que disparan recordatorios viven aquí.
• Correo + notificaciones — proveedor de correo para el canal de correo.