Canales de notificación¶
Los Canales definen cómo y dónde recibes notificaciones de Nexus.
¿Qué son los canales?¶
Un canal es un destino para notificaciones:
- Slack
- Microsoft Teams
- Discord
- Webhooks personalizados
- SMS
Vista de canales¶
┌─────────────────────────────────────────────────────────────────┐
│ Canales de notificación [+ Nuevo] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Canal │ Tipo │ Eventos │ Estado │ Acciones │
├──────────────────┼──────────┼──────────────┼────────┼───────────┤
│ 📧 Equipo Dev │ Email │ Errores │ ✅ │ [Editar] │
│ 💬 #alertas │ Slack │ Todos │ ✅ │ [Editar] │
│ 🔔 Webhook CI │ Webhook │ Ejecuciones │ ✅ │ [Editar] │
│ 📱 SMS Críticos │ SMS │ Críticos │ ⏸️ │ [Editar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Tipos de canal¶
Email¶
Envía notificaciones por correo electrónico.
┌─────────────────────────────────────────────────────────────────┐
│ Configurar canal Email │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Nombre del canal │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Equipo Desarrollo │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Destinatarios │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ dev@empresa.com, ops@empresa.com │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ Separar múltiples emails con comas │
│ │
└─────────────────────────────────────────────────────────────────┘
Slack¶
Envía mensajes a canales de Slack.
┌─────────────────────────────────────────────────────────────────┐
│ Configurar canal Slack │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Nombre del canal │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Alertas Producción │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Webhook URL * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ https://hooks.slack.com/services/T00/B00/xxx │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Canal de Slack │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ #alertas-nexus │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ [Probar] [Guardar] │
└─────────────────────────────────────────────────────────────────┘
Microsoft Teams¶
┌─────────────────────────────────────────────────────────────────┐
│ Configurar canal Teams │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Webhook URL de Teams * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ https://outlook.office.com/webhook/xxx │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Discord¶
┌─────────────────────────────────────────────────────────────────┐
│ Configurar canal Discord │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Webhook URL de Discord * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ https://discord.com/api/webhooks/xxx/yyy │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Webhook personalizado¶
Para integraciones custom:
┌─────────────────────────────────────────────────────────────────┐
│ Configurar Webhook │
├─────────────────────────────────────────────────────────────────┤
│ │
│ URL del Webhook * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ https://mi-api.com/webhooks/nexus │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Método HTTP │
│ ○ POST ○ PUT │
│ │
│ Headers (JSON) │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ {"Authorization": "Bearer xxx"} │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Eventos notificables¶
Configura qué eventos envían notificaciones:
| Evento | Descripción |
|---|---|
| Ejecución exitosa | Tarea completada correctamente |
| Ejecución fallida | Tarea terminó con error |
| Ejecución iniciada | Tarea comenzó a ejecutarse |
| Alerta crítica | Errores de sistema |
| Usuario invitado | Nuevo usuario aceptó invitación |
| Issue creado | Nuevo issue en backlog |
Configurar eventos por canal¶
┌─────────────────────────────────────────────────────────────────┐
│ Eventos - Canal: Alertas Slack │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Ejecuciones: │
│ ☑️ Fallidas │
│ ☐ Exitosas │
│ ☐ Iniciadas │
│ │
│ Sistema: │
│ ☑️ Alertas críticas │
│ ☑️ Errores de sistema │
│ │
│ Backlog: │
│ ☑️ Issues críticos │
│ ☐ Todos los issues │
│ │
│ Filtrar por proyecto: │
│ ○ Todos los proyectos │
│ ● Solo proyectos seleccionados: │
│ ☑️ Producción │
│ ☐ Desarrollo │
│ │
└─────────────────────────────────────────────────────────────────┘
Probar canal¶
Antes de guardar:
- Haz clic en Probar
- Se envía notificación de prueba
- Verifica que llegó correctamente
- Si falla, revisa la configuración
Pausar canal¶
Para silenciar temporalmente:
- En el canal, haz clic en Pausar
- Las notificaciones se detienen
- Reactiva cuando quieras
Historial de notificaciones¶
Consulta notificaciones enviadas:
┌─────────────────────────────────────────────────────────────────┐
│ Historial - Alertas Slack │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Fecha │ Evento │ Estado │
├────────────────────┼─────────────────────┼──────────────────────┤
│ 2024-01-15 10:30 │ Ejecución fallida │ ✅ Enviado │
│ 2024-01-15 09:15 │ Alerta crítica │ ✅ Enviado │
│ 2024-01-14 18:00 │ Issue crítico │ ❌ Error de red │
│ │
└─────────────────────────────────────────────────────────────────┘
Buenas prácticas¶
No saturar canales
Configura solo eventos importantes para evitar "notification fatigue".
Canales separados por severidad
- Canal para errores críticos (siempre activo)
- Canal para información general (filtrable)
Probar antes de confiar
Siempre prueba los canales después de configurarlos.
Siguiente: Branding - Personalización visual.