Notificaciones

Configura notificaciones multicanal para incidentes, mantenimientos y alertas.

Vista General

ReliaPulse soporta múltiples canales de notificación:

• Email - Notificaciones por email SMTP
• SMS - Alertas por mensaje de texto
• Slack - Mensajes a workspace de Slack
• Discord - Webhooks de canal de Discord
• Microsoft Teams - Conectores de canal de Teams
• Webhooks - Endpoints HTTP personalizados

Canales de Notificación

Configurar Canales

1. Navega a Configuración > Notificaciones
2. Haz clic en "Añadir Canal"
3. Selecciona tipo de canal
4. Configura ajustes
5. Prueba la conexión
6. Guarda

Email

Envía notificaciones vía SMTP:

Prueba:

# Probar configuración de email
curl -X POST http://localhost:3000/api/v1/notification-channels/{id}/test \
  -H "Authorization: Bearer sk_live_xxx"

Slack

Envía mensajes a canales de Slack:

1. Crea una App de Slack o usa incoming webhooks
2. Obtén la URL del webhook
3. Configura en ReliaPulse:

Formato del mensaje:

• Formato enriquecido con colores de estado
• Detalles de componente e incidente
• Botones de acción (si la app está configurada)

Discord

Envía mensajes a canales de Discord:

1. Ve a configuración del canal → Integraciones → Webhooks
2. Crea un webhook y copia la URL
3. Configura:

Formato del mensaje:

• Mensajes embebidos con colores
• Iconos de estado
• Timestamp y detalles

Microsoft Teams

Envía tarjetas a canales de Teams:

1. En Teams, ve al canal → Conectores
2. Añade "Incoming Webhook"
3. Configura y copia la URL
4. Añade a ReliaPulse:

Formato del mensaje:

• Tarjetas adaptivas
• Botones de acción
• Indicadores de estado

SMS

Envía mensajes de texto vía Twilio:

Webhooks Personalizados

Envía datos a cualquier endpoint HTTP:

Variables de plantilla de payload:

{
  "type": "{{event_type}}",
  "incident": {
    "id": "{{incident.id}}",
    "title": "{{incident.title}}",
    "status": "{{incident.status}}"
  },
  "timestamp": "{{timestamp}}"
}

Eventos de Notificación

Eventos de Incidentes

Eventos de Mantenimiento

Eventos de Monitor

Configuración de Canal

Filtrado de Eventos

Elige qué eventos disparan notificaciones:

1. Edita el canal
2. Bajo "Eventos", selecciona eventos a notificar
3. Guarda

Filtrado de Componentes

Limita notificaciones a componentes específicos:

1. Edita el canal
2. Bajo "Componentes", selecciona cuáles componentes
3. Deja vacío para todos los componentes

Filtrado de Impacto

Filtra por severidad del incidente:

• Incidentes menores
• Incidentes mayores
• Solo incidentes críticos

Plantillas de Notificación

Personaliza contenido de notificaciones:

Plantillas de Email

1. Navega a Configuración > Branding de Email
2. Personaliza:
   • Logo
   • Colores
   • Texto de Header/Footer
   • CSS personalizado

Plantillas de Mensaje

Crea plantillas para mensajes consistentes:

Asunto: [{{status}}] {{title}}

Estado: {{status}}
Impacto: {{impact}}
Componentes: {{components}}

{{message}}

Ver detalles: {{url}}

Probar Notificaciones

Botón de Prueba

1. Abre un canal de notificación
2. Haz clic en "Enviar Prueba"
3. Verifica recepción

Incidente de Prueba

1. Crea un incidente de prueba
2. Márcalo como test/interno
3. Verifica notificaciones
4. Elimina el incidente

Notificaciones a Suscriptores

Los suscriptores reciben notificaciones basadas en sus preferencias:

Ve Suscriptores para detalles.

Rate Limiting

Previene spam de notificaciones:

Acceso API

Listar Canales

curl http://localhost:3000/api/v1/notification-channels \
  -H "Authorization: Bearer sk_live_xxx"

Crear Canal

curl -X POST http://localhost:3000/api/v1/notification-channels \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Slack Ingeniería",
    "type": "slack",
    "config": {
      "webhookUrl": "https://hooks.slack.com/xxx"
    },
    "events": ["incident.created", "incident.updated", "incident.resolved"]
  }'

Probar Canal

curl -X POST http://localhost:3000/api/v1/notification-channels/{id}/test \
  -H "Authorization: Bearer sk_live_xxx"

Solución de Problemas

Notificaciones No Se Envían

1. Verifica que el canal está habilitado
2. Verifica que el evento está seleccionado
3. Revisa filtro de componentes
4. Revisa logs de notificación
5. Prueba el canal

Notificaciones Retrasadas

1. Verifica que el worker está corriendo
2. Revisa conexión a Redis
3. Verifica backlog de cola
4. Monitorea logs del worker

Destinatarios Incorrectos

1. Verifica configuración del suscriptor
2. Revisa filtros de componentes
3. Revisa reglas de notificación

Mejores Prácticas

Organización de Canales

• Crea canales por equipo/propósito
• Usa nombres descriptivos
• Documenta propósito de notificación

Selección de Eventos

• Comienza solo con eventos críticos
• Añade más según sea necesario
• Evita fatiga de notificaciones

Pruebas

• Prueba después de cualquier cambio de configuración
• Usa incidentes de prueba regularmente
• Verifica todos los canales periódicamente

Documentación Relacionada

• Suscriptores - Suscripciones de usuarios
• On-Call - Escalamiento de alertas
• Incidentes - Notificaciones de incidentes