Telegram Bot
Crea bots de Telegram y responde mensajes con un token gratuito.
Ver la documentaciónPara qué sirve
Qué problema resuelve
La Bot API de Telegram deja crear bots que reciben mensajes y responden, envían archivos, teclados o facturas.
El bot se crea con @BotFather; el token es gratis. Los límites evitan spam (pocos mensajes por segundo a muchos usuarios).
En la práctica
Qué puedes hacer con ella
- Responder automáticamente a mensajes privados o de grupo.
- Enviar notificaciones desde tu servidor a un chat.
- Montar teclados, comandos y flujos de conversación.
- Recibir updates por long polling o webhook.
- Escalar broadcasts de pago con Stars si necesitas superar unos 30 mensajes por segundo.
¿Es gratis?
Bot API gratuita
Crear y operar un bot es gratis. La FAQ oficial recomienda no superar 1 mensaje por segundo en un chat, 20 por minuto en grupos y unos 30 mensajes por segundo al emitir a muchos usuarios. Paid Broadcasts permite llegar a 1.000 mensajes por segundo pagando Stars por el exceso.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Usar Telegram (luego @BotFather)
Qué cuenta como mensaje / request
Cada método de la Bot API (sendMessage, getUpdates…) es una petición HTTP a api.telegram.org. Los límites prácticos de la FAQ se expresan sobre todo en mensajes enviados. El uso normal no se factura por request; Paid Broadcasts permite superar la orientación de unos 30 mensajes por segundo mediante Stars.
Límites FAQ de bots
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Un mismo chat | 1 mensaje / segundo | Ráfagas cortas posibles; luego 429. |
| Grupos | 20 mensajes / minuto | No satures un grupo con el bot. |
| Broadcast a muchos usuarios | Unos 30 msg/s por defecto | Por encima, 429 salvo paid broadcasts. |
| Paid broadcasts | Hasta 1.000 msg/s | El exceso sobre 30/s cuesta Stars (0.1 Star por mensaje según FAQ). |
Coste
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Bot API estándar | $0 | Casi todos los bots. | Token gratis · límites de ritmo de la FAQ. |
| Paid broadcasts | Stars (ver FAQ) | Envíos masivos por encima de unos 30/s. | Hasta 1.000 msg/s con coste por mensaje extra. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Open source? | La Bot API es un servicio de Telegram; hay clientes y libs open source de terceros. |
| ¿Uso comercial? | Permitido dentro de los Terms de Telegram y las reglas de bots (no spam, no abuso). |
| ¿Hace falta cuenta? | Sí: cuenta Telegram y crear el bot con @BotFather para obtener el token. |
Cómo empezar
Crear un bot y comprobar getMe.
Necesitas la app Telegram y hablar con @BotFather.
Dirección base de las imágenes: https://api.telegram.org
- 01
Paso 1
En Telegram, abre @BotFather y crea un bot; copia el token.
- 02
Paso 2
Haz GET https://api.telegram.org/bot<TOKEN>/getMe y comprueba que responde ok.
- 03
Paso 3
Prueba getUpdates o configura un webhook HTTPS según https://core.telegram.org/bots/api
- 04
Paso 4
Responde con sendMessage al chat_id de una conversación de prueba.
- 05
Paso 5
Si envías a muchos usuarios, toma como orientación unos 30 msg/s: https://core.telegram.org/bots/faq
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra Telegram Bot API. Docs: https://core.telegram.org/bots/api . FAQ límites: https://core.telegram.org/bots/faq . Base: https://api.telegram.org/bot<token>/ . No inventes tokens ni chat ids: pídemelos. Respeta límites de mensajes. ¿Webhook o getUpdates? ¿Qué comando implementamos primero?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · Clave gratuita
Pide una clave que se obtiene con un alta gratuita en el propio servicio.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.