MCP Telegram
Kembali ke Quickstart

Kirim file & voice ke Telegram

Dokumen, foto, voice notes, video notes, album, bahkan stories dan foto profil baru — apa pun yang memiliki byte terlampir. AI mengirimkannya atas nama Anda, baik dari file yang Anda unggah sekali, maupun langsung dari URL https:// publik.

1

Pilih cara byte masuk

Dua jalur: (1) unggah sebuah file sekali di mcp-telegram.com/my/upload, salin uploadId yang dikembalikan, lalu rujuk pada prompt Anda; atau (2) berikan AI sebuah URL https:// yang menunjuk ke file — cloud akan mengambilnya (dengan proteksi SSRF, sehingga alamat lokal/internal diblokir). Ukuran file maksimum sekitar 50 MB.

2

Kirim satu file atau voice note

Katakan: "Kirim PDF ini ke @friend" dengan uploadId atau URL. AI memanggil telegram-send-file. Untuk pesan suara (OGG/Opus lebih disarankan, M4A/MP3 juga bisa) gunakan telegram-send-voice. Untuk pesan video bulat gunakan telegram-send-video-note.

3

Kirim album berisi 1-10 foto atau video

Katakan: "Kirim 5 foto ini ke chat keluarga sebagai album, dengan keterangan." AI memanggil telegram-send-album. Setiap item memiliki uploadId-atau-URL sendiri dan keterangan opsional. Keterangan item pertama akan tampil sebagai keterangan album di Telegram.

4

Tetapkan foto profil baru

Katakan: "Jadikan ini foto profil Telegram saya" dengan uploadId atau URL. AI memanggil telegram-set-profile-photo. Gambar maupun MP4 pendek sama-sama berfungsi. Gunakan fallback:true bila Anda ingin foto ditampilkan saat akun Anda dalam mode privat.

Coba prompt berikut

"Kirim file di https://example.com/contract.pdf ke @lawyer"

"Buat album dari 4 foto yang saya unggah dan kirim ke chat keluarga dengan keterangan 'Liburan akhir pekan'"

"Tetapkan foto profil baru saya dari uploadId abc123"

Pemecahan masalah

Pengambilan URL gagal dengan "address not allowed"

Pengaman SSRF memblokir URL yang resolve ke alamat IP privat, link-local, loopback, atau metadata. Gunakan URL https:// publik, atau unggah file terlebih dahulu via /my/upload dan rujuk uploadId-nya.

File terlalu besar

Unggahan cloud dibatasi sekitar 50 MB. Untuk file yang lebih besar, host di server publik dan kirim URL https://-nya — Telegram sendiri mendukung hingga 2 GB, batas cloud hanya berlaku pada tahap upload.

uploadId kedaluwarsa atau tidak ditemukan

Unggahan yang menunggu hanya disimpan dalam jangka waktu pendek setelah /my/upload. Jika Anda terlalu lama menggunakannya, unggah lagi dan gunakan uploadId yang baru.