MCP Telegram
← Retour au démarrage rapide

Envoyer fichiers & voix à Telegram

Documents, photos, messages vocaux, video notes, albums, et même des stories ou une nouvelle photo de profil — tout ce qui a des octets attachés. L'IA les envoie en votre nom, soit depuis un fichier téléversé une seule fois, soit directement depuis une URL https:// publique.

1

Choisissez comment les octets arrivent

Deux chemins : (1) téléversez un fichier une seule fois sur mcp-telegram.com/my/upload, copiez l'uploadId renvoyé, et référencez-le dans vos prompts ; ou (2) donnez à l'IA une URL https:// pointant vers le fichier — la cloud la récupérera (avec protection SSRF, donc les adresses locales/internes sont bloquées). La taille maximale est d'environ 50 Mo.

2

Envoyez un fichier seul ou un message vocal

Dites : « Envoie ce PDF à @friend » avec l'uploadId ou l'URL. L'IA appelle telegram-send-file. Pour les messages vocaux (OGG/Opus de préférence, M4A/MP3 fonctionnent aussi), utilisez telegram-send-voice. Pour les video notes (vidéos rondes), utilisez telegram-send-video-note.

3

Envoyez un album de 1 à 10 photos ou vidéos

Dites : « Envoie ces 5 photos à mon chat famille comme un album, avec des légendes. » L'IA appelle telegram-send-album. Chaque élément a sa propre uploadId-ou-URL et une légende optionnelle. La légende du premier élément apparaît comme légende de l'album dans Telegram.

4

Définissez une nouvelle photo de profil

Dites : « Mets ceci comme ma photo de profil Telegram » avec une uploadId ou une URL. L'IA appelle telegram-set-profile-photo. Les images et les MP4 courts fonctionnent tous les deux. Utilisez fallback:true si vous voulez que la photo soit visible quand votre compte est privé.

Essayez ces prompts

"Envoie le fichier à l'adresse https://example.com/contract.pdf à @lawyer"

"Fais un album avec les 4 photos que j'ai téléversées et publie-le dans le chat famille avec la légende 'Week-end'"

"Définis ma nouvelle photo de profil à partir de l'uploadId abc123"

Dépannage

Récupération d'URL échouée avec « address not allowed »

La protection SSRF bloque les URL qui résolvent vers des adresses IP privées, link-local, loopback ou de métadonnées. Utilisez une URL https:// publique, ou téléversez d'abord le fichier via /my/upload et référencez l'uploadId.

Fichier trop volumineux

Les téléversements de la cloud sont plafonnés à environ 50 Mo. Pour les fichiers plus volumineux, hébergez-les sur un serveur public et passez l'URL https:// — Telegram lui-même supporte jusqu'à 2 Go, la limite de la cloud ne concerne que l'étape de téléversement.

uploadId expiré ou introuvable

Les téléversements en attente ne sont conservés qu'une courte fenêtre après /my/upload. Si vous avez pris trop de temps avant de l'utiliser, téléversez à nouveau et utilisez le nouvel uploadId.