Publicar no Telegram a partir do Claude Code

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Claude Code acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Claude Code consegue fazer de fato no Telegram, e o que o Telegram não deixa que ele faça.

Conectar o Hermoso ao Claude Code

1. Um comando, e sem chave.

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

   Já está dentro de uma sessão? Digite /plugin marketplace add hermoso-ai/hermoso, depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso (research, ad-from-brand, generate, product-photoshoot e marketing) que rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões, e nada custa contexto até ser executado.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador em loopback, do mesmo jeito que o gh faz, e guarda uma credencial de acesso exclusivo do dono em ~/.hermoso/config.json. O Claude Code roda isso por você na primeira vez que precisar da Hermoso. Sem navegador nessa máquina, por exemplo em CI, num servidor remoto ou num contêiner? Crie uma chave em MCP & CLI → Terminal & API keys e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real para gastar, então trate-a como uma senha.
3. Opcional: o servidor MCP também. Se você quiser também as ferramentas da Hermoso na lista de ferramentas do próprio Claude Code, rode claude mcp add hermoso -- npx -y hermoso mcp depois de entrar. Ele lê a mesma credencial guardada, então nenhuma chave vai para o .claude.json. As skills alcançam todas as ferramentas sem ele.
4. Peça algo ao Claude Code. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

O plugin e o servidor MCP opcional acessam as mesmas ferramentas e a mesma conta. A diferença é o contexto: uma lista de ferramentas é carregada em cada sessão antes de você digitar qualquer coisa, enquanto as skills não custam nada até que um comando seja executado.

Depois conecte o próprio Telegram, uma vez, em Configurações → Conectores na Hermoso, colando um token de bot do @BotFather, e adicione esse bot ao seu canal como administrador. Não há tela de consentimento: o token é a credencial, e o bot é quem publica.

As ferramentas do Telegram que o Claude Code recebe

• post_to_telegram: envia uma mensagem como o seu bot para o chat que você indicar: texto de até 4.096 caracteres, ou uma foto, um vídeo, ou um álbum de 2 a 10 com fotos e vídeos misturados.
• schedule_post: coloca na fila com o seu chatId, no mesmo calendário de todos os outros canais.
• list_telegram_chats: os chats que enviaram mensagem ao bot nas últimas 24 horas. Ajuda a encontrar um ID, e não é uma lista de todos os chats em que o bot está.
• edit_telegram_message / pin_telegram_message: corrige o texto ou a legenda de uma mensagem sem perder as visualizações, e fixa ou desafixa a chamada para ação.
• create_telegram_invite_link: um link de convite nomeado por campanha, com validade, limite de membros ou aprovação de entrada opcionais, para você ver quem entrou e por onde.
• telegram_account: a contagem de assinantes ou membros do chat, o título, a descrição e o link de convite.
• list_telegram_dms: o que as pessoas enviaram ao bot nas últimas 24 horas, da mais recente para a mais antiga, para responder com post_to_telegram.
• delete_telegram_message: remove uma mensagem que o bot enviou, dentro da janela de 48 horas do Telegram, depois de uma etapa de confirmação.

O Telegram conecta com um token de bot, e não com uma tela de login. Crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores e depois adicione o bot ao seu canal como administrador com a permissão Publicar mensagens, ou a um grupo como membro que pode publicar. A Hermoso publica como esse bot, nunca como você. Dois limites são do próprio Telegram e vale planejar em torno deles: um bot não recebe visualizações por publicação nem histórico de publicações, então a contagem de assinantes e os links de convite nomeados são os números que você tem; e as mensagens enviadas ao bot são guardadas por 24 horas e depois somem. Publicar não consome créditos.

Limites do Telegram que vale conhecer antes de automatizar qualquer coisa

Experimente no Claude Code

Peça em linguagem comum. São frases simples, não uma DSL:

