MCP Telegram
Powrót do Quickstart

Wysyłaj pliki i głos do Telegrama

Dokumenty, zdjęcia, wiadomości głosowe, video notes, albumy, a nawet stories i nowe zdjęcie profilowe — wszystko, co ma dołączone bajty. AI wyśle je w Twoim imieniu, albo z pliku, który raz przesłałeś, albo bezpośrednio z publicznego https:// URL.

1

Wybierz, jak bajty trafią na serwer

Dwie ścieżki: (1) prześlij plik raz na mcp-telegram.com/my/upload, skopiuj zwrócony uploadId i odwołuj się do niego w promptach; lub (2) podaj AI https:// URL wskazujący na plik — chmura go pobierze (z ochroną SSRF, więc adresy lokalne/wewnętrzne są blokowane). Maksymalny rozmiar pliku to około 50 MB.

2

Wyślij pojedynczy plik lub wiadomość głosową

Powiedz: „Wyślij ten PDF do @friend" z uploadId lub URL. AI wywoła telegram-send-file. Dla wiadomości głosowych (preferowane OGG/Opus, M4A/MP3 też działają) użyj telegram-send-voice. Dla okrągłych video messages użyj telegram-send-video-note.

3

Wyślij album 1-10 zdjęć lub wideo

Powiedz: „Wyślij te 5 zdjęć na czat rodzinny jako album, z podpisami." AI wywoła telegram-send-album. Każdy element ma własny uploadId-lub-URL i opcjonalny podpis. Podpis pierwszego elementu pojawia się jako podpis albumu w Telegramie.

4

Ustaw nowe zdjęcie profilowe

Powiedz: „Ustaw to jako moje zdjęcie profilowe w Telegramie" z uploadId lub URL. AI wywoła telegram-set-profile-photo. Działają zarówno obrazy, jak i krótkie MP4. Użyj fallback:true, jeśli chcesz, aby zdjęcie było widoczne, gdy Twoje konto jest prywatne.

Wypróbuj te prompty

"Wyślij plik z https://example.com/contract.pdf do @lawyer"

"Zrób album z 4 zdjęć, które przesłałem, i opublikuj go na czacie rodzinnym z podpisem 'Wycieczka weekendowa'"

"Ustaw moje nowe zdjęcie profilowe z uploadId abc123"

Rozwiązywanie problemów

Pobranie URL nie powiodło się z „address not allowed"

Ochrona SSRF blokuje URL-e, które rozwiązują się do prywatnych, link-local, loopback lub metadata adresów IP. Użyj publicznego https:// URL lub najpierw prześlij plik przez /my/upload i odwołaj się do uploadId.

Plik za duży

Przesyłanie do chmury jest ograniczone do około 50 MB. Dla większych plików hostuj je na publicznym serwerze i przekaż https:// URL — sam Telegram obsługuje do 2 GB, limit chmury dotyczy tylko etapu uploadu.

uploadId wygasł lub nie znaleziono

Oczekujące uploady są przechowywane przez krótki okres po /my/upload. Jeśli zajęło Ci to za długo, prześlij ponownie i użyj nowego uploadId.