Telegram Bot API
🌐 Español

Telegram Bot API en español

Guías prácticas en español para desarrollar bots de Telegram: desde obtener el token y el chat id hasta configurar un webhook y enviar mensajes con formato. Además, herramientas gratuitas para llamar a los 185 métodos de la Bot API 10.3 desde el navegador, sin instalar nada.

Guías en español

Paso a paso, con código listo para copiar en curl, Python y JavaScript, y soluciones a los errores más comunes.

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

Aprende a crear un bot de Telegram: /newbot en @BotFather, token, prueba con getMe y tu primer mensaje con curl y Python. Gratis y sin servidor.

Cómo enviar mensajes con la API de Telegram: sendMessage paso a paso

Envía mensajes con la Bot API de Telegram: sendMessage con curl, Python y JavaScript, formato HTML y MarkdownV2, botones inline y errores 400, 403 y 429.

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

Cómo obtener el token de tu bot de Telegram con @BotFather, encontrarlo si el bot ya existe, comprobarlo con getMe y revocarlo si se filtró.

Webhook de Telegram: cómo configurar setWebhook para tu bot (Python y n8n)

Configura el webhook de tu bot de Telegram: requisitos HTTPS, setWebhook con secret_token, getWebhookInfo, handler en Python y errores típicos en n8n.

Cómo obtener el chat id de Telegram: usuarios, grupos, canales y temas

Obtén el chat id de Telegram para tu bot con getUpdates: usuarios, grupos, supergrupos (-100…), canales y temas, y qué hacer si result viene vacío.

Herramientas gratuitas para la Bot API

Bot API Tester

Llama a cualquiera de los 185 métodos desde el navegador, con formularios de parámetros, long polling de getUpdates y visor de JSON.

Abrir el tester →

Swagger / OpenAPI

Especificación OpenAPI 3.1 de los 185 métodos: explora los parámetros, autorízate con tu token y ejecuta peticiones reales con «Try it out».

Ver la documentación Swagger →

Mini App Tester

Prueba la API JavaScript Telegram.WebApp en un navegador normal (modo simulado) o dentro de Telegram.

Probar Mini Apps →

Métodos (185) →

Preguntas frecuentes sobre la Bot API

¿Qué es la Telegram Bot API?

Es la interfaz HTTP con la que controlas un bot de Telegram: haces peticiones HTTPS a api.telegram.org con el token de tu bot y el nombre del método, y recibes respuestas en JSON. Su uso es gratuito.

¿En qué se diferencia un bot de una cuenta normal de Telegram?

Un bot se crea con @BotFather y no necesita número de teléfono, su username termina en «bot», no puede iniciar conversaciones con usuarios y, en grupos, por defecto solo ve los mensajes que le corresponden (modo de privacidad).

¿Hay documentación de la Bot API en español?

La documentación oficial en core.telegram.org está en inglés. Aquí encontrarás guías en español de las tareas más comunes; la referencia de métodos y la interfaz de las herramientas están en inglés y ruso.

¿Las herramientas de este sitio son oficiales de Telegram?

No. Es un proyecto independiente, sin afiliación con Telegram. Las peticiones van directamente de tu navegador a api.telegram.org.

¿Qué versión de la Bot API cubren las herramientas?

La Bot API 10.3, publicada el 24 de agosto de 2026, con sus 185 métodos.