Отправка сообщений в канал MAX

Обновлено: 16 октября 2026

Для отправки сообщений в канал MAX Bot используется метод api/v1/out-messages/max.

к сведению

MAX Метод поддерживает отправку сообщений в MAX как по номеру телефона, так и по идентификатору пользователя — maxId.

Отправка сообщений по номеру телефона возможна, если аккаунт получателя в MAX является публичным или в edna Pulse для него существует связка «номер телефона + maxId».

Вызов метода

Чтобы отправить сообщение в канал MAX Bot по методу api/v1/out-messages/max, отправьте POST-запрос на URL-адрес https://app.edna.ru/api/v1/out-messages/max.

Примеры запросов

Сообщение с текстом

{
    "outMessageId": "019f6112-710d-78ec-90d5-5e4716de480d",
    "from": "MAX_FOR_TEST",
    "to": {
        "value": "+79000000000",
        "type":"PHONE"
    },
    "content": {
        "type": "TEXT",
        "text": "Добрый день! Рады представить наш новый канал для коммуникаций - MAX."
    }
}

Сообщение с текстом и изображением

{
    "outMessageId": "210f6112-560d-60ec-90d5-5e4716de492j",
    "from": "MAX_FOR_TEST",
    "to": {
        "value":"123456789",
        "type":"MAX_ID"
    },
    "content": {
        "type": "IMAGE",
        "url": "https://avatarko.ru/img/kartinka/33/multfilm_lyagushka_32117.jpg",
        "text": "Привет! Смотри какая картинка!"
    }
}

Сообщение с текстом и документом

{
    "outMessageId": "019f6112-710d-78ec-90d5-5e4716de480d",
    "from": "MAX_FOR_TEST",
    "to": {
        "value": "+79000000000",
        "type":"PHONE"
    },
    "content": {
        "type": "DOCUMENT",
        "url": "https://smpp.org/SMPP_v3_4_Issue1_2.pdf",
        "text": "Привет! Смотри описание протокола в документе"
    }
}

Сообщение с текстом и видео

{
    "outMessageId": "210f6112-560d-60ec-90d5-5e4716de492j",
    "from": "MAX_FOR_TEST",
    "to": {
        "value":"123456789",
        "type":"MAX_ID"
    },
    "content": {
        "type": "VIDEO",
        "url": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
        "text": "Привет! Видел?"
    }
}

Параметры запроса

Параметр	Тип данных	Характер	Описание
outMessageId	string	Необязательный	Внутренний идентификатор исходящего сообщения. Генерируется внешней системой клиента или edna Pulse при отправке сообщения. Максимальная длина строки — 256 символов.
from	string	Обязательный	Название канала. Чтобы узнать название канала, используйте метод API для получения списка каналов — параметр subject. Получение списка каналов
to	object	Обязательный	Объект с информацией об адресе получателя.
to.value	string	Обязательный	Адрес получателя — идентификатор пользователя в мессенджере MAX или номер телефона. Чтобы узнать адрес получателя, используйте метод API для запроса данных получателей — параметр addresses.address. Запрос данных получателей
to.type	string	Обязательный	Тип идентификатора получателя. Возможные значения: - PHONE — номер телефона получателя; - MAX_ID — идентификатор пользователя в мессенджере MAX.
content	object	Обязательный	Объект с информацией о содержимом сообщения.
content.type	string	Обязательный	Тип содержимого сообщения. Возможные значения: - TEXT — текст; - IMAGE — изображение; - DOCUMENT — документ.
content.text	string	Обязательный, если content.type = TEXT	Текст сообщения. Максимальная длина — 4000 символов. Может содержать эмодзи.
content.url	string	Обязательный, если content.type = IMAGE, VIDEO или DOCUMENT	Общедоступный URL-адрес вложения — изображения, видео или документа. Максимальная длина — 4096 символов на стороне edna Pulse.

Формат ответа

{
    "outMessageId": "string",
    "maxId": "string"
}

Пример ответа

Пример ответа, если при отправке сообщения в качестве адреса был указан maxId:

{
    "outMessageId": "210f6112-560d-60ec-90d5-5e4716de492j",
    "maxId": "123456789"
}

Пример ответа, если при отправке сообщения в качестве адреса был указан номер телефона:

{
    "outMessageId": "019f6112-710d-78ec-90d5-5e4716de480d",
    "phone": "+79000000000"
}

Параметры ответа

Параметр	Тип данных	Описание
outMessageId	string	Внутренний идентификатор исходящего сообщения. Был сгенерирован внешней системой клиента или edna Pulse при отправке сообщения.
maxId	string	Адрес получателя — идентификатор пользователя в мессенджере MAX. В ответ возвращается тот идентификатор получателя, который был указан в качестве адреса при отправке сообщения.
phone	string	Адрес получателя — номер телефона. В ответ возвращается тот идентификатор получателя, который был указан в качестве адреса при отправке сообщения.