MCP Telegram
← Voltar ao Início rápido

Envie arquivos e áudios para o Telegram

Documentos, fotos, mensagens de voz, vídeo mensagens, álbuns, até stories e uma nova foto de perfil — qualquer coisa que tenha bytes anexados. A IA envia em seu nome, de um arquivo enviado uma vez ou direto de uma URL https:// pública.

1

Escolha como os bytes chegam

Dois caminhos: (1) envie um arquivo uma vez em mcp-telegram.com/my/upload, copie o uploadId retornado e cite-o nos seus prompts; ou (2) dê à IA uma URL https:// apontando para o arquivo — a cloud vai buscá-lo (com proteção contra SSRF, então endereços locais/internos são bloqueados). O tamanho máximo do arquivo é cerca de 50 MB.

2

Envie um único arquivo ou áudio

Diga: "Envie este PDF para @friend" com o uploadId ou URL. A IA chama telegram-send-file. Para mensagens de voz (OGG/Opus preferido, M4A/MP3 também funcionam) use telegram-send-voice. Para vídeo mensagens redondas use telegram-send-video-note.

3

Envie um álbum de 1-10 fotos ou vídeos

Diga: "Envie estas 5 fotos para a conversa da família como álbum, com legendas." A IA chama telegram-send-album. Cada item recebe seu próprio uploadId-ou-URL e legenda opcional. A legenda do primeiro item aparece como legenda do álbum no Telegram.

4

Defina uma nova foto de perfil

Diga: "Defina esta como minha foto de perfil do Telegram" com um uploadId ou URL. A IA chama telegram-set-profile-photo. Imagens e MP4s curtos funcionam. Use fallback:true se quiser que a foto seja mostrada quando sua conta estiver privada.

Experimente estes prompts

"Envie o arquivo em https://example.com/contract.pdf para @lawyer"

"Monte um álbum com as 4 fotos que enviei e poste na conversa da família com a legenda 'Viagem de fim de semana'"

"Defina minha nova foto de perfil a partir do uploadId abc123"

Solução de problemas

Falha ao buscar URL com "address not allowed"

A proteção SSRF bloqueia URLs que resolvem para endereços IP privados, link-local, loopback ou de metadados. Use uma URL https:// pública, ou envie o arquivo primeiro via /my/upload e cite o uploadId.

Arquivo muito grande

Os uploads na cloud são limitados a cerca de 50 MB. Para arquivos maiores, hospede-os em um servidor público e passe a URL https:// — o Telegram em si suporta até 2 GB, o limite da cloud é só no passo de upload.

uploadId expirado ou não encontrado

Uploads pendentes ficam guardados por uma janela curta após /my/upload. Se você demorou demais para usar um, envie de novo e use o novo uploadId.