Pubblica su Telegram da Gemini CLI

Gemini CLI può pubblicare su Telegram come tuo bot. Tu indichi la chat, Hermoso carica i file e l'id del messaggio torna indietro per qualsiasi modifica successiva.

Hermoso è un server MCP di marketing: 922+ strumenti su un unico endpoint con OAuth che permette a un agente di studiare gli annunci già attivi in un mercato, generare annunci finiti in immagine e video, pubblicarli e costruire le campagne a pagamento che stanno dietro. Gemini CLI raggiunge tutto attraverso una sola connessione. Questa pagina copre una fetta di tutto ciò: cosa Gemini CLI può fare davvero su Telegram e cosa Telegram non gli permette di fare.

Collega Hermoso a Gemini CLI

  1. Installa l'estensione.
    gemini extensions install https://github.com/hermoso-ai/hermoso
    Installa l'ultima versione del repository pubblico di Hermoso: cinque competenze (research, ad-from-brand, generate, product-photoshoot e marketing) più un file di contesto GEMINI.md. Le competenze eseguono il comando hermoso tramite npx, quindi nell'elenco degli strumenti di Gemini CLI non si aggiunge nulla e nulla costa contesto finché un comando non viene eseguito. gemini extensions list le mostra sotto Agent skills.
  2. Accedi una volta.
    npx -y hermoso auth login
    Apre un accesso nel browser e salva una credenziale visibile solo al proprietario in ~/.hermoso/config.json. Gemini CLI può eseguirlo per te la prima volta che ha bisogno di Hermoso. Nessun browser su quella macchina? Crea una chiave in MCP & CLI → Terminal & API keys ed esegui npx -y hermoso auth login --token hmk_….
  3. Facoltativo: anche il server MCP.
    gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp
    Gemini CLI trova il server di autorizzazione di Hermoso quando la prima connessione risponde 401 e si registra da sola, quindi nel settings.json non va nessuna chiave; /mcp auth hermoso dentro una sessione avvia l'accesso. Le competenze raggiungono ogni strumento anche senza di esso.
  4. Chiedi qualcosa a Gemini CLI. “Recupera le inserzioni più longeve dei tre concorrenti più vicini e trasforma il gancio migliore in un video 9:16”, oppure “pubblica questo render sul canale”. L'agente sceglie gli strumenti; tu approvi la spesa.

Abbiamo eseguito l'installazione qui sopra il 2026-09-23 con Gemini CLI 0.60.0 in una home directory pulita: ha scaricato l'ultima versione di hermoso-ai/hermoso, e gemini extensions list ha riportato le cinque competenze e il file di contesto. L'estensione non porta con sé un server MCP, ed è voluto: un elenco di strumenti viene caricato in ogni sessione, mentre le competenze non costano nulla finché non vengono eseguite. Hermoso non ha alcun legame con Google e non ne è approvata.

Poi collega Telegram stesso, una volta, in Impostazioni → Connettori dentro Hermoso incollando un token del bot da @BotFather, e aggiungi quel bot al tuo canale come amministratore. Non c'è una schermata di consenso: il token è la credenziale, e il bot è chi pubblica.

Gli strumenti Telegram che ottiene Gemini CLI

  • post_to_telegram: invia un messaggio come il tuo bot alla chat che indichi: testo fino a 4.096 caratteri, oppure una foto, un video o un album da 2 a 10 con foto e video misti.
  • schedule_post: lo mette in coda con il suo chatId sullo stesso calendario di tutti gli altri canali.
  • list_telegram_chats: le chat che hanno scritto al bot nelle ultime 24 ore. Aiuta a trovare un id, e non è un elenco di tutte le chat in cui si trova il bot.
  • edit_telegram_message / pin_telegram_message: correggere il testo o la didascalia di un messaggio senza perdere le visualizzazioni, e fissare o rimuovere il fissaggio della call to action.
  • create_telegram_invite_link: un link di invito con nome per ogni campagna, con scadenza facoltativa, limite di membri o approvazione dell'ingresso, così vedi chi è entrato e da dove.
  • telegram_account: il numero di iscritti o membri della chat, il titolo, la descrizione e il link di invito.
  • list_telegram_dms: ciò che le persone hanno inviato al bot nelle ultime 24 ore, dal più recente, per rispondere con post_to_telegram.
  • delete_telegram_message: rimuove un messaggio inviato dal bot, entro la finestra di 48 ore di Telegram, dopo un passaggio di conferma.

