Отправка медиа

Поддерживаемые типы:

• sendPhoto — фото
• sendVideo — видео
• sendDocument — любой файл
• sendVoice — голосовое (opus/ogg)
• sendAudio — музыка
• sendVideoNote — кружок-видео
• sendAnimation — gif/анимация
• sendSticker — стикер
• sendMediaGroup — альбом из нескольких медиа

Три способа передать файл

1. Загрузить через multipart

curl -X POST https://api.telefon.chat/bot<TOKEN>/sendPhoto \
  -F chat_id=12345 \
  -F photo=@./cat.jpg \
  -F caption='Котик'

Лимит размера — 50 МБ на файл.

2. Передать URL

Бот может передать URL внешней картинки:

{
  "chat_id": 12345,
  "photo": "https://example.com/image.jpg",
  "caption": "С внешнего сервера"
}

Сервер скачает и закеширует.

3. Использовать file_id

После любой отправки в ответе приходит file_id. Используйте его повторно:

{
  "chat_id": 67890,
  "photo": "AgACAgIAAxkB..."
}

Это бесплатно и быстро — файл не передаётся повторно. См. file_id.

Подпись (caption)

Все методы кроме sendVoice/sendVideoNote принимают caption (до 1024 символов) с поддержкой parse_mode.

Альбомы (sendMediaGroup)

Несколько медиа одним сообщением (2-10 элементов):

{
  "chat_id": 12345,
  "media": [
    {"type": "photo", "media": "https://example.com/1.jpg", "caption": "Первое"},
    {"type": "photo", "media": "https://example.com/2.jpg"},
    {"type": "video", "media": "https://example.com/clip.mp4"}
  ]
}

Ограничения

Тип	Макс. размер
Photo	10 МБ
Video / Animation	50 МБ
Document / Audio	50 МБ
Voice / VideoNote	50 МБ
Sticker	512 КБ

Скачивание файлов

Чтобы получить URL файла по file_id:

GET https://api.telefon.chat/bot<TOKEN>/getFile?file_id=<ID>

Затем:

GET https://api.telefon.chat/file/bot<TOKEN>/<file_path>

См. подробнее: file_id.