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

SendListMessage#

Метод предназначен для отправки сообщения с кнопкой выбора из списка значений в личный или групповой чат. Сообщение будет добавлено в очередь на отправку. Проверка авторизации whatsapp-а на телефоне (т.е. наличие в связанных устройствах) не выполняется. Сообщение на отправку хранится 24 часа в очереди и будет отправлено сразу же после авторизации телефона. Скорость отправки сообщений из очереди регулирует параметр Интервал отправки сообщений.

Запрос#

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

POST https://api.green-api.com/waInstance{{idInstance}}/SendListMessage/{{apiTokenInstance}}

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

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

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата
message string Да Текст сообщения. Поддерживаются символы emoji 😃
title string Нет Заголовок сообщения.
footer string Нет Подвал сообщения. Удобен для визуального выделения текста, который относится к кнопкам
buttonText string Нет надпись на кнопке списка выбора
sections array Да значения списка выбора
quotedMessageId string Нет Идентификатор цитируемого сообщения,если указан то сообщение отправится с цитированием указанного сообщения чата
archiveChat boolean Нет Помещает в архив чат, в который отправлено сообщение. Принимает значания: true

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

Параметр Тип Описание
title string заголовок списка выбора
rows array значения списка выбора

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

Параметр Тип Описание
title string текст значения списка
rowId string идентификатор значения списка

Максимальная длина текстового сообщения составляет 4096 символов

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

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

{
    "chatId": "79001234567@c.us",
    "message": "Текст сообщения",
    "title": "заголовок",
    "footer": "подвал",
    "buttonText": "Список действий",
    "sections": [
        {
            "title": "Секция 1",
            "rows": [
                {
                    "title": "Вариант 1",
                    "rowId": "option1"
                },
                {
                    "title": "Вариант 2",
                    "rowId": "option2",
                    "description": "Пояснение"
                }
            ]
        },
        {
            "title": "Секция 2",
            "rows": [
                {
                    "title": "Опция 3",
                    "rowId": "option3"
                },
                {
                    "title": "Опция 4",
                    "rowId": "option4",
                    "description": "Пояснение"
                }
            ]
        }
    ]
}

Ответ#

Поля ответа#

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

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

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Ошибки SendMessage#

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

Пример curl#

curl --location --request POST 'https://api.green-api.com/waInstance{{idInstance}}/sendListMessage/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "79192533586@c.us",
    "message": "Текст сообщения",
    "buttonText": "Список действий",
    "title": "заголовок",
    "footer": "подвал",
    "sections": [
        {
            "title": "Секция 1",
            "rows": [
                {
                    "title": "Вариант 1",
                    "rowId": "option1"
                },
                {
                    "title": "Вариант 2",
                    "rowId": "option2",
                    "description": "Пояснение"
                }
            ]
        },
        {
            "title": "Секция 2",
            "rows": [
                {
                    "title": "Опция 3",
                    "rowId": "option3"
                },
                {
                    "title": "Опция 4",
                    "rowId": "option4",
                    "description": "Пояснение"
                }
            ]
        }
    ]
}'