Skip to content

SendMessage.md

Latest commit

 

History

History
84 lines (69 loc) · 5.01 KB

SendMessage.md

File metadata and controls

84 lines (69 loc) · 5.01 KB

SendMessage

dev.max.ru/docs-api/methods/POST/messages

Метод предназначен для отправки текстового сообщения или медиафайла пользователю или в чат.

Запрос {#request}

Поля запроса {#request-parameters}

Поле Тип Обязательный Описание
user_id integer Да* ID пользователя-получателя
* обязателен, если не указан chat_id
chat_id integer Да* ID чата-получателя
* обязателен, если не указан user_id
disable_link_preview boolean Нет Если false, сервер не будет генерировать превью для ссылок в тексте сообщения
text string Нет Новый текст сообщения (до 4000 символов)
attachments array Нет Вложения сообщения. Если пусто, все вложения будут удалены
link object Нет Ссылка на другое сообщение
notify boolean Нет Отправлять ли пуш-уведомление пользователю (true/false)
format string Нет Формат разметки текста (HTML, Markdown)

Пример запроса {#request-example}

Синхронный запрос:

response = bot.messages.SendMessage(SendMessageReq(
    chat_id=123456,
    text="Hello, world!",
    notify=True
))

Асинхронный запрос:

response = await bot.messages.SendMessageAsync(SendMessageReq(
    chat_id=123456,
    text="Hello, world!",
    notify=True
))

Ответ {#response}

объект message

Поля ответа {#response-parameters}

Поле Тип Описание
sender object Пользователь, отправивший сообщение
recipient object Получатель сообщения. Может быть пользователем или чатом
timestamp integer Время создания сообщения в формате Unix-time
linked_message object Пересланное или ответное сообщение
body object Содержимое сообщения
stat object Статистика сообщения. Возвращается только для постов в каналах
url string Публичная ссылка на пост в канале. Отсутствует для диалогов и групповых чатов

Пример тела ответа {#response-example-body}

{
    "message": {
        "recipient": {
            "chat_id": 123456789,
            "chat_type": "dialog",
            "user_id": 111222333
        },
        "timestamp": 1773838491240,
        "body": {
            "mid": "mid.000000000782a4e0019d01035e6843dd",
            "seq": 116250279361922013,
            "text": "Hello world!"
        },
        "sender": {
            "user_id": 9876543210,
            "first_name": "John",
            "username": "id5047259512_1_bot",
            "is_bot": true,
            "last_activity_time": 1773838491258
        }
    }
}