Saltar al contenido principal
Wirespeed puede publicar notificaciones en un canal de Slack. Cree un webhook entrante para el canal en una aplicación de Slack y, a continuación, añada su URL a Wirespeed como canal de Slack. Gestionar canales de Slack, enviar mensajes de prueba y elegir qué notificaciones van a cada canal requiere el rol de administrador. Otros usuarios pueden abrir un canal para ver un formulario de solo lectura, su estado y su pestaña Historial de entregas, sin Enviar prueba. Los canales de Slack son para notificaciones de todo el equipo. Wirespeed no necesita acceso a su espacio de trabajo de Slack más allá del webhook, por lo que no hay instalación OAuth ni bot que invitar al canal. Para flujos de trabajo creados en el Workflow Builder de Slack, o para una carga útil personalizada, use en su lugar el canal de notificación Webhooks. Las URL de webhook de flujos de trabajo de Slack no se aceptan aquí.

Tipos de notificación compatibles

Los canales de Slack pueden recibir estos tipos de notificación:
  • Nuevo escalado de caso
  • Nuevo caso contenido automáticamente
  • Nuevo evento de seguridad del sistema
  • Nuevo defecto crítico
  • Salud de la integración
  • Cuenta y facturación
El Resumen de actividad se envía solo por correo electrónico. Los canales de Slack reciben cada notificación en tiempo real; los ajustes de frecuencia se aplican solo al correo electrónico.

Antes de empezar

Necesita permiso para crear aplicaciones en su espacio de trabajo de Slack, o un administrador que pueda crear el webhook por usted.

Paso 1: Crear el webhook en Slack

  1. Vaya a api.slack.com/apps y seleccione Create New App y, a continuación, From scratch. Asigne un nombre a la aplicación (por ejemplo, «Wirespeed») y elija su espacio de trabajo. Si ya tiene una aplicación para Wirespeed, ábrala en su lugar.
  2. En la configuración de la aplicación, abra Incoming Webhooks y active Activate Incoming Webhooks.
  3. Seleccione Add New Webhook to Workspace, elija el canal en el que Wirespeed debe publicar y seleccione Allow.
  4. Copie la Webhook URL. Empieza por https://hooks.slack.com/services/.
Cada webhook publica en el único canal que eligió al crearlo. Para publicar en varios canales, añada un webhook para cada uno y guarde cada uno como su propio canal de Slack en Wirespeed.
Slack puede cambiar estas pantallas. Si lo que ve no coincide, siga la guía de Slack: Sending messages using incoming webhooks.
La URL del webhook es la única credencial necesaria para publicar en el canal: cualquiera que la tenga puede publicar mensajes allí. Trátela como una contraseña y no la pegue en tickets, chats ni capturas de pantalla. Slack también puede revocar una URL de webhook que encuentre publicada de forma pública. Si se filtra, elimine el webhook en la configuración de su aplicación de Slack, cree uno nuevo y pegue su URL en el canal de Wirespeed.

Paso 2: Añadir el canal en Wirespeed

  1. Vaya a Configuración > Notificaciones.
  2. En la tarjeta Slack, seleccione Conectar. Si su equipo ya tiene canales de Slack, seleccione en su lugar el icono de engranaje (⚙, Gestionar canales de Slack).
  3. Seleccione Añadir canal de Slack.
  4. Introduzca un Nombre. Asigne a cada webhook el nombre de su canal de Slack, por ejemplo #security-alerts, para poder distinguirlos. El nombre se muestra en el desplegable de Slack al configurar una notificación.
  5. Pegue la URL del webhook que copió en el paso 1.
  6. Opcionalmente, seleccione Enviar prueba para publicar un mensaje de prueba.
  7. Seleccione Añadir canal de Slack en el panel. Permanece deshabilitado hasta que se rellenan ambos campos.
Los canales se añaden y editan en un panel sobre la lista. Ciérrelo con el botón de cerrar, Cancelar, un clic fuera del panel o Esc. Si el panel tiene cambios sin guardar, Wirespeed pregunta antes de descartarlos, incluso cuando abandona la página. Wirespeed almacena la URL del webhook cifrada. Tras guardarla, puede sustituirla pero no verla. Cada URL de webhook solo se puede guardar como un único canal de Slack por equipo. Al editar un canal, el campo URL del webhook muestra •••••••• en lugar de la URL guardada. Déjelo sin cambios para conservar la URL guardada, o pegue una URL nueva para sustituirla.

Enviar prueba

Enviar prueba envía una notificación de ejemplo a este webhook. Si ha introducido una URL nueva, la prueba usa esa URL; de lo contrario, usa la guardada. Cambiar la URL borra el resultado anterior. Aceptada por Slack significa que Slack aceptó la solicitud y el mensaje debería aparecer en el canal en breve. Wirespeed permite hasta 5 envíos de prueba por equipo y por minuto.

Paso 3: Elegir qué notificaciones enviar

  1. En Configuración > Notificaciones, busque el tipo de notificación en la tarjeta Notificaciones de la cuenta del equipo.
  2. Seleccione el icono de engranaje (⚙, Configurar) para abrir la página de configuración del tipo de notificación.
  3. Active el interruptor Canal de Slack y, a continuación, elija uno de sus canales en Seleccione un canal de Slack. Añada más canales, hasta 10, con Añadir otro canal.
  4. Seleccione Guardar. Wirespeed guarda todas las secciones y vuelve a la pestaña Notificaciones.
