Cómo obtener el token de un bot de Telegram (y qué hacer si se filtra)

Actualizado: 29 de octubre de 2026 · 6 min de lectura

El token de un bot de Telegram es la clave de acceso que te entrega @BotFather al crear el bot. Para obtener el token de un bot nuevo, envía /newbot a @BotFather; si el bot ya existe, ve a /mybots → tu bot → API Token. Aquí también verás cómo comprobarlo, revocarlo si se filtró y guardarlo de forma segura.

Qué es el token del bot y qué formato tiene

El token identifica a tu bot ante la Bot API y, a la vez, funciona como su contraseña. Tiene dos partes separadas por dos puntos:

• 123456789: el id numérico del bot. No es tu chat id.
• AAEexampleTokenReplaceWithYours: la parte secreta, la que nunca debes compartir.

En cada petición el token va en la URL, precedido de la palabra bot: https://api.telegram.org/bot<token>/getMe. Quien tenga tu token tiene control total del bot: puede leer lo que le escriben y enviar mensajes en su nombre.

Cómo obtener el token de un bot nuevo

1. Abre @BotFather y envía /newbot.
2. Escribe el nombre visible del bot.
3. Escribe un username de 5 a 32 caracteres (letras latinas, números y guion bajo) que termine en bot, por ejemplo avisos_tienda_bot.
4. BotFather responde con un mensaje que incluye el token. Cópialo completo, sin espacios ni saltos de línea.

Si es tu primer bot, la guía cómo crear un bot en Telegram cubre el proceso completo, hasta el primer mensaje.

Dónde encontrar el token de un bot que ya existe

1. Abre @BotFather y envía /mybots.
2. Elige el bot en la lista.
3. Pulsa API Token: BotFather te muestra el token actual sin cambiarlo.

BotFather solo muestra los bots de tu propia cuenta. Si el bot lo creó otra persona, necesitas que te pase el token o que te transfiera la propiedad desde /mybots. Evita otros comandos para “recuperar” el token: lo que buscas es ver el actual, no generar uno nuevo que rompa tus integraciones.

Comprobar el token con getMe

La forma más rápida de saber si un token es válido es llamar a getMe:

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getMe"

Un token válido devuelve "ok": true con los datos del bot (id, is_bot, username…). Uno inválido devuelve:

{"ok": false, "error_code": 401, "description": "Unauthorized"}

Un 401 Unauthorized casi siempre significa que el token está incompleto, tiene espacios o comillas de más, o fue revocado. Si recibes 404 Not Found, revisa la URL: probablemente falta el prefijo bot. También puedes pegar el token en Bot API Tester y ejecutar getMe desde el navegador: el token se guarda solo en el localStorage de tu navegador y las peticiones van directo a api.telegram.org.

Cómo revocar un token filtrado

Si publicaste el token en GitHub, en una captura de pantalla o en un chat, revócalo de inmediato:

1. Envía /revoke a @BotFather y elige el bot, o ve a /mybots → bot → API Token → Revoke current token.
2. BotFather genera un token nuevo. El anterior deja de funcionar y cualquier petición con él recibe 401.
3. Actualiza el token en todos los lugares donde lo usas: servidor, variables de entorno, n8n, asistentes de IA.
4. Con el token nuevo, revisa con getWebhookInfo que no haya un webhook que no reconozcas.

Borrar el commit no basta: alguien pudo copiar el token antes. Revocar es la única forma de invalidarlo.

Cómo guardar el token de forma segura

• Guárdalo en una variable de entorno o en un gestor de secretos, no en el código.
• Agrega tu archivo .env a .gitignore.
• Nunca lo pongas en código del cliente: el JavaScript de una web o de una Mini App, una app móvil o una extensión. Cualquiera podría extraerlo.
• Usa un bot para pruebas y otro para producción.

export TELEGRAM_BOT_TOKEN="123456789:AAEexampleTokenReplaceWithYours"

import os
import requests

token = os.environ["TELEGRAM_BOT_TOKEN"]
r = requests.get(f"https://api.telegram.org/bot{token}/getMe", timeout=10)
print(r.json()["ok"])  # True si el token es válido

Token y chat id en n8n y asistentes de IA

Las herramientas de automatización como n8n y los asistentes de IA que se conectan a Telegram (por ejemplo, OpenClaw) suelen pedirte dos datos: el token del bot, para actuar como tu bot, y un chat id, para saber a quién escribir. El token lo obtienes como se explica arriba; para el chat id sigue la guía cómo obtener el chat id de Telegram.

Dos consejos prácticos:

• Crea un bot dedicado para cada integración. Así puedes revocar un token sin romper las demás.
• No uses el mismo token en dos programas que reciben actualizaciones a la vez. Si una herramienta configura un webhook y otra llama a getUpdates, la segunda recibirá 409 Conflict.

Para confirmar que el token y el chat id funcionan juntos, envía un mensaje de prueba con sendMessage, como se explica en cómo enviar mensajes con la API de Telegram.