Перейти к содержанию

SendInteractiveButtonsReply#

Метод предназначен для отправки сообщения с кнопками в личные чаты. Метод отправляет кнопки, которые возвращают текст в чат.

Бета-версия

Функциональность находится в режиме бета-версии. Функции могут быть изменены, а также могут работать нестабильно.

Запрос#

Для отправки требуется выполнить запрос по адресу:

POST 
{{apiUrl}}/waInstance{{idInstance}}/sendInteractiveButtonsReply/{{apiTokenInstance}}

Для получения параметров запроса apiUrl, idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Особенности при работе с кнопками#

  • в названии кнопки может быть не более 25 символов;
  • может быть не более 3 кнопок в одном сообщении;
  • кнопку можно нажать только 1 раз.

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

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата
header string Нет Заголовок сообщения
body string Да Текст сообщения. Поддерживаются символы emoji 😃
footer string Нет Подвал сообщения. Удобен для визуального выделения текста, который относится к кнопкам
buttons array Да Кнопки сообщения

Поля массива buttons

Параметр Тип Обязательный Описание
buttonId string Да Идентификатор кнопки
buttonText string Да Текст на кнопке

Пример тела запроса#

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

{
    "chatId": "79876543210@c.us",
    "header": "Header",
    "body": "Body",
    "footer": "Footer",
    "buttons": [
        {
            "buttonId": "1",
            "buttonText": "First Button"
        },
        {
            "buttonId": "2",
            "buttonText": "Second Button"
        },
        {
            "buttonId": "3",
            "buttonText": "Third Button"
        }
    ]
}

Ответ#

Поля ответа#

Поле Тип Описание
idMessage string Идентификатор отправленного сообщения

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

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Пример отображения у получателя#

alt text

Ошибки SendInteractiveButtonsReply#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Пример кода#

curl --location --request POST '{{apiUrl}}/waInstance{{idInstance}}/sendInteractiveButtonsReply/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "79581004388@c.us",
    "header": "Header",
    "body": "Body",
    "footer": "Footer",
    "buttons": [
        {
            "buttonId": "1",
            "buttonText": "First Button"
        },
        {
            "buttonId": "2",
            "buttonText": "Second Button"
        },
        {
            "buttonId": "3",
            "buttonText": "Third Button"
        }
    ]
}'