Notificaciones de Slack

Clarive puede enviar notificaciones automaticas a canales de Slack cuando ocurren eventos en sus proyectos. Las notificaciones se configuran por proyecto y pueden activarse por eventos de topics, jobs, comentarios y repositorios.

Requisitos previos¶

Antes de configurar las notificaciones de Slack, necesita una URL de Incoming Webhook de Slack. Cree una en su espacio de trabajo de Slack en Apps > Incoming Webhooks.

Configurar notificaciones de Slack¶

Navegue a la configuracion de su proyecto y seleccione la pestana Notificaciones. Desde alli puede crear, editar, activar/desactivar, probar y eliminar reglas de notificacion de Slack.

Crear una notificacion¶

Haga clic en Nueva Notificacion y complete:

Nombre de Conexion - Un nombre descriptivo para esta notificacion (ej. "Alertas del Canal del Equipo").
URL del Webhook - La URL del Incoming Webhook de Slack de su espacio de trabajo.
Usuario (opcional) - Sobreescribir el nombre de usuario del bot por defecto para los mensajes.

Luego seleccione que eventos deben activar una notificacion:

Topic creado - Cuando se crea un nuevo topic en el proyecto.
Cambio de estado del topic - Cuando un topic cambia a un nuevo estado.
Nuevo comentario - Cuando se publica un comentario publico en un topic.
Nuevo comentario interno - Cuando se publica un comentario interno en un topic.
Job iniciado - Cuando comienza un job de despliegue.
Job finalizado (exito) - Cuando un job se completa exitosamente.
Job finalizado (error) - Cuando un job falla.
Accion de job - Cuando un job se pausa, queda atrapado o requiere aprobacion.
Repositorio actualizado - Cuando se hace push de codigo a un repositorio del proyecto.

Probar una notificacion¶

Despues de crear una notificacion, haga clic en el boton Probar para enviar un mensaje de prueba a su canal de Slack. Esto verifica que la URL del webhook sea correcta y el canal sea accesible.

Activar y desactivar¶

Use el interruptor junto a cada notificacion para activarla o desactivarla sin eliminar la configuracion.

Outgoing Webhooks de Slack¶

Clarive tambien soporta Outgoing Webhooks de Slack, que permiten publicar comentarios en topics desde Slack. Configure un recurso SlackOutgoingWebhook con el token proporcionado por Slack, luego use la palabra clave seguida del MID del topic y su comentario:

cla 12345 Este es mi comentario desde Slack

El endpoint del outgoing webhook es:

POST /slackwebhook/api?path=outgoing_webhook

Topics multi-proyecto¶

Cuando un topic pertenece a multiples proyectos, Clarive verifica todas las configuraciones de notificacion de los proyectos. El mensaje de Slack mostrara el nombre del proyecto correcto segun la regla de notificacion que coincida.