Telegram si collega con un token del bot, non con una schermata di accesso. Crea un bot con @BotFather su Telegram, incolla il suo token in Impostazioni → Connettori, poi aggiungi il bot al tuo canale come amministratore con Pubblicare messaggi, o a un gruppo come membro che può scrivere. Hermoso pubblica come quel bot, mai come te. Due limiti sono di Telegram e vale la pena pianificarli: un bot non ottiene visualizzazioni per post né uno storico dei post, quindi il numero di iscritti e i link di invito con nome sono i numeri che hai; e i messaggi inviati al bot vengono conservati per 24 ore, poi spariscono. Pubblicare non costa crediti.

Limiti di Telegram da conoscere prima di automatizzare qualsiasi cosa

TestoUn messaggio Telegram arriva a 4.096 caratteri, ma solo a 1.024 quando è allegata una foto o un video, perché il testo diventa una didascalia. Il limite è applicato quando il post viene creato o messo in coda, quindi un post troppo lungo viene rifiutato mentre sei ancora lì per correggerlo, invece di essere tagliato in silenzio durante la pubblicazione.
VisibilitàInviato o non inviato, senza forma in bozza, non in elenco o privata. Chi lo vede lo decide la chat: «pubblica in un gruppo o canale privato e lo vedranno solo i suoi membri». silent consegna il messaggio senza suono di notifica e non cambia nulla su chi può vederlo.
CaroselloDa 2 a 10 elementi come album, e foto e video possono essere misti. Entrambi i limiti sono di Telegram, dalla sendMediaGroup della Bot API («deve includere 2-10 elementi»), e così il mix. L'album mostra una sola didascalia, sul primo elemento. Hermoso carica i file invece di passare link, il che alza i limiti di Telegram a 10 MB per foto e 50 MB per video.
Quale accountchatId, obbligatorio in ogni post: il @username di un canale pubblico o l'id numerico (un supergruppo o canale inizia con -100). La Bot API non ha un metodo che elenchi le chat in cui si trova un bot, quindi Hermoso non può conoscerle e non indovina mai.

Provalo in Gemini CLI

Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:

“Pubblica ./renders/teaser.mp4 sul nostro canale Telegram @ourbrand con una didascalia di meno di 1.024 caratteri, e fissalo senza notificare i membri.”

Questo percorso va da render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Gemini CLI chiede conferma prima di eseguire un comando della shell, e le skill agiscono tramite il comando hermoso, quindi una pubblicazione compare come una riga che puoi leggere prima di dire sì. Per gli strumenti MCP chiede una volta, sempre per quello strumento, oppure sempre per il server.

Gemini CLI su Telegram: la parte che morde

Controlla la dimensione del file prima della chiamata. Telegram limita un video caricato a 50 MB anche quando Hermoso invia i byte invece di un link (un link sarebbe limitato a 20 MB), e un render più lungo potrebbe richiedere una codifica più leggera. Il bot deve già essere amministratore del canale con il permesso Pubblicare messaggi, più il permesso di fissare per fissare, e il rifiuto di Telegram indica quale dei due manca.

Due dettagli di Gemini CLI decidono quanto è sicuro tutto questo. gemini mcp add scrive nel file .gemini/settings.json del progetto, a meno che tu non passi --scope user, utile quando un repo deve sempre lavorare su un solo brand. E non aggiungere mai Hermoso con --trust: salta ogni conferma per il server, comprese quelle davanti a una pubblicazione. Gli strumenti MCP arrivano con il nome mcp_hermoso_ seguito dal nome dello strumento, e --exclude-tools ne tiene fuori qualsiasi.

Studia Telegram prima di pubblicare

Non esistono una libreria annunci di Telegram né una ricerca di canali in Hermoso, quindi non rivendica alcuna ricerca concorrenti su Telegram. Fai ricerca sul creativo dove è pubblico (le librerie annunci di Meta, Google e LinkedIn più TikTok, Instagram, YouTube, Reddit e Threads organici) e pubblica qui l'annuncio finito.

La parte a pagamento

Non ci sono annunci Telegram in Hermoso, e non lo lasciamo intendere. Telegram qui è un canale che possiedi e gestisci tramite il tuo bot: pubblicare, fissare, modificare, contare gli iscritti e tracciare gli inviti. Gli strumenti a pagamento coprono Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

