> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Canales de Slack

> Envíe notificaciones del equipo a un canal de Slack con un webhook entrante

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](https://docs.wirespeed.co/es/settings/notifications.md#notification-frequency) 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](https://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.

> [!NOTE]
>
> Slack puede cambiar estas pantallas. Si lo que ve no coincide, siga la guía de Slack: [Sending messages using incoming webhooks](https://api.slack.com/messaging/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](https://docs.wirespeed.co/es/settings/notifications.md#service-provider-behavior).

## 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.

| Estado | Qué ve | Significado |
| - | - | - |
| **Activo** | El interruptor **Activado** está activado | Se entregan las notificaciones. |
| **Con fallos** | Un icono de advertencia ámbar junto al nombre | Entregas recientes fallaron por un motivo que cuenta para desactivar el canal. La información emergente muestra cuántas, por ejemplo «2 de 3 entregas fallidas». |
| **Desactivado** | El interruptor **Activado** está desactivado. Los canales con suscripciones también muestran **Inactivo mientras está desactivado** bajo el recuento de suscripciones | Ha pausado el canal. No se envían notificaciones hacia él. |
| **Desactivado tras entregas fallidas** | Un icono rojo junto al nombre y un botón **Reactivar**. Los canales con suscripciones también muestran **Inactivo hasta que se reactive** | Wirespeed desactivó el canal y pausó sus suscripciones. |

### 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](#troubleshooting)). 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

| Mensaje | Solución |
| - | - |
| Empieza por [https://hooks.slack.com/services/](https://hooks.slack.com/services/). Las URL de webhook de Workflow Builder no son compatibles. | La URL no es una URL de webhook entrante de Slack. Las URL de Workflow Builder esperan una carga útil distinta, y una URL copiada de la barra de direcciones del navegador no es el webhook. Copie la **Webhook URL** de la página **Incoming Webhooks** de la aplicación, como se describe en el [paso 1](#step-1-create-the-webhook-in-slack). Para flujos de trabajo y cargas útiles personalizadas, use el canal de notificación Webhooks. |
| Introduzca una URL válida | Pegue la URL exactamente como la proporcionó Slack. |
| La URL del webhook debe empezar por https\:// | Copie la URL de nuevo sin editarla. |
| La URL del webhook debe usar el puerto https predeterminado | Copie la URL de nuevo sin editarla. |
| La URL del webhook no debe contener un nombre de usuario ni una contraseña | Copie la URL de nuevo sin editarla. |
| Esta URL de webhook de Slack ya está guardada como otro canal de Slack | Use el canal existente, o cree un segundo webhook para un segundo canal. |
| Ya existe un canal de Slack llamado «…» | Los nombres de canal deben ser únicos dentro de un equipo, sin distinguir mayúsculas. Elija otro nombre. |

### Resultados de Enviar prueba

| Mensaje | Solución |
| - | - |
| Slack ha rechazado la solicitud (401, 403, 404 o un error como `no_service`) | Se revocó el webhook, se eliminó la aplicación del espacio de trabajo o se eliminó o archivó el canal. Cree un webhook nuevo y pegue su URL. |
| Sin respuesta de Slack en 10 segundos, o No se ha podido contactar con Slack | Slack está lento o no disponible. Inténtelo de nuevo más tarde. |
| Demasiadas notificaciones de prueba | Espere el tiempo indicado e inténtelo de nuevo. |

### Canales con fallos o desactivados

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

| Pista | Causa | Solución |
| - | - | - |
| El canal de Slack se eliminó o archivó, o el webhook se revocó. | Slack devolvió `channel_not_found`, `no_service` o `channel_is_archived`. | Cree un nuevo webhook entrante para el canal, seleccione **Reactivar** en el canal, pegue la URL, envíe una prueba correcta y guarde con **Guardar cambios**. |
| Slack bloqueó la solicitud. | Slack devolvió `action_prohibited`. Se eliminó la aplicación del espacio de trabajo, se revocó el webhook o un ajuste del espacio de trabajo lo bloquea. | Cree un nuevo webhook entrante y pegue su URL. Si eso no ayuda, pregunte al administrador de su espacio de trabajo de Slack si algún ajuste restringe la aplicación. |
| La URL guardada no se puede usar. | Wirespeed no pudo usar la URL guardada. Esto nunca cuenta para desactivar un canal. | Pegue la URL de nuevo. Contacte con el soporte si sigue ocurriendo. |
| Compruebe el webhook en la configuración de su aplicación de Slack. | Otro error. | Abra la página **Incoming Webhooks** de la aplicación, corrija el problema, seleccione **Reactivar** en el canal, envíe una prueba correcta y guarde con **Guardar cambios**. |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.