MCP Telegram
К Быстрому старту

Отправка файлов и голосовых в Telegram

Документы, фото, голосовые, видео-кружочки, альбомы, даже истории и новое фото профиля — всё, что состоит из байтов. ИИ отправит от вашего имени, либо из заранее загруженного файла, либо прямо по публичной https:// ссылке.

1

Выберите как доставить байты

Два пути: (1) загрузите файл один раз на mcp-telegram.com/my/upload, скопируйте возвращённый uploadId и используйте его в промптах; либо (2) дайте ИИ https:// URL на файл — облако само скачает (с SSRF-защитой: локальные/внутренние адреса заблокированы). Максимальный размер — около 50 МБ.

2

Отправьте файл или голосовое

Скажите: «Отправь этот PDF @friend» с uploadId или URL. ИИ вызовет telegram-send-file. Для голосовых (OGG/Opus предпочтительно, M4A/MP3 тоже работают) — telegram-send-voice. Для круглых видео-сообщений — telegram-send-video-note.

3

Отправьте альбом 1–10 фото или видео

Скажите: «Отправь эти 5 фото в семейный чат альбомом, с подписями.» ИИ вызовет telegram-send-album. У каждого элемента свой uploadId-или-URL и опциональная подпись. Подпись первого элемента становится подписью альбома в Telegram.

4

Поставьте новое фото профиля

Скажите: «Поставь это как моё фото профиля Telegram» с uploadId или URL. ИИ вызовет telegram-set-profile-photo. Работают и картинки, и короткие MP4. fallback:true — если хотите задать фото, которое показывается при приватном аккаунте.

Попробуйте промпты

"Отправь файл с https://example.com/contract.pdf на @lawyer"

"Сделай альбом из 4 загруженных фото и отправь в семейный чат с подписью «Выходные»"

"Поставь моё новое фото профиля из uploadId abc123"

Что-то пошло не так

URL не скачался: «адрес не разрешён»

SSRF-защита блокирует URL, которые резолвятся в приватные, link-local, loopback или metadata IP-адреса. Используйте публичный https:// URL, либо загрузите файл через /my/upload и используйте uploadId.

Файл слишком большой

Аплоад в облако ограничен ~50 МБ. Для бóльших файлов разместите на публичном сервере и передайте https:// URL — сам Telegram поддерживает до 2 ГБ, лимит только на шаге аплоада в облако.

uploadId устарел или не найден

Pending-аплоады хранятся ограниченное время после /my/upload. Если затянули — загрузите снова и используйте новый uploadId.