Отправить Кнопки Ответа
Отправка кнопок ответа в существующий чат (только с открытым диалоговым окном). Нужен только один параметр адресата - chatId, phone или bsuid. В BSUID-centric режиме chatId может быть [email protected], bsuid@lid, [email protected] или username@username. Поле phone принимает телефон или BSUID; bsuid можно передать отдельным полем.
JWT tokentoken<token>- body
body*stringОсновной текст сообщения
header?|||Optional header: text, document, video, or image object. Each variant requires type plus the matching media/text field.
footer?stringНижний колонтитул будет размещен под текстом сообщения.
sections*array<>До 3-х разделов включительно.
Каждый раздел представляет собой объект с полями:
type - всегда "reply" Обязателен
reply – объекты кнопки ответа Обязателен
Каждый ответ кнопки представляет собой объект с полями:
id - уникальный идентификатор кнопки, до 200 символов. Обязателен
title — Название кнопки, до 20 символов. Обязателен
Пример:
"sections": [{"type": "reply","reply": {"id ": "1","title": "1 Button's Title"}},{"type": "reply", "reply": {"id": "2", "title": "2 Button's Title"}}]
quotedMsgId?stringИдентификатор цитируемого сообщения (Cloud API)
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/sendButton' \ -H 'Content-Type: application/json' \ -d '{ "body": "Please choose option", "header": { "type": "text", "text": "Support" }, "sections": [ { "type": "reply", "reply": { "id": "yes", "title": "Yes" } }, { "type": "reply", "reply": { "id": "no", "title": "No" } } ], "phone": "12020721369"}'{ "sent": true, "id": "gBGGeRhGZTEfAgkJCh2wAz4ZH-8", "message": "Sent to [email protected]", "description": "Message has been sent to the provider"}