Conectar Slack: guía paso a paso
Publica el resumen de la ejecución en un canal y, con NEXUS_SLACK_NOTIFY=true, un mensaje por cada prueba fallida, inestable, de caos o de regresión visual. Los mensajes sobre fallos incluyen un enlace a su incidencia de Jira cuando existe. Esta guía te lleva desde cero hasta una conexión verificada y enumera los errores que puedes encontrar con su causa y solución.
Última actualización:
Mantén tus credenciales en privado. Nunca pegues un token, una clave, una contraseña ni una URL de webhook en un chat. Introdúcelos solo en Studio → Configuración → Integraciones, donde se guardan en el archivo .env de tu espacio de trabajo y se muestran como puntos. Lo mismo se aplica a un asistente de IA: puede guiarte por estos pasos, pero nunca necesita tu token.
Qué necesitas
- Un espacio de trabajo de Slack donde puedas añadir una aplicación.
- Una URL de webhook entrante para el canal que deba recibir los mensajes.
Obtén las credenciales
- En Slack, crea una aplicación con un webhook entrante (https://api.slack.com/messaging/webhooks) y elige el canal.
- Copia la URL del webhook. Empieza por https://hooks.slack.com/services/. La propia URL es el secreto.
- Mantenlo en el portapapeles. No lo pegues en ningún sitio excepto en Studio (siguiente paso).
Conéctalo en Studio
- En Studio, abre Configuración → Integraciones → Slack.
- Pega la URL del webhook y pulsa Guardar & enviar prueba. Se envía un mensaje de prueba al canal.
- Activa
SLACK_ENABLED. Para recibir un mensaje por cada prueba fallida, activa tambiénNEXUS_SLACK_NOTIFY.
Comprueba que funciona
- Enviar mensaje de prueba responde "Enviado." y el mensaje aparece en el canal.
- Ejecuta cualquier prueba. El resumen de la ejecución llega al canal.
Errores habituales
| Lo que ves | Causa | Solución |
|---|---|---|
| "No hay webhook" | SLACK_WEBHOOK_URL está vacío. | Pega la URL del webhook en Configuración → Integraciones y guarda. |
"SLACK_WEBHOOK_URL no es un webhook entrante de Slack" | El valor no empieza por https://hooks.slack.com/services/. | Vuelve a copiar la URL del webhook desde la página de webhooks entrantes de tu aplicación de Slack. |
| HTTP 404 "no_service" o HTTP 403 "invalid_token" | El webhook se revocó o eliminó, o la aplicación se eliminó del espacio de trabajo. | Crea un nuevo webhook entrante y guarda la nueva URL. |
| HTTP 404 "channel_not_found" o HTTP 410 "channel_is_archived" | El canal en el que publica el webhook se eliminó o archivó. | Crea un nuevo webhook para un canal activo. |
| "no se pudo conectar con Slack (ENOTFOUND)" o "no respondió en 20 s" | Este equipo no puede conectarse con Slack: una VPN o un proxy, o falta de conexión de red. | Comprueba la conexión de red desde el mismo equipo y vuelve a intentarlo. |
| La prueba funciona pero los fallos no se publican | SLACK_ENABLED tiene el valor false, o solo está activado el resumen de la ejecución: los mensajes por prueba requieren NEXUS_SLACK_NOTIFY=true. | Activa ambos interruptores. |
Claves de configuración
| Clave | Qué hace | Valor válido | Cómo comprobarlo |
|---|---|---|---|
SLACK_ENABLED | Enviar alertas a Slack | true o false | Activa esta opción cuando llegue el mensaje de prueba. |
SLACK_WEBHOOK_URL | Canal de Slack para alertas (secreto, guardado solo en este equipo) | https://hooks.slack.com/services/… (no se acepta nada más) | Enviar mensaje de prueba publica en el canal. |
NEXUS_SLACK_NOTIFY | Alerta de Slack por cada fallo | true o false | Llega un mensaje por cada prueba fallida, no solo el resumen de la ejecución. |
Más: todas las integraciones, la guía de configuración, solución de problemas. Otras guías: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
¿Sigues sin poder avanzar? Escribe a [email protected] e incluye la línea exacta del error que muestra Studio. No incluyas ningún token.