Publier sur Telegram depuis Claude Code

Hermoso est un serveur MCP de marketing : plus de 922 outils sur un point d'accès OAuth unique, qui permettent à un agent de rechercher les publicités déjà diffusées sur un marché, de générer des publicités finies en image et en vidéo, de les publier et de construire les campagnes payantes qui les accompagnent. Claude Code accède à l'ensemble via une seule connexion. Cette page couvre une partie : ce que Claude Code peut réellement faire sur Telegram, et ce que Telegram ne lui permettra pas de faire.

Connecter Hermoso à Claude Code

1. Une seule commande, et aucune clé.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Déjà dans une session ? Tapez /plugin marketplace add hermoso-ai/hermoso, puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso (research, ad-from-brand, generate, product-photoshoot et marketing) qui exécutent la commande hermoso via npx, si bien qu’aucune liste d’outils n’est chargée dans vos sessions et que rien ne coûte de contexte tant qu’il ne tourne pas.
2. Connectez-vous une fois.

   npx -y hermoso auth login

   Cela ouvre une connexion dans le navigateur, sur loopback, comme le fait gh, et stocke un identifiant accessible au seul propriétaire dans ~/.hermoso/config.json. Claude Code le lance pour vous la première fois qu’il a besoin d’Hermoso. Pas de navigateur sur cette machine, par exemple en CI, sur un serveur distant ou dans un conteneur ? Créez une clé sous MCP & CLI → Clés Terminal et API et lancez npx -y hermoso auth login --token hmk_…. Une clé donne un vrai pouvoir de dépense : traitez-la comme un mot de passe.
3. Facultatif : le serveur MCP aussi. Si vous voulez aussi les outils Hermoso dans la liste d’outils propre à Claude Code, lancez claude mcp add hermoso -- npx -y hermoso mcp après vous être connecté. Il lit le même identifiant enregistré, si bien qu’aucune clé n’est écrite dans .claude.json. Les compétences atteignent tous les outils sans lui.
4. Demandez quelque chose à Claude Code. « Récupère les publicités les plus anciennes de mes trois principaux concurrents et réutilise la meilleure accroche dans une vidéo 9:16 », ou « publie ce rendu sur la chaîne ». L'agent choisit les outils ; vous approuvez les dépenses.

Le plug-in et le serveur MCP facultatif accèdent aux mêmes outils et au même compte. La différence tient au contexte : une liste d’outils est chargée dans chaque session avant que vous ne tapiez quoi que ce soit, alors que les compétences ne coûtent rien tant qu’une commande ne tourne pas.

Connectez ensuite Telegram lui-même, une fois, sous Paramètres → Connecteurs dans Hermoso, en collant un jeton de bot obtenu auprès de @BotFather, puis ajoutez ce bot à votre chaîne comme administrateur. Il n’y a pas d’écran de consentement : le jeton est l’identifiant, et le bot est celui qui publie.

Les outils Telegram dont dispose Claude Code

• post_to_telegram : envoie un message en tant que votre bot dans le chat que vous nommez : du texte jusqu’à 4 096 caractères, ou une photo, une vidéo, ou un album de 2 à 10 éléments avec photos et vidéos mélangées.
• schedule_post : la met en file d’attente avec son chatId, sur le même calendrier que tous les autres canaux.
• list_telegram_chats : les chats qui ont écrit au bot au cours des dernières 24 heures. Il aide à trouver un identifiant, et ce n’est pas une liste de tous les chats auxquels le bot appartient.
• edit_telegram_message / pin_telegram_message : corrigent le texte ou la légende d’un message sans perdre ses vues, et épinglent ou désépinglent l’appel à l’action.
• create_telegram_invite_link : un lien d’invitation nommé par campagne, avec expiration facultative, plafond de membres ou approbation d’adhésion, pour savoir qui a rejoint et d’où.
• telegram_account : le nombre d’abonnés ou de membres du chat, son titre, sa description et son lien d’invitation.
• list_telegram_dms : ce que les gens ont envoyé au bot au cours des dernières 24 heures, du plus récent au plus ancien, pour répondre avec post_to_telegram.
• delete_telegram_message : supprime un message envoyé par le bot, dans la fenêtre de 48 heures de Telegram, après une étape de confirmation.

Telegram se connecte avec un jeton de bot, et non avec un écran de connexion. Créez un bot avec @BotFather dans Telegram, collez son jeton sous Paramètres → Connecteurs, puis ajoutez le bot à votre chaîne comme administrateur avec l’autorisation Publier des messages, ou à un groupe comme membre autorisé à écrire. Hermoso publie en tant que ce bot, jamais en tant que vous. Deux limites viennent de Telegram et méritent d’être prévues : un bot n’obtient ni vues par publication ni historique des publications, donc le nombre d’abonnés et les liens d’invitation nommés sont les seuls chiffres disponibles ; et les messages envoyés au bot sont conservés 24 heures, puis disparaissent. La publication ne coûte aucun crédit.

Limites de Telegram à connaître avant d'automatiser quoi que ce soit

Essayez-le dans Claude Code

Demandez-le en langage courant. Ce sont des phrases simples, pas un langage de commande :

« Envoyez les quatre images de ./out/launch sous forme d'album Telegram vers le chat -1001234567890, avec la légende de ./copy/tg.txt, et journalisez l'identifiant du message. »

Cela enchaîne render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Claude Code demande confirmation avant d'exécuter un outil, et la transcription est affichée dans le terminal : une étape de publication est une ligne que vous pouvez lire avant d'appuyer sur y.

