Сообщение с кнопками

Робот Сообщение с кнопками отправляет текстовое сообщение с интерактивными инлайн-кнопками. Клиент может нажать на кнопку для выбора ответа, перехода по ссылке или запуска действия. Нажатие кнопки можно обработать с помощью робота Ожидание сообщения.

Назначение

• Предложить клиенту варианты ответа в виде кнопок
• Создать интерактивное меню или навигацию
• Получить структурированный ответ от клиента
• Отправить кнопку со ссылкой для перехода на сайт

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую отправляется сообщение	Да
Тип идентификатора	Способ определения получателя	Да
ID чата / Username / Телефон	Идентификатор получателя	Да
Сообщение	Текст сообщения над кнопками	Да
Кнопки	Описание кнопок в формате JSON	Да
Публикация в ОЛ	Режим публикации в открытую линию	Нет
Записать в CRM карточку	Добавить запись в таймлайн CRM	Нет (по умолчанию: Да)

Формат кнопок

Кнопки описываются в формате JSON. Каждая кнопка имеет текст (надпись) и действие при нажатии.

Типы кнопок

Тип	Описание	Поле
Callback	Отправляет callback_data при нажатии	callback_data
URL	Открывает ссылку в браузере	url

Структура JSON

[
  [
    {"text": "Да, подтверждаю", "callback_data": "confirm"},
    {"text": "Нет, отменить", "callback_data": "cancel"}
  ],
  [
    {"text": "Перейти на сайт", "url": "https://example.com"}
  ]
]

Каждый вложенный массив — это строка кнопок. В примере выше: первая строка содержит две кнопки, вторая — одну.

Расположение кнопок

• Кнопки в одном вложенном массиве отображаются в одной строке
• Каждый вложенный массив — это новая строка кнопок
• Максимум 8 кнопок в одной строке (зависит от мессенджера)
• Рекомендуется не более 3 кнопок в строке для удобства

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота с кнопками из раздела Олчат.

Шаг 2. Введите текст сообщения

Напишите текст вопроса или информации, который будет отображён над кнопками.

Шаг 3. Опишите кнопки

В поле кнопок вставьте JSON-описание. Пример для подтверждения заказа:

[
  [
    {"text": "Подтвердить", "callback_data": "order_confirm"},
    {"text": "Отменить", "callback_data": "order_cancel"}
  ],
  [
    {"text": "Связаться с менеджером", "callback_data": "contact_manager"}
  ]
]

Шаг 4. Настройте обработку нажатий

После робота с кнопками добавьте робота Ожидание сообщения с типом совпадения Нажатие кнопки для обработки нажатия.

Обработка нажатий (callback)

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

1. Сообщение с кнопками — отправляет вопрос с вариантами
2. Ожидание ответа (тип: Нажатие кнопки) — ожидает callback
3. Условие — проверяет значение received_message (содержит callback_data нажатой кнопки)

Пример: если клиент нажал кнопку с callback_data: "confirm", то received_message будет содержать confirm.

Настройка в дизайнере бизнес-процессов

В дизайнере бизнес-процессов кнопки настраиваются аналогично. Используйте ветвление после действия ожидания для обработки различных нажатий.

Возвращаемые значения

Значение	Тип	Описание
is_sent	bool	Результат отправки: Y или N
chat_id	string	ID чата получателя
message_id	string	ID отправленного сообщения
error	string	Текст ошибки
error_code	string	Код ошибки

Примечания и рекомендации

Совет

Используйте осмысленные значения callback_data, чтобы было удобно обрабатывать их в условиях. Например, confirm_order, cancel_order, а не btn1, btn2.

Осторожно

URL-кнопки открывают ссылку в браузере и не генерируют callback. Для них нельзя настроить ожидание нажатия.

Заметка

Инлайн-кнопки отображаются прямо под сообщением и не исчезают после нажатия (в Telegram). Чтобы убрать кнопки, нужно отредактировать или удалить сообщение.

• Максимальная длина callback_data — 64 символа
• Максимальная длина текста кнопки зависит от мессенджера, рекомендуется до 30 символов
• Нажатие кнопки обрабатывается только роботом ожидания с типом Нажатие кнопки (callback)
• Кнопки доступны в Telegram и в MAX Bot; поддержка зависит от конкретного мессенджера