Posten naar Telegram vanuit Claude Code

Vanuit de terminal is een Telegram-post een bot die een bericht verstuurt. Het bericht-id komt meteen terug, voor het logboek en voor elke latere bewerking of verwijdering.

Hermoso is een marketing-MCP-server: 922+ tools via één OAuth-endpoint, waarmee een agent de advertenties kan onderzoeken die al in een markt draaien, afgewerkte beeld- en videoadvertenties kan genereren, ze kan publiceren en de betaalde campagnes erachter kan bouwen. Claude Code bereikt dat alles via één verbinding. Deze pagina behandelt één stuk daarvan: wat Claude Code echt op Telegram kan doen, en wat Telegram hem niet laat doen.

Hermoso verbinden met Claude Code

  1. Eén commando, en geen sleutel.
    claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso
    Al in een sessie? Typ /plugin marketplace add hermoso-ai/hermoso, daarna /plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills (research, ad-from-brand, generate, product-photoshoot en marketing) die het hermoso-commando draaien via npx, dus er wordt geen toollijst in je sessies geladen en niets kost context zolang het niet draait.
  2. Log één keer in.
    npx -y hermoso auth login
    Dat opent een browserinlog op loopback, zoals gh dat doet, en slaat een alleen-voor-jou-leesbaar inloggegeven op in ~/.hermoso/config.json. Claude Code draait dat voor je de eerste keer dat het Hermoso nodig heeft. Geen browser op die machine, bijvoorbeeld CI, een externe server of een container? Maak een sleutel aan onder MCP & CLI → Terminal & API-sleutels en voer npx -y hermoso auth login --token hmk_… uit. Een sleutel heeft echte uitgavenbevoegdheid, dus behandel hem als een wachtwoord.
  3. Optioneel: de MCP-server erbij. Als je Hermoso’s tools ook in de eigen toollijst van Claude Code wilt hebben, voer dan na het inloggen claude mcp add hermoso -- npx -y hermoso mcp uit. Die gebruikt hetzelfde opgeslagen inloggegeven, dus er komt geen sleutel in .claude.json. De skills bereiken elke tool zonder dit.
  4. Vraag Claude Code om iets. “Haal de langstlopende advertenties van mijn drie dichtstbijzijnde concurrenten op en zet de beste hook om in een 9:16-video,” of “plaats deze render op het kanaal.” De agent kiest de tools; jij keurt de uitgaven goed.

De plugin en de optionele MCP-server bereiken dezelfde tools en hetzelfde account. Het verschil zit in de context: een toollijst wordt in elke sessie geladen voordat je iets typt, terwijl de skills niets kosten zolang er geen commando draait.

Verbind daarna Telegram zelf, één keer, onder Instellingen → Connectors in Hermoso, door een bottoken van @BotFather te plakken, en voeg die bot toe aan je kanaal als beheerder. Er is geen toestemmingsscherm: het token is de inloggegevens, en de bot is degene die post.

De Telegram-tools die Claude Code krijgt

  • post_to_telegram: stuurt een bericht als je bot naar de chat die je noemt: tekst tot 4.096 tekens, of één foto, één video, of een album van 2 tot 10 met foto’s en video’s gemengd.
  • schedule_post: zet hem in de wachtrij met zijn chatId, op dezelfde agenda als elk ander kanaal.
  • list_telegram_chats: de chats die de bot in de laatste 24 uur heeft berichtgeven. Het helpt om een id te vinden, en het is geen lijst van elke chat waar de bot in zit.
  • edit_telegram_message / pin_telegram_message: de tekst of het bijschrift van een bericht corrigeren zonder de weergaven te verliezen, en de call to action vastzetten of losmaken.
  • create_telegram_invite_link: een benoemde uitnodigingslink per campagne, met optioneel een verlooptijd, een ledenlimiet of goedkeuring bij aanmelden, zodat je ziet wie via welke weg is gekomen.
  • telegram_account: het aantal abonnees of leden van de chat, de titel, de beschrijving en de uitnodigingslink.
  • list_telegram_dms: wat mensen de bot in de laatste 24 uur hebben gestuurd, nieuwste eerst, om te beantwoorden met post_to_telegram.
  • delete_telegram_message: verwijdert een bericht dat de bot heeft verstuurd, binnen het venster van 48 uur van Telegram, na een bevestigingsstap.

