Tipos de Notificación - Push, Urgente y Llamada

Las notificaciones son el núcleo de la funcionalidad de Echobell. Esta guía explica cómo funcionan las notificaciones, los diferentes tipos disponibles y cómo personalizarlas según tus necesidades.

Tipos de notificación

Al suscribirte a un canal, puedes elegir entre tres tipos de notificación según la urgencia:

• Normal: Notificaciones estándar de la aplicación para alertas rutinarias. Estas siguen la configuración normal de notificaciones de tu dispositivo.
• Urgente: Notificaciones de alta prioridad que pueden atravesar ciertos modos de concentración. Úsalas para alertas importantes que no deben perderse.
• Llamada: Alertas tipo llamada para situaciones críticas que exigen atención inmediata. Estas notificaciones aparecen como llamadas entrantes en tu dispositivo.

El tipo que eliges es un límite máximo

El tipo que eliges es el nivel más alto con el que el canal puede avisarte. Una petición webhook puede enviar notificationType (active, time-sensitive o calling) para pedir un nivel más bajo, nunca uno más alto.

Por ejemplo, suscríbete a tu canal de producción como Llamada. Las alertas de caídas que omiten notificationType suenan como una llamada telefónica, mientras que los eventos rutinarios que envían notificationType=active llegan como notificaciones normales. Quien se suscribió al mismo canal como Normal nunca recibe una llamada, pida lo que pida la petición.

Un canal llama a cada suscriptor como máximo una vez por minuto. Otra llamada dentro de ese minuto llega en su lugar como una notificación urgente, así que un script atascado en un bucle de reintentos no puede hacer sonar tu teléfono una y otra vez.

Los canales con plantilla personalizada ignoran notificationType en la petición, así que cada suscriptor siempre recibe el tipo que eligió. Consulta Webhooks para más detalles.

Contenido de la notificación

Por defecto, un canal muestra el title y el body que envía cada petición; el título es, por defecto, el nombre del canal. Si activas Plantilla personalizada en Configuraciones avanzadas dentro de los ajustes del canal, el canal construye la notificación a partir de plantillas:

• Plantilla de título: Determina qué aparece en el encabezado de la notificación
• Plantilla de cuerpo: Controla el contenido principal de la notificación

Las plantillas admiten variables dinámicas usando la sintaxis {{nombreVariable}}. Por ejemplo:

Título: Alerta de estado de {{server}}
Cuerpo: {{message}} detectado en {{timestamp}}

Variables en notificaciones

Variables de Webhook

En un canal con plantilla personalizada, cada campo de una petición webhook se convierte en una variable. Puedes proporcionar variables a través de:

• Parámetros de consulta: https://hook.echobell.one/t/<channel-token>?server=produccion&status=critico
• Cuerpo JSON:

{
  "server": "produccion",
  "status": "critico"
}

Variables especiales:

• externalLink: Cuando se incluye, crea un enlace clickeable en la vista de registros de notificación

Variables de correo

Al activar vía correo, estas variables están disponibles automáticamente:

• from: Dirección de correo del remitente
• to: Dirección de correo del destinatario
• subject: Línea de asunto del correo
• text: Contenido de texto plano
• html: Contenido HTML del correo

Privacidad y almacenamiento

Echobell adopta un enfoque de privacidad primero en el manejo de notificaciones:

• El contenido e historial de notificaciones se almacena exclusivamente en tu dispositivo local
• Solo los datos esenciales (cuentas de usuario, configuraciones de canal y suscripciones) se almacenan en servidores
• Tus datos de notificación nunca salen de tu control

Configuración de la aplicación

Configura cómo se comportan las notificaciones a través de estos ajustes:

• Repetir contenido de voz: Para notificaciones de llamada, permite repetir el contenido de la notificación
• Reintentar llamada fallida: Reintenta automáticamente las notificaciones de llamada que fallaron debido al Modo de Concentración u otras razones

Notas importantes

• La aplicación requiere permiso de notificaciones para funcionar correctamente
• Las notificaciones se entregan en tiempo real cuando se activan los canales
• Puedes recibir notificaciones tanto de canales que creas como de canales a los que te suscribes
• Se pueden usar diferentes tipos de notificación para diferentes niveles de urgencia