Conectar Microsoft Teams: guía paso a paso
Publica el resumen de la ejecución en un canal de Teams y, con NEXUS_TEAMS_NOTIFY=true, un mensaje por cada prueba fallida. Esta guía te lleva desde cero hasta una conexión verificada y enumera los errores que puedes encontrar con sus causas y soluciones.
Ú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 canal de Teams donde puedas añadir un flujo de trabajo.
- Una URL de webhook de Workflows para ese canal.
Obtén las credenciales
- En Teams, abre el menú ··· del canal → Flujos de trabajo y añade "Publicar en un canal cuando se recibe una solicitud de webhook".
- Copia la URL del webhook que te proporciona. Termina en logic.azure.com (conectores antiguos: webhook.office.com). 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 → Microsoft Teams.
- Pega la URL del webhook y pulsa Guardar & enviar prueba. Se envía un mensaje de prueba al canal.
- Activa
TEAMS_ENABLED. Para recibir un mensaje por cada prueba fallida, activa tambiénNEXUS_TEAMS_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" | TEAMS_WEBHOOK_URL está vacío. | Pega la URL del webhook en Configuración → Integraciones y guarda. |
"TEAMS_WEBHOOK_URL no es un webhook de Teams" | El valor no es una URL https de logic.azure.com o webhook.office.com. | Vuelve a copiar la URL del desencadenador "Publicar en un canal cuando se recibe una solicitud de webhook" del flujo de trabajo. |
| Una respuesta HTTP 4xx o 5xx de Teams | El flujo de trabajo se desactivó o eliminó, o su propietario se fue o perdió la licencia, por lo que ya no se ejecuta. | Abre el flujo de trabajo en Teams (Flujos de trabajo → administrar), actívalo o crea uno nuevo y guarda la nueva URL. |
| "no se pudo conectar con Teams (ENOTFOUND)" o "no respondió en 20 s" | Este equipo no puede conectarse con Microsoft: 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 | TEAMS_ENABLED es false, o solo está activado el resumen de ejecución: los mensajes por prueba requieren NEXUS_TEAMS_NOTIFY=true. | Activa ambos interruptores. |
Claves de configuración
| Clave | Qué hace | Valor válido | Cómo comprobarlo |
|---|---|---|---|
TEAMS_ENABLED | Enviar alertas a Microsoft Teams | true o false | Activa esta opción cuando llegue el mensaje de prueba. |
TEAMS_WEBHOOK_URL | Canal de Teams para alertas (secreto, guardado solo en este equipo) | Una URL https://…logic.azure.com o …webhook.office.com | Enviar mensaje de prueba publica en el canal. |
NEXUS_TEAMS_NOTIFY | Alerta de Teams 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, Slack, 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.