Telegram koppelt met een bottoken, niet met een inlogscherm. Maak een bot aan met @BotFather in Telegram, plak het token onder Instellingen → Connectors, en voeg daarna de bot toe aan je kanaal als beheerder met het recht Berichten plaatsen, of aan een groep als lid dat kan posten. Hermoso post als die bot, nooit als jij. Twee limieten zijn van Telegram zelf en het is slim daar rekening mee te houden: een bot krijgt geen weergaven per post en geen postgeschiedenis, dus het aantal abonnees en de benoemde uitnodigingslinks zijn de cijfers die je hebt. Berichten die naar de bot gestuurd worden, worden 24 uur bewaard en daarna verwijderd. Publiceren kost geen credits.

Telegram-limieten om te weten voordat je iets automatiseert

TekstEen Telegram-bericht mag 4.096 tekens lang zijn, maar slechts 1.024 zodra er een foto of video aan hangt, omdat de tekst dan een bijschrift wordt. De limiet wordt afgedwongen bij het maken of in de wachtrij zetten, dus een te lange post wordt geweigerd terwijl je er nog bent om hem te repareren, in plaats van stilletjes ingekort te worden op weg naar buiten.
ZichtbaarheidVerzonden of niet verzonden, zonder concept-, niet-vermelde of privévorm. Wie het ziet, wordt bepaald door de chat: “post in een privégroep of -kanaal en alleen de leden zien het.” silent levert zonder meldingsgeluid en verandert niets aan wie het bericht kan zien.
Carrousel2 tot 10 items als album, en foto’s en video’s mogen gemengd worden. Beide grenzen komen van Telegram zelf, uit de sendMediaGroup van de Bot API (“must include 2-10 items”), en zo ook de mix. Het album toont één bijschrift, bij het eerste item. Hermoso uploadt de bestanden in plaats van links door te geven, en dat verhoogt de plafonds van Telegram naar 10 MB per foto en 50 MB per video.
Welk accountchatId, verplicht bij elke post: het @username van een openbaar kanaal of het numerieke id (een supergroep of kanaal begint met -100). De Bot API heeft geen methode die de chats van een bot oplijst, dus Hermoso kan ze niet kennen en raadt ze nooit.

Probeer het in Claude Code

Vraag er in gewone taal om. Dit zijn gewone zinnen, geen DSL:

“Stuur de vier afbeeldingen in ./out/launch als één Telegram-album naar chat -1001234567890, met het bijschrift uit ./copy/tg.txt, en log het bericht-id.”

Dat loopt via render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Claude Code vraagt toestemming voordat het een tool uitvoert, en het verloop staat in de terminal, dus een publicatiestap is een regel die je kunt lezen voordat je y indrukt.

Claude Code op Telegram: het deel dat pijn doet

Er gelden twee tekstlimieten, en zodra er media is toegevoegd wint de strengste: 4.096 tekens voor een bericht zonder media, 1.024 voor een bijschrift. Een album toont één bijschrift, bij het eerste item. Hermoso uploadt de bestanden in plaats van Telegram een link te geven, en dat verhoogt de limieten tot 10 MB per foto en 50 MB per video. Bewaar het bericht-id. Bewerken en verwijderen hebben het nodig, en Telegram geeft een bot later geen manier om het op te zoeken.

De plugin bevat geen tool-manifest, wat het zwaarst weegt bij een lange onbewaakte run: de agent roept per stap het hermoso-commando aan, en --json bij elk commando geeft machine-uitvoer om op te controleren.

Onderzoek Telegram voordat je post

Er is geen Telegram-advertentiebibliotheek en geen kanaalzoekfunctie in Hermoso, dus het claimt geen concurrentieonderzoek op Telegram. Onderzoek het creatieve materiaal waar het openbaar is (de advertentiebibliotheken van Meta, Google en LinkedIn, en organische TikTok, Instagram, YouTube, Reddit en Threads) en post de afgewerkte advertentie hier.

Het betaalde deel

Er zijn geen Telegram-advertenties in Hermoso, en we suggereren er geen. Telegram is hier een kanaal dat je bezit en beheert via je bot: posten, vastzetten, bewerken, abonnees tellen en uitnodigingen volgen. De betaalde tools dekken Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads en AppLovin Ads.

Wat Claude Code niet zelfstandig kan

