MCP Telegram
Quickstart'a geri dön

Telegram'a dosya ve ses gönderin

Belgeler, fotoğraflar, sesli notlar, video notlar, albümler, hatta hikâyeler ve yeni bir profil fotoğrafı — baytları olan her şey. AI bunları sizin adınıza gönderir; ya bir kez yüklediğiniz bir dosyadan ya da doğrudan herkese açık bir https:// URL'den.

1

Baytların nasıl içeri gireceğini seçin

İki yol: (1) dosyayı bir kez mcp-telegram.com/my/upload'a yükleyin, dönen uploadId'yi kopyalayın ve promptlarınızda buna atıfta bulunun; veya (2) AI'ya dosyaya işaret eden bir https:// URL verin — bulut onu çeker (SSRF korumasıyla, yani yerel/iç adresler engellenir). Maksimum dosya boyutu yaklaşık 50 MB'dır.

2

Tek bir dosya veya sesli not gönderin

Şunu söyleyin: "Bu PDF'i @friend'e gönder" uploadId veya URL ile. AI, telegram-send-file çağırır. Sesli mesajlar için (tercihen OGG/Opus, M4A/MP3 de çalışır) telegram-send-voice kullanın. Yuvarlak video mesajları için telegram-send-video-note kullanın.

3

1-10 fotoğraf veya videodan oluşan bir albüm gönderin

Şunu söyleyin: "Bu 5 fotoğrafı aile sohbetime albüm olarak başlıklarla birlikte gönder." AI, telegram-send-album çağırır. Her öğenin kendi uploadId-veya-URL'si ve isteğe bağlı başlığı olur. İlk öğenin başlığı Telegram'da albümün başlığı olarak görünür.

4

Yeni bir profil fotoğrafı ayarlayın

Şunu söyleyin: "Bunu Telegram profil fotoğrafım olarak ayarla" uploadId veya URL ile. AI, telegram-set-profile-photo çağırır. Hem görseller hem de kısa MP4'ler çalışır. Hesabınız gizli olduğunda fotoğrafın gösterilmesini istiyorsanız fallback:true kullanın.

Bu promptları deneyin

"https://example.com/contract.pdf adresindeki dosyayı @lawyer'a gönder"

"Yüklediğim 4 fotoğraftan bir albüm yap ve 'Hafta sonu gezisi' başlığıyla aile sohbetine paylaş"

"uploadId abc123'ten yeni profil fotoğrafımı ayarla"

Sorun giderme

URL çekme "address not allowed" hatasıyla başarısız oldu

SSRF koruması, özel, link-local, loopback veya metadata IP adreslerine çözümlenen URL'leri engeller. Herkese açık bir https:// URL kullanın veya dosyayı önce /my/upload üzerinden yükleyip uploadId'yi referans alın.

Dosya çok büyük

Bulut yüklemeleri yaklaşık 50 MB ile sınırlıdır. Daha büyük dosyalar için bunları herkese açık bir sunucuda barındırın ve https:// URL'yi geçirin — Telegram'ın kendisi 2 GB'a kadar destekler, bulut sınırı yalnızca yükleme adımında geçerlidir.

uploadId süresi doldu veya bulunamadı

Bekleyen yüklemeler /my/upload sonrasında kısa bir süre saklanır. Kullanmak için çok beklediyseniz tekrar yükleyin ve yeni uploadId'yi kullanın.