Claude Code sur Telegram : le point délicat

Deux limites de texte s'appliquent, et la plus serrée l'emporte dès qu'un média est joint : 4,096 caractères pour un message sans média, 1,024 pour une légende, et un album n'affiche qu'une légende, sur son premier élément. Hermoso téléverse les fichiers au lieu de donner à Telegram un lien, ce qui porte les limites à 10MB par photo et 50MB par vidéo. Conservez l'identifiant du message : la modification et la suppression en ont besoin, et Telegram ne permet pas à un bot de le retrouver ensuite.

Le plug-in ne porte aucun manifeste d’outils, ce qui compte surtout pour une longue exécution sans surveillance : l’agent appelle la commande hermoso à chaque étape, et --json sur n’importe quelle commande lui donne une sortie machine à vérifier.

Rechercher sur Telegram avant de publier

Il n’existe pas de bibliothèque publicitaire Telegram ni de recherche de chaînes dans Hermoso, donc aucune recherche concurrentielle sur Telegram n’est revendiquée. Faites la recherche créative là où elle est publique (les bibliothèques publicitaires Meta, Google et LinkedIn, plus TikTok, Instagram, YouTube, Reddit et Threads organiques) et publiez l’annonce finie ici.

La partie payante

Il n’existe pas de publicités Telegram dans Hermoso, et nous n’en suggérons aucune. Telegram ici est une chaîne que vous possédez et gérez via votre bot : publier, épingler, modifier, compter les abonnés et suivre les invitations. Les outils payants couvrent Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads et AppLovin Ads.

Ce que Claude Code ne peut pas faire seul

Un agent doté d'un budget n'est utile que si son rayon d'action est borné, donc le garde-fou se trouve dans le serveur et non dans une consigne. Chaque campagne, chaque ensemble d'annonces, chaque groupe d'annonces et chaque annonce publicitaire est créé en pause, et les changements de statut qui activent de l'argent réel refusent de s'exécuter sans un indicateur de confirmation explicite. Chaque rendu est d'abord chiffré (hermoso_capabilities publie le coût exact en crédits de chaque modèle avant toute dépense). Les crédits sont réservés avant le premier appel au fournisseur, puis imputés au coût exact après coup : un envoi qui échoue est remboursé plutôt que de vous facturer pour rien. Les suppressions sont aussi soumises à confirmation, et chaque arborescence de campagne est relue depuis la plateforme publicitaire avant que votre agent ne vous dise ce qu'il a construit.

Une étape vous revient délibérément : créer le bot avec @BotFather et l’ajouter à votre chaîne. Tout le reste est un appel d’outil.

Le reste de la matrice

Depuis Claude Code, publiez sur : Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou voir tout ce sur quoi Claude Code peut publier.

Publier sur Telegram depuis : Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Questions fréquentes

Claude Code peut-il publier sur Telegram ?

Oui, avec le plug-in Claude Code d’Hermoso. Une commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, si bien qu’aucune liste d’outils n’est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login, qui ouvre un navigateur et stocke l’identifiant lui-même : il n’y a donc aucune clé à créer ni à coller. Claude Code dispose alors de plus de 922 outils, y compris ceux qui publient sur Telegram, ainsi que ceux qui recherchent les publicités déjà diffusées sur votre marché et créent d’abord le visuel.

Comment connecter Telegram à Claude Code ?

Deux étapes, une fois chacune. Une commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, donc aucune liste d'outils n'est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login : cela ouvre un navigateur et enregistre l'identifiant lui-même, il n'y a donc ni clé à créer ni clé à coller. Créez ensuite un bot avec @BotFather dans Telegram, collez son jeton sous Paramètres → Connecteurs dans Hermoso, et ajoutez le bot à votre chaîne comme administrateur avec le droit Publier des messages. Ensuite, Claude Code publie sur Telegram comme un simple appel d'outil, en nommant à chaque fois le chat visé.

Claude Code a-t-il besoin de mon mot de passe Telegram ?

Non. Telegram se connecte par un bot que vous créez avec @BotFather ; Hermoso ne détient que le jeton de ce bot, donc Claude Code publie en tant que bot, jamais en tant que votre compte Telegram personnel. Le jeton peut être révoqué dans @BotFather à tout moment, et il n’est jamais transmis au modèle.

Claude Code peut-il planifier un post Telegram pour plus tard ?

Oui. schedule_post la met en file sur un calendrier commun à tous les autres canaux, avec une légende adaptée au canal si le texte doit différer, et list_scheduled et cancel_scheduled permettent de la lire et de la retirer. Telegram fait partie des onze canaux qui se mettent en file.

Claude Code peut-il publier un carrousel sur Telegram ?

Oui, sous forme d’album de 2 à 10 éléments, avec photos et vidéos mélangées, ce qui est la règle propre à Telegram pour sendMediaGroup. L’album porte une seule légende, sur son premier élément. Claude Code appelle le même outil de publication dans les deux cas, et un canal qui ne peut pas porter un carrousel est refusé, avec la vraie raison indiquée.

Combien coûte la publication sur Telegram depuis Claude Code ?

Publier sur Telegram ne coûte aucun crédit ; Telegram ne facture rien par appel. Les crédits sont dépensés pour générer le visuel. Les formules coûtent $29, $69 et $149 par mois pour 1 200, 3 000 et 7 000 crédits, et toutes les fonctionnalités sont incluses dans chaque formule, y compris la formule Gratuite. La seule exception est le SSO entreprise.