Resumen
Envía mensajes, fotos, álbumes, documentos, audio, vídeo, animaciones, stickers, contactos, lugares, ubicaciones y encuestas de Telegram desde cualquier agente IA mediante la Telegram Bot API. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).
Configuración guiada
Conecta Telegram Bot a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Telegram Bot con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Telegram Bot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Telegram Bot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Telegram Bot
Envía mensajes, fotos, álbumes, documentos, audio, vídeo, animaciones, stickers, contactos, lugares, ubicaciones y encuestas de Telegram desde cualquier agente IA mediante la Telegram Bot API. 33 herramientas, autenticación con el token del bot. Envío saliente más una lectura ligera de las actualizaciones recientes (sin long polling).
Configuración
- En Telegram, abre un chat con @BotFather, envía
/newboty elige un nombre visible y un nombre de usuario que termine enbot. - BotFather responde con un token como
123456789:ABCdef.... Trátalo como un secreto: quien lo tenga puede enviar mensajes como tu bot. - Pega el token completo en
TELEGRAM_BOT_TOKENe instala el conector. Telegram espera el token en la dirección de la petición, y el conector lo coloca ahí por ti. - Empieza con
telegram_bot_get_mepara comprobar que el token funciona.
A quién puede llegar el bot: cada chat tiene un chat_id numérico. Un usuario debe haber enviado /start a tu bot al menos una vez, y en grupos y canales primero hay que añadir el bot. Los canales públicos también aceptan @channelusername; los privados necesitan el id numérico, que empieza por -100. telegram_bot_get_updates muestra los mensajes entrantes recientes con sus chat ids.
Qué envía: mensajes de texto (el formato HTML es la opción más segura), fotos, álbumes, documentos, archivos de audio, notas de voz, vídeos, animaciones GIF, stickers, tarjetas de contacto, lugares, ubicaciones (también en tiempo real) y encuestas o cuestionarios. También puede editar y borrar sus propios mensajes y leer los detalles de un chat.
Álbumes: telegram_bot_send_album envía de 2 a 10 fotos y vídeos como un único mensaje agrupado, o de 2 a 10 documentos, o de 2 a 10 archivos de audio; los documentos y el audio no se pueden mezclar con otros tipos. El pie de foto va en el primer elemento. Si Telegram devuelve WEBPAGE_CURL_FAILED para un elemento, no pudo descargar ese archivo: el enlace debe ser público y apuntar directamente al archivo, no a una página web.
Archivos: los medios se envían por enlace HTTPS (hasta 5 MB para fotos y 20 MB para otros archivos) o por el file_id de algo enviado antes. No se puede subir un archivo desde tu ordenador en la misma llamada.
Reacciones, mensajes fijados y gestión de chats: el bot puede reaccionar a un mensaje con un emoji y cambiar el pie de una foto, un vídeo o un documento que envió. En los grupos y canales donde es administrador con el permiso correspondiente (fijar mensajes, cambiar la info del chat, invitar usuarios, gestionar temas), fija y desfija mensajes, cambia el nombre y la descripción del chat, crea enlaces de invitación adicionales (con nombre, con caducidad o limitados a un número de entradas) y abre temas en grupos con foro. También puede reunir imágenes existentes en un nuevo pack de stickers de un usuario y añadirle más stickers. telegram_bot_get_webhook_info muestra si el bot tiene un webhook; mientras haya uno, telegram_bot_get_updates responde 409 Conflict. telegram_bot_remove_webhook borra el webhook y está desactivada al instalar, porque el servicio que lo recibe (un chatbot, una automatización) deja de recibir mensajes: actívala a propósito en la página del conector; la IA pregunta antes de cada cambio.
¿Ya lo tienes instalado? Las nuevas herramientas llegan a un conector instalado antes mediante su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tu token del bot y las herramientas que añadiste tú se quedan como están, y telegram_bot_remove_webhook llega desactivada, igual que en una instalación nueva.
Límites de envío: unos 30 mensajes por segundo entre chats distintos, 1 por segundo al mismo chat y 20 por minuto al mismo grupo. Ante un 429, Telegram indica cuánto esperar.
El conector lee las actualizaciones recientes cuando se lo pides y no ejecuta un chatbot que responda por su cuenta, algo que necesita un webhook alojado por ti. Los pagos, el modo inline y los juegos no están cubiertos.
Requisitos previos: TELEGRAM_BOT_TOKEN
Instalar el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige Telegram Bot e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
telegram_bot_get_me | Return the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries |
telegram_bot_send_message | Send a text message to a chat |
telegram_bot_send_photo | Send a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id |
telegram_bot_send_document | Send a document (any type, ≤20MB via URL) by HTTPS URL or file_id |
telegram_bot_send_audio | Send an audio file (MP3, M4A, ≤20MB via URL) |
telegram_bot_send_voice | Send a voice note (OGG-Opus encoded) |
telegram_bot_send_video | Send a video (MP4, H.264, AAC, ≤20MB via URL) |
telegram_bot_send_location | Send a location point |
telegram_bot_send_poll | Send a poll (regular or quiz) |
telegram_bot_edit_message_text | Edit the text of a previously-sent message (your bot's own messages only) |
telegram_bot_delete_message | Delete a message the bot sent (within ~48 hours for groups, anytime for own DMs) |
telegram_bot_get_chat | Fetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions |
telegram_bot_get_updates | Long-poll recent inbound messages (one-shot: pulls all updates since the last offset+1) |
telegram_bot_send_album | Send 2 to 10 photos or videos as one album (sendMediaGroup), or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be… |
telegram_bot_send_animation | Send a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop |
telegram_bot_send_sticker | Send a sticker by file_id (any sticker the bot has seen, e.g. from telegram_bot_get_updates) or by HTTPS URL of a .WEBP image |
telegram_bot_send_contact | Send a phone contact card that the recipient can save or call |
telegram_bot_send_venue | Send a venue: a map pin with a name and address, e.g. a shop or meeting point |
telegram_bot_get_file | Look up a file the bot received (photo, document, voice note, video) by its file_id, from a message in telegram_bot_get_updates |
telegram_bot_download_file | Download a file by the file_path telegram_bot_get_file returned |
telegram_bot_fetch_sticker_set | Read a sticker set (or custom emoji set) by its name: title, sticker_type (regular, mask, custom_emoji) and every sticker with its emoji… |
telegram_bot_react_to_message | Set the bot's reaction on a message (the emoji under a message), or remove it with an empty list |
telegram_bot_pin_message | Pin a message in a chat, so it shows at the top |
telegram_bot_unpin_chat_message | Unpin a pinned message in a chat; without message_id the most recently pinned message is unpinned |
telegram_bot_rename_chat | Change the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats |
telegram_bot_update_chat_description | Change the description of a group, supergroup or channel (0 to 255 characters; empty removes it) |
telegram_bot_add_forum_topic | Create a topic in a forum supergroup (a group with topics enabled) |
telegram_bot_edit_message_caption | Edit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it) |
telegram_bot_create_chat_invite_link | Create an additional invite link for a group, supergroup or channel, optionally named, expiring, limited to a number of joins, or requiring… |
telegram_bot_create_sticker_set | Create a new sticker set owned by a user, with 1 to 50 first stickers from existing image files |
telegram_bot_extend_sticker_set | Add one sticker to a sticker set the bot created (telegram_bot_create_sticker_set) |
telegram_bot_get_webhook_info | Show whether the bot has a webhook: its url (empty when none), pending_update_count, the last error date and message, and allowed_updates |
telegram_bot_remove_webhook | Remove the bot's webhook so updates can be read with telegram_bot_get_updates again |
Ejemplos de prompts
- "Envía las fotos de estos cuatro enlaces como un solo álbum al canal del equipo, con el pie 'Nueva colección, disponible desde hoy'."
- "Publica una encuesta en el grupo de ventas: ¿qué día va mejor para la revisión trimestral, martes o jueves?"
- "Envía la dirección de nuestra tienda como lugar al chat del cliente para que pueda abrirla en su app de mapas."
- "Muéstrame los mensajes que recibió el bot en la última hora y quién los envió."
- "Fija en el grupo de clientes el mensaje con el horario de los festivos y reacciona con un pulgar arriba."
- "Crea un enlace de invitación para el grupo beta que caduque el viernes y admita como máximo 50 entradas."
Siguientes pasos
¿Te ha sido útil esta guía?