Отправить Список сообщений
Отправка списка опций в существующий чат (только с открытым диалоговым окном). Нужен только один параметр адресата - chatId, phone или bsuid. В BSUID-centric режиме chatId может быть [email protected], bsuid@lid, [email protected] или username@username. Поле phone принимает телефон или BSUID; bsuid можно передать отдельным полем.
JWT tokentoken<token>- body
body*stringОсновной текст сообщения
header?stringТекст, который будет расположен над текстом сообщения
footer?stringТекст, который будет расположен под текстом сообщения
action*stringПодпись кнопки раскрытия списка
sections*array<>Массив с разделами доступных для выбора опций Не более 10.
Каждый раздел - это объект, содержащий следующие поля:
title - Заголовок раздела, не более 24 символов. Обязателен, если указано более 1 раздела
rows - доступные для выбора опции. Обязателен
Каждая опция - это объект, содержащий следующие поля:
id - Уникальный идентификатор, не более 200 символов. Обязателен
title - Заголовок опции, не более 24 символов. Обязателен
description - Описание опции, не более 72 символов
Пример:
[{"title":"Section 1","rows":[{"id":"1","title":"Option 1","description":"Description 1"}]},{"title":"Section 2","rows":[{"id":"2","title":"Option 2","description":"Description 2"}]}]
chatId?stringОбязателен, если не указаны phone и bsuid
ID чата из списка сообщений. Примеры: [email protected], RU.1504711984690866@lid, username@username или [email protected] (группа). Используется вместо параметра phone.
phone?stringОбязателен, если не указаны chatId и bsuid
Идентификатор получателя. Принимает номер телефона с кодом страны или BSUID, например RU.1504711984690866.
Для chatId используйте полные ID чатов: [email protected], bsuid@lid, username@username или [email protected].
bsuid?stringНеобязательная альтернатива phone/chatId
BSUID получателя без суффикса @lid. Пример: RU.1504711984690866.
Server response example
application/json- response
sent?booleanid?stringУникальный идентификатор сообщения
message?stringУведомление о статусе отправки сообщения
description?stringКомментарий к результату отправки
curl -X POST 'https://api.1msg.io/123/sendList' \ -H 'Content-Type: application/json' \ -d '{ "body": "Please choose option", "header": "Some options", "footer": "Thank you", "action": "List", "sections": [ { "title": "Section 1", "rows": [ { "id": "1", "title": "Option 1", "description": "Description 1" } ] } ], "phone": "12020721369"}'{ "sent": true, "id": "gBGGeRhGZTEfAgkJCh2wAz4ZH-8", "message": "Sent to [email protected]", "description": "Message has been sent to the provider"}