Un canal que ya esté seleccionado para este tipo de notificación, que haya desactivado o que Wirespeed haya desactivado tras entregas fallidas no se puede seleccionar; el menú lo etiqueta como Ya seleccionado, Desactivado o Desactivado tras errores. Para volver a activar un canal o resolverlo, seleccione Gestionar canales de Slack en la parte inferior del menú. Si su equipo aún no tiene canales de Slack, la sección se titula Slack y muestra Conectar en su lugar. Los proveedores de servicios configuran los equipos cliente de la misma forma que las bandejas de correo electrónico. Las suscripciones de canales de Slack de su equipo de proveedor de servicios funcionan como sus demás suscripciones de proveedor de servicios: vigilan automáticamente todas las cuentas de sus clientes, de modo que el canal recibe notificaciones de cada equipo cliente y todos los miembros las ven. Para enviar las notificaciones de un único equipo cliente a su propio canal, configúrelo mientras consulta ese equipo cliente. Consulte Comportamiento del proveedor de servicios.

Estado del canal

La página Canales de Slack enumera cada canal con su estado. Cualquier miembro de su equipo con acceso a la configuración de Notificaciones puede ver el estado, el recuento de fallos, el último error y el historial de entregas. Solo los administradores pueden cambiar un canal.

Desactivación automática

Wirespeed desactiva un canal de Slack tras tres entregas fallidas sin una entrega correcta entremedias, contabilizando solo estos fallos:
  • Slack rechaza la URL o los permisos del webhook (HTTP 401 o 403, por ejemplo invalid_token o action_prohibited).
  • El webhook ya no existe, o se eliminó su canal (HTTP 404 o 410, por ejemplo no_service o channel_not_found).
  • Slack informa de que el webhook ya no puede publicar, en otro error 4xx: el canal se archivó (channel_is_archived), la aplicación o el espacio de trabajo se eliminó o desactivó (no_active_hooks, no_team, team_disabled), o se deniega la publicación allí (posting_to_general_channel_denied, user_not_found).
Una entrega correcta reinicia el contador. Las caídas de Slack, los límites de velocidad y los tiempos de espera nunca cuentan para desactivar un canal, y tampoco reinician el contador; Wirespeed reintenta esas entregas. Los envíos de prueba no cuentan. Cuando se desactiva un canal, se pausan sus suscripciones. Se reanudan cuando reactive el canal.

Reactivar un canal

  1. En la página Canales de Slack, seleccione Reactivar en el canal desactivado. El canal se abre mostrando un banner rojo con el último error y cómo corregirlo.
  2. Corrija la causa en Slack (consulte Solución de problemas). Si creó un webhook nuevo, pegue su URL en URL del webhook.
  3. Seleccione Reactivar en el banner rojo o Enviar prueba encima del pie (cualquiera de los dos muestra Reintentar tras una prueba fallida) para enviar un mensaje de prueba a la URL que se guardará. Si cambió la URL, la prueba usa la URL nueva.
  4. Cuando la prueba se realice correctamente, el banner de error se vuelve gris y aparece un banner verde El canal está en un estado saludable. Seleccione Reactivar en el banner verde, o Guardar cambios en el pie, para guardar.
Se requiere una prueba correcta. Guardar cambios permanece deshabilitado hasta que la prueba de la URL que se guardará se realice correctamente, y editar la URL borra el resultado, de modo que debe probar de nuevo. Si el problema vuelve tras reactivar, el canal se desactiva de nuevo tras tres entregas fallidas más. Para pausar o reanudar un canal usted mismo, use su interruptor Activado.

Historial de entregas

Abra un canal seleccionando su fila, o seleccionando el menú … (Acciones) de la fila y, a continuación, Editar (Ver si no es administrador), y seleccione la pestaña Historial de entregas. La pestaña muestra las 100 entregas, envíos de prueba y cambios de estado más recientes, con la Hora, el Evento, el Tipo, el Resultado y el Intento de cada uno. Solo aparecen las pruebas de la URL guardada del canal. Una prueba de una URL que ha escrito pero no ha guardado no se registra.

Límites

Cuando Slack responde que un webhook ha superado el límite (HTTP 429), Wirespeed pausa las entregas a ese canal durante el tiempo de espera que pide Slack (como máximo 5 minutos, y 30 segundos cuando Slack no lo indica) y, a continuación, envía los mensajes pendientes. La limitación no cuenta para desactivar el canal. Una notificación que no se puede entregar en unas 6 horas se descarta en lugar de llegar tarde. El texto más largo de lo que permite Slack se acorta con puntos suspensivos. Un mensaje con más contenido del límite de bloques de Slack se corta y termina con una nota para ver los detalles completos en Wirespeed.

Solución de problemas

Errores al guardar la URL

Resultados de Enviar prueba

Canales con fallos o desactivados

La información emergente del estado y el panel que abre Reactivar muestran el último error y una pista.

Editar, sustituir o eliminar un canal

  • Cambiar el nombre o sustituir la URL: seleccione la fila del canal, o el menú … (Acciones) de la fila y, a continuación, Editar. Cambie el nombre o pegue una URL nueva y, a continuación, seleccione Actualizar. Actualizar permanece deshabilitado hasta que cambie algo. Deje la URL como está para conservar la actual. Sustituir la URL de un canal con fallos borra su estado de error. Un canal que usted desactivó permanece desactivado.
  • Los canales desactivados tras entregas fallidas se abren con un botón Reactivar en el banner rojo que envía una prueba, y el botón de guardar es Guardar cambios. Permanece deshabilitado hasta que una prueba de la URL que se guardará se realice correctamente. Guardar entonces reactiva el canal, con o sin una URL nueva.
  • Eliminar: seleccione el menú … (Acciones) de la fila y, a continuación, Eliminar. También puede abrir el canal, seleccionar Eliminar canal de Slack en la parte inferior del panel y confirmar. Eliminar un canal también elimina las suscripciones que le envían notificaciones, y no se puede deshacer.