Отправить сообщение

POST/messages

Отправляет сообщение в чат

Прикрепление медиа

Медиафайлы прикрепляются к сообщениям поэтапно:

Получите URL для загрузки медиафайлов
Загрузите бинарные данные соответствующего формата по полученному URL
После успешной загрузки получите JSON-объект в ответе. Используйте этот объект для создания вложения. Структура вложения:
- type: тип медиа (например, "video")
- payload: JSON-объект, который вы получили

Пример для видео:

Получите URL для загрузки

BASH

Скопировать

curl -X POST 'https://botapi.max.ru/uploads?access_token=%access_token%&type=video'

Ответ:

JSON

Скопировать

{
    "url": "https://vu.mycdn.me/upload.do…"
}

Загрузите видео по URL

BASH

Скопировать

curl -i -X POST -H "Content-Type: multipart/form-data" -F "data=@movie.mp4" "https://vu.mycdn.me/upload.do…"

Ответ:

JSON

Скопировать

{
    "token": "_3Rarhcf1PtlMXy8jpgie8Ai_KARnVFYNQTtmIRWNh4"
}

Отправьте сообщение с вложением

JSON

Скопировать

{
    "text": "Message with video",
    "attachments": [
        {
            "type": "video",
            "payload": {
                "token": "_3Rarhcf1PtlMXy8jpgie8Ai_KARnVFYNQTtmIRWNh4"
            }
        }
    ]
}

Авторизация

access_token
apiKey optional

Токен присваивается боту при регистрации в MAX через @MasterBot. Это уникальный идентификатор, с помощью которого бот взаимодействует с MAX Bot API: токен передаётся в качестве параметра access_token в HTTP-запросе

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

Параметры

user_id
integer <int64> optional

Если вы хотите отправить сообщение пользователю, укажите его ID

chat_id
integer <int64> optional

Если сообщение отправляется в чат, укажите его ID

disable_link_preview
boolean optional

Если false, сервер не будет генерировать превью для ссылок в тексте сообщения

Тело запроса

text
string Nullable

до 4000 символов

Новый текст сообщения

attachments
AttachmentRequest[] Nullable

Вложения сообщения. Если пусто, все вложения будут удалены

link
object NewMessageLink Nullable

Ссылка на сообщение

notify
boolean optional

По умолчанию: true

Если false, участники чата не будут уведомлены (по умолчанию true)

format
enum TextFormat Nullable optional

Enum: "markdown" "html"

Если установлен, текст сообщения будет форматрован данным способом. Для подробной информации загляните в раздел Форматирование

Результат

message
object Message

Сообщение в чате