Canales de Notificación – Inteligencia Operativa hacia Afuera

Los Canales de Notificación son el mecanismo por el cual Sfero lleva la Inteligencia Operativa fuera de la plataforma y la entrega directamente a las personas e integraciones que necesitan actuar.

Mientras que el Triage, el Briefing y la Biblioteca de Conocimiento viven dentro de Sfero, los canales de notificación empujan los hallazgos críticos al mundo exterior: su correo, su teléfono, sus sistemas y sus agentes de IA.

Objetivo

Garantizar que ningún riesgo crítico quede sin atención por no haber entrado a la plataforma, mediante alertas automáticas y oportunas entregadas en el canal que cada usuario prefiere.

✨ Feature Premium: Los canales de notificación están disponibles en planes Enterprise y Premium.

¿Qué desencadena una notificación?

Sfero envía notificaciones en tres momentos clave:

Evaluación completada con riesgo detectado – Cuando el sistema de IA (Triage) clasifica una evaluación como 🔴 Rojo (Crítico) o 🟡 Amarillo (Alto), se dispara una alerta inmediata.
Patrón recurrente identificado – Cuando la IA detecta un hallazgo que se repite en múltiples evaluaciones dentro del mismo período.
Digest periódico generado – Al finalizar cada período configurado (diario o semanal), se entrega un resumen ejecutivo con la síntesis de la operación.

Los 4 Canales de Notificación

Canal 1: Email

Cómo funciona: Recibe un email HTML estructurado en el momento en que Sfero detecta un riesgo que supera el umbral de severidad configurado.

Qué contiene el email:

Nivel del riesgo (🔴 Crítico / 🟡 Alto)
Nombre del activo o sujeto evaluado
Descripción del hallazgo principal
Proyección predictiva de impacto (si la IA la genera)
Probabilidad de materialización del riesgo
Recomendación de acción concreta
Botón directo: “Ver evaluación en Sfero”

Ejemplo de asunto:

🔴 Riesgo Crítico en Planta Norte – Sfero
⚠️ Riesgo proyectado: Comedor y Vestuarios

Umbral configurable: Puede elegir recibir solo alertas Críticas (critical), Críticas y Altas (high), o cualquier alerta (any).

Canal 2: WhatsApp

Cómo funciona: Recibe un mensaje de WhatsApp al instante cuando se detecta un riesgo. El mensaje es conciso, diseñado para lectura rápida en móvil.

Formato del mensaje:

🔴 *Sfero – Riesgo Crítico*
Activo: Planta Norte
Hallazgo: Extintor vencido + sin señalización
Ver: https://app.sferoio.com/...

Ideal para: Gestores y administradores que están en campo o fuera de la oficina y necesitan ser alertados de inmediato sin abrir la plataforma.

Requisito: El número de destino debe incluir el prefijo del país (ej: +5491112345678).

Umbral configurable: Igual que Email, puede filtrar por nivel de severidad.

Canal 3: Digest Periódico

Cómo funciona: En lugar de alertas individuales, el Digest es un email de resumen ejecutivo que agrega y sintetiza toda la actividad del período usando IA (Gemini), entregado automáticamente al comienzo del día.

Frecuencias disponibles:

Opción	Horario de entrega	Período que resume
Diario	Todos los días a las 7:00 AM UTC	Últimas 24 horas
Semanal	Lunes a las 7:00 AM UTC	Últimos 7 días

Qué contiene el Digest:

KPIs del período: Total de evaluaciones completadas, cantidad de alertas 🔴 / 🟡 / 🟢
Narrativa ejecutiva: 2-3 párrafos redactados por IA en español, listos para compartir con gerencia
Top 5 hallazgos prioritarios: Los riesgos más urgentes detectados en el período
Patrones recurrentes: Problemas que se repiten con mayor frecuencia
Enlace al dashboard completo

Ideal para: Líderes que prefieren una lectura consolidada al inicio de la semana o el día, en lugar de interrupciones individuales por cada evaluación.

Digest manual: También puede solicitar la generación de un Digest en cualquier momento desde la pantalla de configuración, sin esperar al próximo ciclo automático.

Canal 4: Webhook (para Integraciones y Agentes IA)

Cómo funciona: Sfero envía una notificación HTTP (POST) a una URL externa de su elección cada vez que se generan nuevos insights de IA. Es el canal para integraciones técnicas: conectar Sfero con otros sistemas, automatizaciones o clientes MCP.

Cuándo se activa: Inmediatamente después de que analyze-evaluation genera los insights de una evaluación completada.

Payload enviado:

{
  "event": "insights.generated",
  "timestamp": "2026-05-25T14:00:00Z",
  "organization_id": "uuid-de-su-org",
  "data": {
    "evaluation_id": "uuid-de-la-evaluacion"
  }
}

Seguridad – Firma HMAC: Cada request incluye el header X-Sfero-Signature: sha256={firma} generado con un secreto exclusivo de su webhook. Use este header para verificar que el mensaje proviene de Sfero y no de un tercero.

Reintentos automáticos: Si su endpoint no responde (timeout, error 5xx), Sfero reintenta automáticamente hasta 3 veces con espera progresiva. Si su endpoint falla de forma reiterada (10 fallos consecutivos), el webhook se pausa automáticamente para proteger su sistema, y recibirá una notificación interna.

Límite: Máximo 5 webhooks activos por organización.

Casos de uso:

Activar un flujo en Zapier o Make cuando se detecta un riesgo crítico
Recibir alertas en Slack o Microsoft Teams
Alimentar un agente IA (MCP client) con datos en tiempo real
Sincronizar con su sistema de gestión de tickets o incidentes

