Publicar no Telegram a partir do Codex

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 Codex acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Codex consegue fazer de fato no Telegram, e o que o Telegram não deixa que ele faça.

Conectar o Hermoso ao Codex

1. Um comando, e nenhuma chave.

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   O Codex lê o arquivo de marketplace no repositório público da Hermoso e instala as cinco skills dele (research, ad-from-brand, generate, product-photoshoot e marketing). As skills rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, em ~/.hermoso/config.json. Sem navegador nessa máquina, por exemplo em CI ou em um contêiner? Crie uma chave em MCP & CLI → Terminal e chaves de API e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha.
3. Opcional: o servidor MCP também.

   codex mcp add hermoso -- npx -y hermoso mcp

   Isso grava o servidor em ~/.codex/config.toml e lê a mesma credencial guardada, então nenhuma chave vai no arquivo. Prefere o endpoint hospedado? codex mcp add hermoso --url https://app.hermoso.ai/mcp e depois codex mcp login hermoso para o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois.
4. Peça algo ao Codex. “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 Codex guarda os servidores MCP em ~/.codex/config.toml, ou em .codex/config.toml de um projeto confiável, e esse arquivo é TOML, não JSON: um bloco mcpServers copiado não carrega, e uma entrada escrita à mão é [mcp_servers.hermoso] com command = "npx" e args = ["-y", "hermoso", "mcp"]. O mcp final é essencial: npx -y hermoso sem subcomando só mostra a ajuda e sai. O Codex lê marketplaces de plugin no mesmo layout .claude-plugin que o Claude Code usa, por isso um único repositório instala nos dois.

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 Codex 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 Codex

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

“Sem interação: todo dia útil às 8h, publique a oferta do dia em @ourdeals com a imagem do produto, em silêncio, e imprima o id da mensagem em JSON.”

Isso percorre render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. No modo interativo, o Codex mostra a chamada antes de rodá-la. No modo não interativo não há ninguém para perguntar, o que vale a pena considerar em qualquer etapa que publique ou gaste.

Codex no Telegram: a parte que pega

Coloque o chatId na configuração, e não em um palpite do prompt. O schedule_post o carrega por post, do mesmo jeito que carrega um painel do Pinterest, e um post do Telegram na fila sem ele é recusado na entrada. O silent entrega sem som de notificação, o que combina com um post diário em um canal que as pessoas mantêm aberto. Isso não muda quem vê a mensagem; quem decide é o chat.

Em execuções sem supervisão, prefira a CLI hermoso com --json ao manifesto completo de ferramentas. Ela custa bem menos contexto e é mais fácil de 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 Codex 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 Codex, publique em: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Ou veja tudo o que o Codex consegue publicar.

Publique no Telegram a partir de: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anúncios pela linha de comando

Perguntas frequentes

O Codex consegue publicar no Telegram?

Sim, com o plugin do Codex da Hermoso. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. O Codex passa a ter mais de 922+ ferramentas, incluindo as que publicam no Telegram e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o Telegram ao Codex?

Duas etapas, uma vez cada. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. 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 Codex publica no Telegram como uma chamada de ferramenta comum, citando o chat a cada vez.

O Codex 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 Codex 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 Codex?

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.

O Codex 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 Codex 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 Codex 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.