In breve
Invia messaggi Telegram, foto, album, documenti, audio, video, animazioni, sticker, contatti, luoghi, posizioni e sondaggi da qualsiasi agente AI tramite la Telegram Bot API. 33 strumenti, autenticazione con il token del bot. Invio in uscita più una lettura leggera degli aggiornamenti recenti (niente long polling).
Configurazione guidata
Collega Telegram Bot a Gemini in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Telegram Bot con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Telegram Bot
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Telegram Bot, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Telegram Bot + Gemini
Invia messaggi Telegram, foto, album, documenti, audio, video, animazioni, sticker, contatti, luoghi, posizioni e sondaggi da qualsiasi agente AI tramite la Telegram Bot API. 33 strumenti, autenticazione con il token del bot. Invio in uscita più una lettura leggera degli aggiornamenti recenti (niente long polling).
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
TELEGRAM_BOT_TOKEN
Step 1 — Ottieni le credenziali
- In Telegram apri una chat con @BotFather, invia
/newbote scegli un nome visualizzato e un username che finisca conbot. - BotFather risponde con un token simile a
123456789:ABCdef.... Trattalo come un segreto: chiunque lo abbia può inviare messaggi come il tuo bot. - Incolla il token completo in
TELEGRAM_BOT_TOKENe installa il connettore. Telegram vuole il token nell'indirizzo della richiesta, e il connettore lo inserisce lì per te. - Inizia con
telegram_bot_get_meper verificare che il token funzioni.
Chi può raggiungere il bot: ogni chat ha un chat_id numerico. Un utente deve aver inviato /start al tuo bot almeno una volta, e nei gruppi e nei canali il bot va prima aggiunto. I canali pubblici accettano anche @channelusername; i canali privati richiedono l'id numerico, che inizia con -100. telegram_bot_get_updates mostra i messaggi in arrivo recenti con i relativi chat id.
Cosa invia: messaggi di testo (la formattazione HTML è la scelta più sicura), foto, album, documenti, file audio, messaggi vocali, video, animazioni GIF, sticker, schede contatto, luoghi, posizioni (anche in tempo reale) e sondaggi o quiz. Può anche modificare ed eliminare i propri messaggi e leggere i dettagli di una chat.
Album: telegram_bot_send_album invia da 2 a 10 foto e video come un unico messaggio raggruppato, oppure da 2 a 10 documenti, oppure da 2 a 10 file audio; documenti e audio non si possono mescolare con altri tipi. La didascalia va sul primo elemento. Se Telegram segnala WEBPAGE_CURL_FAILED per un elemento, non è riuscito a scaricare quel file: il link deve essere pubblico e puntare direttamente al file, non a una pagina web.
File: i contenuti multimediali si inviano tramite link HTTPS (fino a 5 MB per le foto e 20 MB per gli altri file) o tramite il file_id di qualcosa inviato in precedenza. Caricare un file dal tuo computer nella stessa chiamata non è supportato.
Reazioni, messaggi fissati e gestione delle chat: il bot può reagire a un messaggio con un'emoji e modificare la didascalia di una foto, un video o un documento che ha inviato. Nei gruppi e nei canali in cui è amministratore con il permesso corrispondente (fissare messaggi, modificare le info della chat, invitare utenti, gestire i topic), fissa i messaggi e li toglie dai fissati, rinomina la chat, ne cambia la descrizione, crea link di invito aggiuntivi (con un nome, con scadenza o limitati a un numero di ingressi) e apre topic nei gruppi forum. Può anche raccogliere immagini esistenti in un nuovo set di sticker di proprietà di un utente e aggiungervi altri sticker. telegram_bot_get_webhook_info mostra se il bot ha un webhook; finché ce n'è uno impostato, telegram_bot_get_updates risponde 409 Conflict. telegram_bot_remove_webhook elimina il webhook ed è disattivato all'installazione, perché il servizio che lo riceve (un chatbot, un'automazione) smette di ricevere messaggi: attivalo deliberatamente nella pagina del connettore; l'AI chiede conferma prima di ogni modifica.
Già installato? I nuovi strumenti arrivano a un connettore installato in precedenza tramite l'aggiornamento del catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e clicca Apply update. Il token del bot e gli strumenti che hai aggiunto tu restano come sono, e telegram_bot_remove_webhook arriva disattivato, come in una nuova installazione.
Limiti di frequenza: circa 30 messaggi al secondo su chat diverse, 1 al secondo verso la stessa chat e 20 al minuto verso lo stesso gruppo. Con un 429, Telegram indica quanto aspettare.
Il connettore legge gli aggiornamenti recenti quando glielo chiedi e non gestisce un chatbot che risponde da solo, per il quale serve un webhook ospitato da te. Pagamenti, modalità inline e giochi non sono coperti.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Gemini
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia
gemini. - Esegui
/mcpin Gemini CLI (oppuregemini mcp listdal terminale):anythingmcpdovrebbe risultare connesso. - Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di
Telegram Bot.
Tool disponibili
| 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 |
Esempi di prompt
- "Invia le foto di questi quattro link come un unico album al canale del team, con la didascalia 'Nuova collezione, online da oggi'."
- "Pubblica un sondaggio nel gruppo vendite: quale giorno va bene per la revisione trimestrale, martedì o giovedì?"
- "Invia l'indirizzo del nostro negozio come luogo nella chat del cliente, così può aprirlo nella sua app di mappe."
- "Mostrami i messaggi che il bot ha ricevuto nell'ultima ora e chi li ha inviati."
- "Fissa nel gruppo clienti il messaggio sugli orari di apertura durante le feste e reagisci con un pollice in su."
- "Crea un link di invito per il gruppo beta che scade venerdì e permette al massimo 50 ingressi."
FAQ
Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?