Post no Telegram
Crie e agende postagens em canais e grupos do Telegram usando o servidor MCP Publora. Suporta formatação Markdown avançada, fotos, vídeos e opções de entrega de mensagens.
Pré-requisitos
Planos: Funciona no plano gratuito Starter. Limites e preços atuais: publora.com/pricing.
Primeiros Passos
- Crie uma conta em publora.com/register (gratuita)
- Crie um bot no Telegram:
- Envie uma mensagem para @BotFather no Telegram
- Envie
/newbote siga as instruções - Salve o token do bot
- Adicione o bot ao seu canal:
- Adicione o bot como administrador ao seu canal/grupo
- Conceda a permissão
can_post_messages
- Conecte no Publora pelo Painel com o token do bot e o nome do canal
- Obtenha a chave da API em app.publora.com/dashboard/api
- Conecte seu agente ao servidor MCP em
https://mcp.publora.com, autenticando comAuthorization: Bearer sk_SUA_CHAVE_DE_API. No Claude Code:
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_SUA_CHAVE_DE_API"
Claude Desktop, Cursor, Codex, OpenClaw e o conector do claude.ai exigem arquivos ou fluxos de configuração diferentes: veja configuração do cliente para o caminho e trecho exatos.
Fallback da API REST
Se o servidor MCP estiver indisponível ou retornar erros, use a API REST diretamente:
URL Base: https://api.publora.com/api/v1
Autenticação: Use o cabeçalho x-publora-key (NÃO Authorization: Bearer):
# Obtenha suas plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_sua_chave_de_api"
# Crie uma postagem
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_sua_chave_de_api" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["telegram-1001234567890"],
"content": "*Anúncio*\n\nSua mensagem aqui",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
Formato do ID da Plataforma: telegram-{chat_id} onde {chat_id} é o ID numérico do canal/grupo de /platform-connections.
Exemplos de IDs: telegram-1001234567890, telegram--1002345678901
📖 Documentação completa da API: docs.publora.com
Limites da Plataforma (API Bot)
| Recurso | Limite |
|---|---|
| Mensagem de texto | 4.096 caracteres |
| Legenda de mídia | 1.024 caracteres (limite crítico!) |
| Imagens | 10 MB no máximo, 10 por grupo de mídia |
| Formatos de imagem | JPEG, PNG, GIF, BMP, WebP |
| Tamanho do vídeo | 50 MB no máximo (não 4 GB — isso é para usuários!) |
| Formatos de vídeo | MP4, MOV, AVI, MKV, WebM |
| Limite de taxa | 30 msg/s global, 20 msg/min por grupo |
Crítico: A API Bot tem limites muito inferiores aos de usuários comuns do Telegram. Vídeos acima de 50 MB e legendas acima de 1.024 caracteres falharão.
Formatação Markdown
O Telegram usa seu próprio sabor de Markdown com asteriscos simples para negrito:
| Sintaxe | Resultado |
|---|---|
*negrito* | negrito |
_itálico_ | itálico |
`código` | código em linha |
código | Bloco de código |
[texto](url) | hyperlink |
> texto | Citação em bloco |
Nota: Isso difere do Markdown padrão onde **asteriscos duplos** fazem negrito.
Ferramentas Disponíveis
create_post
Crie uma nova postagem no Telegram.
Parâmetros:
platforms: Array com o ID da sua conexão do Telegram (ex.:["telegram-1001234567890"])content: Texto da mensagem (suporta markdown)scheduledTime: Data/hora UTC no formato ISO 8601. Opcional: omita e a postagem será criada como rascunho. Envie um horário futuro para agendar. Um horário com cinco ou mais minutos no passado será rejeitado comSCHEDULED_TIME_IN_PAST; portanto, para postagem imediata, use o horário atual mais um minuto.mediaUrls: Até 10 URLs públicas https de imagens ou vídeos. O Publora faz o download no servidor e as anexa antes da validação, então mídia e agendamento ocorrem em uma única chamada. Esta é a alternativa única ao fluxo de rascunho seguido deget_upload_urlecomplete_media. A ingestão é limitada a 60 URLs por hora.
get_upload_url
Obtenha uma URL pré-assinada para uploads de mídia.
complete_media
Finalize um arquivo enviado através de get_upload_url, após o PUT pré-assinado ser bem-sucedido. Opcional, pois o agendamento também finaliza mídia pendente, mas chamá-lo cedo expõe erros de formato e sonda antes da publicação. Não é necessário para mídia anexada com mediaUrls.
Parâmetros:
mediaId: o ID retornado porget_upload_url
list_connections
Liste suas contas conectadas com seus IDs de plataforma. Chame isso primeiro e copie os IDs literalmente; eles nunca são adivinháveis.
list_posts / get_post / update_post / delete_post
Gerencie postagens agendadas e rascunhos. update_post também corrige content e platforms em um rascunho ou postagem agendada, então corrigir um erro de digitação ou redirecionar não significa mais deletar e recriar. delete_media e prune_media_reference limpam arquivos enviados.
Opções de Postagem (via API REST)
Opções específicas do Telegram disponíveis via platformSettings.telegram na API REST:
| Opção | Descrição |
|---|---|
disableNotification | Enviar silenciosamente (sem som) |
disableWebPagePreview | Sem cartões de pré-visualização de links |
protectContent | Impedir encaminhamento/salvamento |
Legenda acima da mídia não é configurável: showCaptionAboveMedia não é uma chave aceita e enviá-la retorna 400 PLATFORM_SETTING_UNKNOWN.
Nota: platformSettings é aceito pelas ferramentas MCP create_post e update_post, bem como via REST. O esquema é estrito: uma plataforma ou chave digitada incorretamente é rejeitada com um erro de validação, em vez de ser ignorada silenciosamente.
Exemplos
Postagem Simples em Canal
Publique isto no meu canal do Telegram:
"*Atualização do Produto v2.5*
Nós implementamos as seguintes melhorias:
- _Tempos de resposta mais rápidos da API_ (média 45ms)
- Novo endpoint `batch` para operações em lote
[Leia o changelog](https://exemplo.com/changelog)"
Anúncio Formatado
Crie uma postagem no Telegram com esta formatação:
"*Atualização Importante*
Estamos lançando nosso novo recurso amanhã às 10:00 UTC.
_O que há de novo:_
- Melhorias no Recurso A
- Lançamento do Recurso B
[Leia o anúncio completo](https://exemplo.com/atualizacao)"
Postagem com Imagem
Publique esta imagem no meu canal do Telegram com legenda:
"*Prévia do Novo Painel*
Aqui está uma prévia do nosso painel de análises redesenhado."
Importante: A legenda deve ter menos de 1.024 caracteres ao publicar com mídia.
Postagem Agendada
Agende isto para amanhã às 8:00, horário de Moscou:
"*Bom dia!* Aqui está o resumo diário do mercado..."
Restrições Importantes
-
Limite de legenda é de 1.024 caracteres: Ao publicar com mídia (imagens/vídeos), o texto é enviado como legenda limitada a 1.024 caracteres. Mensagens somente texto permitem 4.096 caracteres.
-
Vídeo máximo de 50 MB: A API Bot limita vídeos a 50 MB (não 4 GB como usuários comuns). Vídeos grandes falharão.
-
Bot precisa ser administrador: Seu bot precisa do papel de administrador com permissão
can_post_messages. Isso é verificado no momento da conexão. -
Sem mídia mista: Uma única postagem não pode conter imagens e vídeos simultaneamente.
-
Estouro de legenda: Se a legenda exceder 1.024 caracteres em uma postagem com mídia, ela é enviada como uma mensagem de resposta separada, em vez de ser truncada.
Melhores Práticas
Conteúdo
- Use formatação: Títulos em negrito, ênfase em itálico melhoram a legibilidade
- Pré-visualizações de links: Ótimas para artigos; desative para anúncios mais limpos
- Uso de emojis: Comuns e esperados no Telegram
- Comprimento da postagem: Sem penalidade para postagens mais longas em mensagens somente texto
Horário
- Público global: Usuários do Telegram estão em todo o mundo; considere fusos horários nas postagens
- Melhores horários: 8-10h, 12-14h, 19-21h nas regiões-alvo
- Frequência: Canais podem publicar com mais frequência (5-10/dia)
Engajamento
- Ative comentários nas configurações do canal para discussões
- Use enquetes para engajamento
- Fixe anúncios importantes
Solução de Problemas
| Erro | Causa | Solução |
|---|---|---|
| "Bot não é administrador" | Bot sem permissões de admin | Adicione o bot como admin com can_post_messages |
| "Canal não encontrado" | Nome/ID do canal errado | Verifique @nome_do_canal ou o ID numérico do chat |
MEDIA_CAPTION_TOO_LONG | Legenda > 1.024 caracteres | Encurte a legenda ou use postagem só de texto |
| "Bad Request: o arquivo é muito grande" | Arquivo > 50 MB | Comprima vídeo/imagem para menos de 50 MB |
| "Mídia mista não suportada" | Imagens + vídeo na mesma postagem | Use um tipo de mídia por postagem |