SendChatAction
SendChatAction - используйте этот метод, чтобы сообщить пользователю, что бот в данный moment выполняет действие на стороне сервера (например, печатает текст или загружает файл). Это позволяет сделать взаимодействие с ботом более отзывчивым и естественным.
Примечание
Действие (action) будет отображаться в интерфейсе Telegram пользователя в течение нескольких секунд или до тех пор, пока бот не отправит следующее сообщение в этот же чат.
| Параметр | Описание |
|---|---|
| chat_id | Уникальный идентификатор целевого чата или username целевого канала (в формате @channelusername) |
| action | Тип действия, которое «выполняет» бот. Подробнее о возможных значениях см. ниже. |
| message_thread_id | Уникальный идентификатор темы (топика) в форуме. Для чатов, где темы включены, действие будет отображаться в указанной теме. |
Поддерживаемые типы действий (action)
| Значение | Что отображается у пользователя |
|---|---|
| typing | «печатает...» |
| upload_photo | «отправляет фото...» |
| record_video | «записывает видео...» |
| upload_video | «отправляет видео...» |
| record_voice | «записывает голосовое сообщение...» |
| upload_voice | «отправляет голосовое...» |
| upload_document | «отправляет файл...» |
| choose_sticker | «выбирает стикер...» |
| find_location | «ищет местоположение...» |
| record_video_note | «записывает видео-сообщение...» |
| upload_video_note | «отправляет видео-сообщение...» |
Примечания
- Этот метод следует вызывать перед началом длительной операции (например, перед обработкой большого запроса или генерацией файла), чтобы пользователь видел индикатор активности бота.
- Если после вызова
sendChatActionбот не отправит сообщение в чат в течение некоторого времени, индикатор действия автоматически исчезнет.- Метод особенно полезен для ботов, которые могут обрабатывать запросы дольше 1–2 секунд.