Telegram Bot HandbookОтправка, изменение и пересылка сообщений
На этой странице я собрал информацию об особенностях Телеграм-сообщений и связанных ограничениях ботов. Убедитесь, что ваш бот правильно работает даже в крайних случаях, которые здесь описаны.
Отправка сообщений
Бот может отправлять и получать сообщения, как и пользователи. Это могут быть просто текстовые сообщения, а могут быть сообщения с медиа: картинками, видео, файлами, опросами, голосовыми сообщениями, стикерами и так далее.
А ещё, в отличие от пользователей, бот может добавлять к своим сообщениям кнопки.
Как устроены альбомы
Альбом — это несколько сообщений-картинок или сообщений-файлов, которые приложения Телеграма отображают как одно сообщение.
Какие ограничения на файлы
В Телеграме можно делиться файлами до 4 ГБ, но ограничения в Bot API более жёсткие. Через Bot API бот может скачивать файлы до 20 МБ и отправлять файлы до 50 МБ. Эти лимиты повышаются, если вы используете локальный сервер Bot API: тогда бот может скачивать и отправлять файлы до 2 ГБ.
Как часто можно слать сообщения
Конечно, спамить не получится. Сам Телеграм называет такие примерные лимиты:
- не больше одного сообщения в секунду в один чат,
- не больше 30 сообщений в секунду во все чаты,
- не больше 20 сообщений в минуту в одну группу.
Если вы хотите сделать рассылку по всем пользователям, то вы не сможете отправить сообщения всем одновременно; придётся рассылать постепенно.
Учтите, что на более редкие действия, такие как изменение и удаление сообщений, ограничения строже. Для ботов с большим числом пользователей лимиты могут быть увеличены через поддержку.
Когда нельзя
Бот не может отправить сообщение заблокировавшему его пользователю; в группу или канал, где его нет или где админы отняли разрешение на отправку сообщений.
Премиум-пользователь может запретить отправку голосовых сообщений (в том числе кружочков).
Изменение сообщений
Когда бот изменяет сообщение, в сообщении не появляется надпись «Изменено», как в сообщениях пользователей.
Как изменять медиа
Изменяя сообщение, можно изменить не только его текст, но и медиа.
Картинку, видео или файл можно заменить на другую картинку, видео или файл (музыка тоже считается файлом).
В сообщения, отправленные без медиа, уже нельзя добавить медиа.
Пересылка сообщений
Если попробовать переслать музыку, то она переотправится без подписи «Переслано».
Нельзя пересылать сообщения из групп и каналов, в настройках которых включён запрет на сохранение контента (это настройка называется protected content).