Cosa Gemini CLI non può fare da solo

Un agente con un budget è utile solo se il raggio d'azione è limitato, quindi il limite è nel server e non in un prompt. Ogni campagna, ogni set di inserzioni, ogni gruppo di annunci e ogni annuncio viene creato in pausa, e i cambi di stato che attivano denaro reale si rifiutano di funzionare senza un flag di conferma esplicito. Ogni render viene preventivato prima (hermoso_capabilities pubblica il costo esatto in crediti di ogni modello prima che qualcosa venga speso). I crediti vengono riservati prima della prima chiamata al fornitore e poi addebitati al costo esatto, quindi una chiamata fallita viene rimborsata invece di lasciarti addebitato per nulla. Anche le eliminazioni richiedono conferma, e ogni struttura di campagna viene riletta dalla piattaforma pubblicitaria prima che il tuo agente ti dica cosa ha costruito.

Un passaggio è deliberatamente tuo: creare il bot con @BotFather e aggiungerlo al tuo canale. Tutto il resto è una chiamata di strumento.

Il resto della matrice

Da Gemini CLI, pubblica su: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Oppure vedi tutto ciò che Gemini CLI può pubblicare.

Pubblica su Telegram da: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Domande frequenti

Gemini CLI può pubblicare su Telegram?

Sì, con l'estensione di Gemini CLI di Hermoso. Esegui gemini extensions install https://github.com/hermoso-ai/hermoso, che aggiunge cinque competenze di Hermoso che guidano il comando hermoso, poi accedi una volta con npx -y hermoso auth login. L'accesso apre un browser e salva da solo la credenziale, quindi non c'è nessuna chiave da creare né da incollare. Se vuoi anche gli strumenti di Hermoso nell'elenco di Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp aggiunge il server ospitato, che accede con OAuth. Gemini CLI avrà poi oltre 922+ strumenti, inclusi quelli che pubblicano su Telegram, più quelli che ricercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.

Come collego Telegram a Gemini CLI?

Due passaggi, una volta ciascuno. Esegui gemini extensions install https://github.com/hermoso-ai/hermoso, che aggiunge cinque skill di Hermoso che usano il comando hermoso, poi accedi una volta con npx -y hermoso auth login. L'accesso apre il browser e salva da solo la credenziale, quindi non c'è nessuna chiave da creare né da incollare. Se vuoi anche gli strumenti di Hermoso nell'elenco di Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp aggiunge il server ospitato, che accede con OAuth. Poi crea un bot con @BotFather su Telegram, incolla il suo token in Impostazioni → Connettori su Hermoso e aggiungi il bot al tuo canale come amministratore con il permesso Pubblicare messaggi. Da quel momento Gemini CLI pubblica su Telegram come una normale chiamata di strumento, indicando ogni volta la chat.

Gemini CLI può pubblicare un post privato o come bozza su Telegram?

Nella Bot API non esistono bozze né messaggi privati. La privacy su Telegram appartiene alla chat: pubblica in un gruppo o canale privato e lo vedranno solo i suoi membri. Hermoso rifiuta una visibilità che Telegram non può garantire nel momento in cui la chiedi, anziché pubblicare in silenzio qualcosa di più debole.

Gemini CLI può cercare su Telegram prima di pubblicare?

No. Hermoso non ha una libreria annunci Telegram né una ricerca di canali. Fa ricerca sul creativo nelle librerie annunci pubbliche e nelle piattaforme organiche, e Telegram è dove pubblichi il risultato.

Qual è il limite di caratteri della didascalia Telegram quando pubblico da Gemini CLI?

Un messaggio Telegram di solo testo arriva a 4.096 caratteri; una volta allegata una foto o un video il testo è una didascalia e il limite è 1.024. Hermoso dice quale limite si è applicato. Hermoso lo applica quando il post viene creato o messo in coda, quindi Gemini CLI lo sa subito anziché fallire più tardi, quando nessuno controlla.

Gemini CLI può anche gestire annunci Telegram oltre a pubblicare?

No. Non ci sono annunci Telegram in Hermoso. Telegram qui è un canale che gestisci tramite il tuo bot: post, pin, modifiche, link di invito e numero di iscritti.

Inizia gratis con 30 crediti alla registrazione e altri 250+ da guadagnare. Ogni funzione è inclusa in ogni piano.

Inizia gratis →   Vedi i prezzi