MCP Telegram
← Torna alla Guida rapida

Invia file e vocali a Telegram

Documenti, foto, messaggi vocali, video messaggi, album, persino storie e una nuova foto profilo — tutto ciò che ha byte allegati. L'IA li invia per tuo conto, da un file caricato una volta o direttamente da un URL https:// pubblico.

1

Scegli come arrivano i byte

Due vie: (1) carica un file una volta su mcp-telegram.com/my/upload, copia l'uploadId restituito e citalo nei prompt; oppure (2) passa all'IA un URL https:// che punta al file — il cloud lo recupererà (con protezione SSRF, quindi indirizzi locali/interni sono bloccati). La dimensione massima del file è circa 50 MB.

2

Invia un singolo file o messaggio vocale

Di': "Manda questo PDF a @friend" con l'uploadId o l'URL. L'IA chiama telegram-send-file. Per i messaggi vocali (OGG/Opus preferito, anche M4A/MP3 funzionano) usa telegram-send-voice. Per i video messaggi circolari usa telegram-send-video-note.

3

Invia un album di 1-10 foto o video

Di': "Manda queste 5 foto alla chat di famiglia come album, con didascalie." L'IA chiama telegram-send-album. Ogni elemento ha il proprio uploadId-o-URL e una didascalia opzionale. La didascalia del primo elemento appare come didascalia dell'album in Telegram.

4

Imposta una nuova foto profilo

Di': "Imposta questa come mia foto profilo Telegram" con un uploadId o URL. L'IA chiama telegram-set-profile-photo. Funzionano sia immagini che brevi MP4. Usa fallback:true se vuoi che la foto sia mostrata quando il tuo account è privato.

Prova questi prompt

"Manda il file su https://example.com/contract.pdf a @lawyer"

"Crea un album dalle 4 foto che ho caricato e pubblicalo nella chat di famiglia con la didascalia 'Gita del weekend'"

"Imposta la mia nuova foto profilo dall'uploadId abc123"

Risoluzione dei problemi

Recupero dell'URL fallito con "address not allowed"

La protezione SSRF blocca gli URL che si risolvono in indirizzi IP privati, link-local, loopback o metadata. Usa un URL https:// pubblico, oppure carica prima il file via /my/upload e fai riferimento all'uploadId.

File troppo grande

I caricamenti sul cloud sono limitati a circa 50 MB. Per file più grandi, ospitali su un server pubblico e passa l'URL https:// — Telegram stesso supporta fino a 2 GB, il limite del cloud è solo sul passo di upload.

uploadId scaduto o non trovato

I caricamenti pendenti sono conservati per una breve finestra dopo /my/upload. Se hai impiegato troppo tempo a usarne uno, carica di nuovo e usa il nuovo uploadId.