Notificaciones Push

Las notificaciones push llegan al miembro cuando tiene la app móvil de Ministrium instalada (iOS y Android). Son gratuitas, instantáneas y silenciables por el usuario.

Casos típicos: recordatorio de evento (1 h antes), nuevo anuncio del campus, respuesta a una solicitud de oración, llegada del bus al evento.

Cómo se obtiene el token

El miembro instala la app y inicia sesión.
La app pide permiso de notificaciones (iOS lo pide explícito; Android desde 13 también).
Si acepta, el dispositivo entrega un token (APNS/FCM) que la app envía a la API:


POST /v1/devices
{
  "platform": "ios",
  "token": "abc123...",
  "app_version": "1.4.2",
  "locale": "es-MX"
}

Ministrium guarda hasta 5 dispositivos por miembro. Si supera, expira el más antiguo. Tokens inválidos (app desinstalada) se purgan automáticamente al primer 410 de APNS o equivalente FCM.

Enviar una push

Desde la UI: Comunicaciones → Campañas → Nueva → Push. Mismos pasos que email/SMS pero con campos:

Título (máx. 60 chars)
Cuerpo (máx. 240 chars; iOS recorta a 178 visibles en lockscreen)
Imagen opcional (rich notification, máx. 1 MB)
Deep link opcional: ministrium://eventos/evt_456
Sonido y badge

Deep links

Los deep links abren una pantalla específica de la app:


ministrium://miembro/mem_123        → Mi perfil
ministrium://donaciones/nuevo       → Pantalla de donar
ministrium://eventos/evt_456        → Detalle del evento
ministrium://kiosko/checkin         → Iniciar check-in

Si la app no está instalada, iOS/Android caen a la URL universal https://app.ministrium.com/ir/... que ofrece descargar la app o continuar en web.

Categorías y silencio por usuario

El miembro puede silenciar categorías individuales en su perfil de la app:

Anuncios
Recordatorios de evento
Donaciones (recibos, recurrentes)
Solicitudes de oración
Mensajes pastorales

Por defecto todas activas. Si silencia una categoría, esa categoría no se entrega aunque la iglesia la envíe.

No abuse del canal

Una iglesia que envía push diaria pierde permisos en 2 semanas. Recomendamos ≤ 2 push semanales por miembro promedio. El sistema avisa si una campaña supera ese rate.

Métricas

Cada push reporta:

Entregadas al dispositivo (no garantiza visualización).
Abiertas (tap en la notificación).
Tasa de apertura típica: 8–18% en iOS, 4–10% en Android.
Errores: token inválido, dispositivo apagado >28 días, etc.

Sin app: ¿qué pasa?

Si la iglesia no tiene su app móvil propia (white-label), las push se envían vía la app genérica de Ministrium que cualquier miembro puede instalar. Para iglesias con plan Business+, el white-label móvil está disponible.