Een agent met een budget is alleen nuttig als de impact begrensd is, dus het hek zit in de server en niet in een prompt. Elke advertentiecampagne, adset, advertentiegroep en advertentie wordt gepauzeerd aangemaakt, en de statusschakelaars die echt geld in beweging zetten, weigeren te draaien zonder een uitdrukkelijke bevestigingsvlag. Elke render wordt vooraf geprijsd (hermoso_capabilities publiceert de exacte creditkosten van elk model voordat er iets wordt uitgegeven). Credits worden gereserveerd vóór de eerste aanroep naar de provider en daarna afgerekend op de exacte kosten, zodat een mislukte verzending wordt terugbetaald in plaats van dat je voor niets betaalt. Verwijderingen zijn ook bevestigingsbeveiligd, en elke campagnestructuur wordt teruggelezen uit het advertentieplatform voordat je agent vertelt wat hij heeft gebouwd.

Eén stap is bewust aan jou: de bot aanmaken met @BotFather en hem aan je kanaal toevoegen. Alles daarna is een toolaanroep.

De rest van de matrix

Vanuit Claude Code publiceren naar: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Of bekijk alles waarnaar Claude Code kan publiceren.

Publiceren naar Telegram vanuit: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code-marketing

Veelgestelde vragen

Kan Claude Code naar Telegram posten?

Ja, met de Claude Code-plugin van Hermoso. Eén commando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, of binnen een sessie /plugin marketplace add hermoso-ai/hermoso en daarna /plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills die het hermoso-commando aansturen, dus er wordt geen toollijst in je sessies geladen. Log één keer in met npx -y hermoso auth login. Dat opent een browser en slaat het inloggegeven zelf op, dus je hoeft geen sleutel te maken of te plakken. Daarna heeft Claude Code 922+ tools, inclusief de tools die naar Telegram publiceren, plus de tools die de advertenties onderzoeken die al in jouw markt draaien en het creatieve materiaal in de eerste plaats renderen.

Hoe koppel ik Telegram aan Claude Code?

Twee stappen, elk één keer. Eén commando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, of binnen een sessie /plugin marketplace add hermoso-ai/hermoso en daarna /plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills die de hermoso CLI aansturen, dus er wordt geen toollijst in je sessies geladen. Meld je één keer aan met npx -y hermoso auth login. Dat opent een browser en slaat de inloggegevens zelf op, dus je hoeft geen sleutel aan te maken en niets te plakken. Maak daarna een bot met @BotFather in Telegram, plak het token onder Instellingen → Connectors in Hermoso, en voeg de bot als beheerder met het recht Berichten plaatsen toe aan je kanaal. Daarna publiceert Claude Code naar Telegram als een gewone toolaanroep, en noemt het elke keer het chat.

Heeft Claude Code mijn Telegram-wachtwoord nodig?

Nee. Telegram koppelt via een bot die je maakt met @BotFather, en Hermoso houdt alleen het token van die bot vast. Claude Code post dus als de bot en nooit als je persoonlijke Telegram-account. Het token kan altijd ingetrokken worden in @BotFather, en het wordt nooit aan het model gegeven.

Kan Claude Code een Telegram-post voor later inplannen?

Ja. schedule_post zet hem in één kalender die met elk ander kanaal wordt gedeeld, met een caption per kanaal als de tekst moet verschillen, en list_scheduled en cancel_scheduled lezen hem uit en halen hem terug. Telegram is een van de elf kanalen die in de wachtrij gaan.

Kan Claude Code een carrousel naar Telegram posten?

Ja, als album van 2 tot 10 items, met foto’s en video’s gemengd. Dat is de eigen regel van Telegram voor sendMediaGroup. Het album heeft één caption, bij het eerste item. Claude Code roept in beide gevallen dezelfde publicatietool aan, en een kanaal dat geen carrousel kan dragen wordt geweigerd, met de echte reden erbij.

Wat kost posten naar Telegram vanuit Claude Code?

Posten naar Telegram kost geen credits; Telegram rekent niets per aanroep. Credits worden besteed aan het genereren van het creatieve materiaal. Abonnementen kosten $29, $69 en $149 per maand voor 1.200, 3.000 en 7.000 credits, en elke functie zit op elk abonnement, ook op Free. De enige uitzondering is enterprise-SSO.

Begin gratis met 30 credits bij aanmelding en verdien er 250+ bij. Elke functie zit in elk abonnement.

Gratis starten →   Bekijk prijzen