Conectar Telegram: guía paso a paso
Envía alertas cuando se produce un fallo (una por prueba con NEXUS_TELEGRAM_NOTIFY=true) y los informes y archivos que decidas compartir, a través de tu propio bot. No hay un bot compartido. Esta guía te lleva desde cero hasta verificar la conexión 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
- Una cuenta de Telegram.
- Tu propio bot, creado una sola vez con @BotFather, y su token.
- Un teléfono o la aplicación de Telegram para escanear el QR de vinculación.
- Antes de activarlo: Telegram puede recibir archivos como informes y PDF, que se envían a los servidores de Telegram. En un entorno regulado, consulta primero con tu equipo de cumplimiento normativo.
Obtén las credenciales
- En Telegram, abre https://t.me/BotFather y envía /newbot. Asigna un nombre y un nombre de usuario al bot.
- BotFather responde con el token del bot (por ejemplo 123456:ABC…). Cópialo.
- 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 → Conectar Telegram.
- Pega el token del bot y guarda. Aparecerá el QR de vinculación.
- Escanea el QR con tu teléfono y pulsa Iniciar en Telegram. En unos segundos, Studio muestra "las alertas se envían al chat …" y el bot dice "Conectado a Nexus StudioQA."
- Activa
TELEGRAM_ENABLED. Para recibir una alerta por cada prueba fallida, activa tambiénNEXUS_TELEGRAM_NOTIFY.
Comprueba que funciona
- Tras escanearlo, el bot envía "Conectado a Nexus StudioQA. Las pruebas fallidas se notificarán aquí." a tu chat.
- Studio muestra "las alertas se envían al chat" con el chat enmascarado.
Errores habituales
| Lo que ves | Causa | Solución |
|---|---|---|
| "Telegram está desactivado" | TELEGRAM_ENABLED es false, y la vinculación requiere que esté activado. | Activa TELEGRAM_ENABLED y vuelve a pulsar Conectar Telegram. |
| "No hay token del bot" | TELEGRAM_TOKEN está vacío. | Pega el token de BotFather en Configuración → Integraciones y guarda. |
| "Telegram: No autorizado" (o "No encontrado") | El token del bot es incorrecto, se revocó en BotFather o se cortó al copiarlo. | Envía /token a BotFather para obtener el token de nuevo (o crea un bot nuevo), y guárdalo. |
| "El QR caducó antes de que se escaneara" | El QR solo es válido durante unos minutos. | Pulsa Conectar Telegram para generar uno nuevo y escanéalo de inmediato. |
| Se escaneó el QR pero Studio sigue esperando | Al escanear se abrió el chat pero no se pulsó Iniciar, o se cerró la ventana de Studio. | Pulsa Iniciar en el chat del bot. Si sigue esperando, genera un QR nuevo. |
| "no se pudo conectar con Telegram (ENOTFOUND)" o "no respondió en 20 s" | Este equipo no puede conectarse a api.telegram.org: una VPN, un cortafuegos o un proxy lo impiden, o no hay conexión de red. | Comprueba la conexión de red desde el mismo equipo y vuelve a intentarlo. |
| No llega ninguna alerta tras un fallo | TELEGRAM_ENABLED es false, no hay ningún chat vinculado o las alertas por prueba están desactivadas (NEXUS_TELEGRAM_NOTIFY). | Vincula un chat, y activa ambos interruptores. |
Claves de configuración
| Clave | Qué hace | Valor válido | Cómo comprobarlo |
|---|---|---|---|
TELEGRAM_ENABLED | Enviar alertas a Telegram | true o false | Debe estar activado para generar el QR de vinculación. |
TELEGRAM_TOKEN | Código de acceso del bot de Telegram (secreto, guardado solo en este equipo) | El token del bot de BotFather, como 123456:ABC…, en una sola línea | El QR solo aparece si Telegram lo acepta. |
TELEGRAM_CHAT_ID | Chat de Telegram para alertas | Se rellena al vincular mediante QR; no lo escribas | Studio muestra "las alertas se envían al chat …". |
NEXUS_TELEGRAM_NOTIFY | Alerta de Telegram por cada fallo | true o false | Llega una alerta por cada prueba que falla. |
Más: todas las integraciones, la guía de configuración, solución de problemas. Otras guías: Jira Cloud, Azure Boards, Slack, Microsoft Teams, 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.