Cómo crear un bot en Telegram paso a paso: de BotFather a tu primer mensaje

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

Para crear un bot de Telegram solo necesitas hablar con @BotFather: envías /newbot, eliges un nombre y un username que termine en bot, y recibes un token. Con ese token ya puedes usar la Bot API desde curl, Python o cualquier lenguaje. En esta guía vas a crear el bot, comprobar el token y enviar tu primer mensaje en unos diez minutos.

Qué necesitas antes de empezar

• Una cuenta de Telegram, en el celular o en Telegram Desktop.
• Una terminal con curl, o Python 3 con la librería requests (pip install requests).
• Nada más: para empezar no hacen falta servidor ni dominio, y crear bots es gratis.

Paso 1: crear el bot con @BotFather y /newbot

1. Abre @BotFather y pulsa Iniciar.
2. Envía /newbot.
3. Escribe el nombre del bot. Es el que se ve en los chats, puede llevar espacios y lo puedes cambiar después con /setname.
4. Escribe el username: de 5 a 32 caracteres, solo letras latinas, números y guion bajo, y debe terminar en bot, por ejemplo tienda_pedidos_bot o TiendaPedidosBot. A diferencia del nombre, no se puede cambiar después.
5. Si el username ya está ocupado, BotFather te pedirá otro. Cuando lo acepte, te responderá con el enlace t.me/tu_username y el token del bot.

Paso 2: copiar y guardar el token

El token tiene este formato: 123456789:AAEexampleTokenReplaceWithYours. El número antes de los dos puntos es el id del bot y el resto es la parte secreta. Quien tenga el token controla el bot por completo, así que trátalo como una contraseña: guárdalo en una variable de entorno y nunca lo subas a un repositorio público. Si lo pierdes o se filtra, en la guía del token del bot explicamos cómo encontrarlo y revocarlo.

Paso 3: comprobar el token con getMe

Todas las peticiones siguen el formato https://api.telegram.org/bot<token>/MÉTODO; fíjate en la palabra bot pegada al token. El método getMe no necesita parámetros y devuelve los datos de tu bot:

TOKEN="123456789:AAEexampleTokenReplaceWithYours"
curl "https://api.telegram.org/bot$TOKEN/getMe"

Si el token es correcto, verás algo así (respuesta abreviada):

{
  "ok": true,
  "result": {
    "is_bot": true,
    "first_name": "Tienda Pedidos",
    "username": "tienda_pedidos_bot"
  }
}

¿Prefieres no usar la terminal? Pega el token en Bot API Tester y ejecuta getMe desde el navegador. Si recibes 401 Unauthorized, el token está mal copiado o fue revocado.

Paso 4: obtener tu chat id y enviar el primer mensaje

Un bot no puede iniciar una conversación: primero tienes que escribirle tú. Abre t.me/tu_username, pulsa Iniciar (se envía /start) y pide las actualizaciones pendientes:

curl "https://api.telegram.org/bot$TOKEN/getUpdates"

En la respuesta busca message.chat.id: ese número es tu chat id (en los ejemplos, 123456789). Para grupos y canales el proceso cambia un poco; lo explicamos en cómo obtener el chat id. Ahora envía un mensaje con sendMessage:

curl -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "¡Hola! Soy tu primer bot."}'

Lo mismo en Python con requests:

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"  # mejor: os.environ["TELEGRAM_BOT_TOKEN"]

resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendMessage",
    json={"chat_id": 123456789, "text": "¡Hola desde Python!"},
    timeout=10,
)
print(resp.json())

Si la respuesta trae "ok": true, el mensaje ya está en tu chat. Para dar formato, añadir botones o publicar en canales, sigue con cómo enviar mensajes con la API.

Tu primer bot con Python que responde

Este bot de eco usa long polling: pregunta por mensajes nuevos con getUpdates y responde a cada texto. El parámetro offset confirma las actualizaciones ya procesadas para no recibirlas dos veces.

import requests

API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours"
offset = None

while True:
    updates = requests.get(f"{API}/getUpdates",
                           params={"timeout": 30, "offset": offset}, timeout=40).json()
    for upd in updates["result"]:
        offset = upd["update_id"] + 1
        msg = upd.get("message")
        if msg and "text" in msg:
            requests.post(f"{API}/sendMessage", timeout=10,
                          json={"chat_id": msg["chat"]["id"], "text": "Dijiste: " + msg["text"]})

Paso opcional: descripción y comandos

• /setdescription: texto de hasta 512 caracteres que se ve en el chat vacío, antes de pulsar Iniciar.
• /setabouttext: biografía corta (hasta 120 caracteres) del perfil del bot.
• /setuserpic: foto de perfil.
• /setcommands: comandos que se sugieren al escribir /. Envía una línea por comando con el formato comando - Descripción.

Los comandos también se configuran desde código con setMyCommands:

curl -X POST "https://api.telegram.org/bot$TOKEN/setMyCommands" \
  -H "Content-Type: application/json" \
  -d '{"commands": [{"command": "start", "description": "Iniciar el bot"}, {"command": "ayuda", "description": "Ver la ayuda"}]}'

Problemas frecuentes

• 404 Not Found: falta la palabra bot antes del token o el nombre del método está mal escrito.
• "result": [] en getUpdates: no hay mensajes nuevos. Escríbele algo al bot y vuelve a llamar; las actualizaciones se guardan como máximo 24 horas.
• 409 Conflict: hay un webhook activo y getUpdates no funciona mientras exista. Elimínalo con deleteWebhook.
• 403 Forbidden: el usuario no ha iniciado el bot o lo bloqueó.
• 400 Bad Request: chat not found: el chat_id es incorrecto. No uses el número del token: es el id del bot, no el tuyo.

Siguientes pasos: polling, webhook y librerías

El bot de eco usa long polling, que funciona en tu computadora sin HTTPS ni IP pública. En producción suele usarse un webhook: Telegram envía cada actualización por POST a tu URL HTTPS. Lo explicamos en la guía de webhook para bots de Telegram.

Para proyectos reales usa una librería: en Python, python-telegram-bot, aiogram o pyTelegramBotAPI; en Node.js, grammY o Telegraf. Todas llaman a los mismos métodos de la Bot API, así que lo que pruebes en el tester funcionará igual en tu código. Y si quieres una interfaz web dentro de Telegram, experimenta con las Mini Apps en el Mini App Tester.