“Envie as quatro imagens de ./out/launch como um único álbum no Telegram para o chat -1001234567890, com a legenda de ./copy/tg.txt, e registre o id da mensagem.”

Isso percorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. O Claude Code pede confirmação antes de rodar uma ferramenta, e a transcrição fica ali no terminal, então cada etapa de publicação é uma linha que você lê antes de apertar y.

Claude Code no Telegram: a parte que pega

Valem dois limites de texto, e o mais apertado vale assim que houver mídia anexada: 4,096 caracteres para uma mensagem só de texto e 1,024 para uma legenda, e um álbum mostra uma legenda só, no primeiro item. A Hermoso envia os arquivos em vez de passar um link para o Telegram, o que eleva o limite para 10MB por foto e 50MB por vídeo. Guarde o id da mensagem. Editar e apagar precisam dele, e o Telegram não dá a um bot como buscá-lo depois.

O plugin não traz manifesto de ferramentas, o que importa mais em uma execução longa e sem supervisão: o agente chama o comando hermoso a cada etapa, e --json em qualquer comando lhe dá uma saída de máquina para validar.

Pesquise o Telegram antes de publicar

Não existe biblioteca de anúncios do Telegram nem busca de canais na Hermoso, então ela não afirma fazer pesquisa de concorrentes no Telegram. Pesquise o criativo onde ele é público (as bibliotecas de anúncios da Meta, do Google e do LinkedIn, além do TikTok, Instagram, YouTube, Reddit e Threads orgânicos) e publique o anúncio pronto aqui.

A metade paga

Não há anúncios do Telegram na Hermoso, e não damos a entender que haja. Aqui o Telegram é um canal que você possui e administra pelo seu bot: publicar, fixar, editar, contar assinantes e acompanhar convites. As ferramentas pagas cobrem Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

O que o Claude Code não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Um passo fica propositalmente com você: criar o bot com o @BotFather e adicioná-lo ao seu canal. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

Pelo Claude Code, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou veja tudo o que o Claude Code consegue publicar.

Publique no Telegram a partir de: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing com Claude Code

Perguntas frequentes

O Claude Code consegue publicar no Telegram?

Sim, com o plugin do Claude Code da Hermoso. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. O Claude Code então tem 922+ ferramentas, incluindo as que publicam no Telegram, além das que pesquisam os anúncios que já estão rodando no seu mercado e renderizam o criativo em primeiro lugar.

Como conecto o Telegram ao Claude Code?

Duas etapas, uma vez cada. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Depois crie um bot com o @BotFather no Telegram, cole o token em Configurações → Conectores na Hermoso e adicione o bot ao seu canal como administrador com a permissão Postar mensagens. Depois disso o Claude Code publica no Telegram como uma chamada de ferramenta comum, citando o chat a cada vez.

O Claude Code precisa da minha senha do Telegram?

Não. O Telegram conecta por meio de um bot que você cria com o @BotFather, e a Hermoso guarda apenas o token desse bot. Assim, o Claude Code publica como o bot, nunca como a sua conta pessoal do Telegram. O token pode ser revogado no @BotFather a qualquer momento, e nunca é entregue ao modelo.

O Claude Code consegue agendar um post no Telegram para depois?

Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O Telegram é um dos onze canais que entram na fila.

O Claude Code consegue publicar um carrossel no Telegram?

Sim, como um álbum de 2 a 10 itens, com fotos e vídeos misturados, que é a regra do próprio Telegram para sendMediaGroup. O álbum leva uma só legenda, no primeiro item. O Claude Code chama a mesma ferramenta de publicação de qualquer forma, e um canal que não comporta carrossel é recusado com o motivo real indicado.

Quanto custa publicar no Telegram a partir do Claude Code?

Publicar no Telegram não consome créditos; o Telegram não cobra nada por chamada. Os créditos são gastos na geração do criativo. Os planos são $29, $69 e $149 por mês, para 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, incluindo o Grátis. A única exceção é o SSO empresarial.