v10.3 185 métodos
Inicio Documentación Tester Mini App Comentarios
ES

Telegram Bot API Swagger en español: documentación OpenAPI

Telegram Bot API Swagger es una documentación interactiva de la API de bots de Telegram: una descripción OpenAPI 3.1 de los 185 métodos de Bot API 10.3, agrupados en 19 etiquetas y presentados con Swagger UI. Cada método muestra sus parámetros con su tipo y si son obligatorios, enlaza a la documentación oficial y se puede ejecutar en vivo con el token de tu bot.

Cómo usar la documentación Swagger de Telegram Bot API

  1. Obtén el token de tu bot en @BotFather; si no sabes cómo, consulta cómo obtener el token de un bot de Telegram.
  2. Haz clic en Authorize y pega el token. Las solicitudes van a https://api.telegram.org/bot<token>/METHOD_NAME, así que si el bloque de servidores muestra una variable token, complétala también.
  3. Despliega una etiqueta, por ejemplo la de mensajes o la de actualizaciones, o reduce la lista con el filtro.
  4. Abre un método, haz clic en Try it out, edita el cuerpo JSON (en sendMessage, por ejemplo, chat_id y text) y haz clic en Execute.
  5. Revisa el código de estado, el cuerpo de la respuesta, la duración de la solicitud y el comando curl generado.

Cuándo conviene usar Swagger

Ten en cuenta que "Try it out" envía solicitudes reales: sendMessage publica un mensaje de verdad y deleteWebhook realmente elimina tu webhook. Experimenta con un bot de prueba; si todavía no tienes uno, sigue la guía cómo crear un bot de Telegram.

Privacidad

Swagger funciona por completo en tu navegador. Las solicitudes van directamente de la página a api.telegram.org, así que ni tu token ni el tráfico de la API pasan por nuestros servidores. Si aun así el token se filtra, revócalo con /revoke en @BotFather.

Para formularios tipados, long polling e historial de actualizaciones, usa Bot API Tester. Si prefieres una página por método con ejemplos en curl, Python y JavaScript, abre la referencia de métodos. ¿Estás creando una Mini App? Prueba la API Telegram.WebApp en Mini App Tester.

Preguntas frecuentes

¿Existe una especificación OpenAPI de Telegram Bot API?

Telegram documenta la Bot API en core.telegram.org. Esta página ofrece una descripción OpenAPI 3.1 independiente de los 185 métodos de Bot API 10.3, presentada con Swagger UI; no es un producto oficial de Telegram.

¿La documentación de Telegram Bot API está en español?

La documentación oficial de core.telegram.org solo está en inglés. En esta versión de Swagger los textos están en español, mientras que los nombres de métodos, parámetros y tipos se mantienen en inglés, igual que en la API; los botones de Swagger UI (Authorize, Try it out, Execute) también siguen en inglés.

¿Cómo me autorizo en el Swagger de Telegram Bot API?

Haz clic en Authorize y pega el token que te dio @BotFather; si el bloque de servidores muestra una variable token, complétala también. Así las solicitudes van a https://api.telegram.org/bot<token>/METHOD_NAME directamente desde tu navegador.

¿Try it out envía solicitudes reales?

Sí. Execute llama a la Bot API real con tu token, así que métodos como sendMessage, deleteMessage, setWebhook o logOut tienen efectos reales. Usa un bot de prueba para experimentar.

¿Qué versión de Bot API cubre esta documentación?

Bot API 10.3 (24 de agosto de 2026): los 185 métodos en 19 etiquetas, incluidos los mensajes enriquecidos y los mensajes efímeros, cada uno con un enlace a la documentación oficial.

¿Me conviene Swagger o Bot API Tester?

Usa Swagger para consultar la referencia, comparar esquemas de solicitud y copiar comandos curl. Usa Bot API Tester si quieres formularios tipados, long polling con historial de actualizaciones y verificaciones rápidas del token.