Отправка действия в чат

POST/chats/{chatId}/actions

Позволяет отправлять в чат такие действия бота, как например: «набор текста» или «отправка фото»

Пример запроса:

BASH

Скопировать

curl -X POST "https://platform-api.max.ru/chats/{chatId}/actions" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "typing_on"
}'

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти в разделе платформы MAX для партнёров Чат-бот и мини-приложение → Настроить

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chatId
integer <int64>
\-?\d+

ID чата

Тело запроса

action
enum SenderAction

Enum: "typing_on" "sending_photo" "sending_video" "sending_audio" "sending_file" "mark_seen"

Действие, отправляемое участникам чата. Возможные значения:

"typing_on" — Бот набирает сообщение.
"sending_photo" — Бот отправляет фото.
"sending_video" — Бот отправляет видео.
"sending_audio" — Бот отправляет аудиофайл.
"sending_file" — Бот отправляет файл.
"mark_seen" — Бот помечает сообщения как прочитанные.

Результат

success
boolean

true, если запрос был успешным, false в противном случае

message
string optional

Объяснительное сообщение, если результат не был успешным