Nota: La configuración de Webhooks es técnica y está orientada a integradores. Se gestiona a través de la API de Sfero (MCP), no desde el panel de usuario.

Cómo Configurar sus Canales

Acceso a la Configuración

Ruta: Configuraciones → Notificaciones (disponible para roles Administrador y Gestor)

Agregar un Canal Email o WhatsApp

En la pantalla de Notificaciones, haga clic en “Agregar canal”.
Seleccione el tipo: Email o WhatsApp.
Ingrese el destino:
- Email: su dirección de correo electrónico
- WhatsApp: su número con prefijo de país (ej: +57 300 123 4567)
Seleccione el umbral de severidad:
- Solo Críticos – Recibe solo alertas 🔴
- Críticos y Altos – Recibe alertas 🔴 y 🟡
- Todos – Recibe todas las alertas
Haga clic en Guardar.

Configurar el Digest Periódico

En la sección Digest, seleccione la frecuencia: Diario o Semanal.
El email de destino es su correo de usuario registrado en Sfero.
Haga clic en Guardar.
Para generar un digest inmediato (fuera del ciclo automático), use el botón “Generar ahora”.

Gestionar sus Canales

Puede pausar un canal temporalmente sin eliminarlo (útil durante vacaciones).
Puede eliminar un canal en cualquier momento.
Los canales son personales: cada usuario gestiona los suyos de forma independiente. El Administrador no recibe las notificaciones del Gestor ni viceversa.

Flujo Completo: Del Hallazgo a la Alerta

Evaluador completa evaluación
        ↓
Sfero IA analiza (Triage + Insights)
        ↓
   ┌────────────────────────────────┐
   │         ¿Hay riesgo?           │
   └────────────────────────────────┘
         🔴 Crítico / 🟡 Alto
              ↓
   ┌──────────────────────────────────┐
   │   Entrega simultánea en paralelo │
   ├──────────────────────────────────┤
   │  📧 Email (si configurado)       │
   │  📱 WhatsApp (si configurado)    │
   │  🔔 Notificación interna Sfero   │
   │  🔗 Webhook (si registrado)      │
   └──────────────────────────────────┘
        ↓ (al finalizar el período)
   📊 Digest (diario o semanal)

Niveles de Severidad y Comportamiento

Nivel	Color	Email / WhatsApp	Digest	Webhook
Crítico	🔴	Siempre se envía (si umbral = `critical`, `high` o `any`)	Incluido	Siempre
Alto	🟡	Se envía si umbral = `high` o `any`	Incluido	Siempre
Normal	🟢	No se envía	Incluido en conteo	Siempre

Diferencia entre los Canales

Canal	Velocidad	Propósito	Ideal para
Email	Inmediato	Alerta detallada con contexto y CTA	Gestores con acceso frecuente al correo
WhatsApp	Inmediato	Alerta ultra-rápida para actuación en campo	Supervisores o responsables fuera de oficina
Digest	Periódico	Reporte ejecutivo consolidado	Gerentes que necesitan visión agregada
Webhook	Inmediato	Integración técnica con sistemas externos	Desarrolladores, integraciones, agentes IA

Preguntas Frecuentes

P: ¿Mis notificaciones son visibles para otros usuarios de mi organización? R: No. Los canales son estrictamente personales. Cada usuario recibe solo las alertas de sus propios canales configurados.

P: ¿Puedo tener Email y WhatsApp activos al mismo tiempo? R: Sí. Puede combinar todos los canales simultáneamente. Puede configurar umbrales distintos para cada uno (ej: WhatsApp solo para 🔴 Críticos, Email para todos).

P: ¿El Digest llega aunque no haya habido riesgos en el período? R: Sí. El Digest se genera siempre al finalizar el período. Si no hubo alertas, la narrativa reflejará la operación normal del período.

P: ¿Qué pasa si mi webhook falla y se auto-pausa? R: Recibirá una notificación interna en Sfero. Puede reactivarlo desde la configuración de API una vez que su endpoint esté operativo.

P: ¿Puedo usar el Digest en lugar de revisar el Dashboard? R: El Digest es un complemento, no un reemplazo. Entrega la síntesis del período, pero acciones como ver evidencias, asignar seguimientos o marcar alertas como atendidas requieren entrar al Dashboard.

P: ¿Puedo desactivar las notificaciones internas de la campanilla? R: Las notificaciones internas (centro de notificaciones dentro de Sfero) no se pueden desactivar; son el registro central de la actividad. Lo que puede controlar son los canales externos (email, WhatsApp, webhooks).

Solución de Problemas

Problema	Causa probable	Solución
No recibo emails de alerta	Umbral de severidad muy restrictivo	Cambie umbral a `Todos` y pruebe con una evaluación de prueba
Email llega a spam	Dominio del remitente no verificado	Revise la bandeja de spam; contacte al administrador para verificar el dominio de envío
WhatsApp no llega	Número sin prefijo de país	Edite el canal y asegúrese de incluir `+` y el código de país
Digest no llega el lunes	Frecuencia en `Diario` en lugar de `Semanal`	Revise la configuración de frecuencia en Notificaciones
Webhook no recibe eventos	Endpoint inactivo o mal configurado	Verifique que su URL responde con HTTP 200 y revise los logs de fallos

💡 Recomendación: Configure al menos dos canales complementarios: WhatsApp para alertas críticas inmediatas y el Digest semanal para la visión ejecutiva. Esta combinación cubre tanto la respuesta urgente como la planificación estratégica sin saturar de notificaciones individuales.