Перейти к основному содержимому

buttons

buttons — кнопки, осуществляют переходы между стейтами сценария.

Синтаксис

Название кнопки добавляется в кавычках после тега buttons.

  • По нажатию будет отправлен запрос с текстом, указанным внутри кнопки.
buttons:
"Это кнопка 1"
"Это кнопка 2"
  • По нажатию на кнопку может быть осуществлен переход в указанный стейт, если:
    • в левой части тега указана строка, определяющая текст внутри кнопки,
    • в правой части — строка, определяющая путь перехода при нажатии кнопки.
# По нажатию на кнопку будет осуществлен переход в стейт /RememberCity
buttons:
"Санкт-Петербург" -> ./RememberCity
"Москва" -> ./RememberCity
  • В кнопках можно использовать строковые подстановки:
buttons:
"Перейдите в раздел {{ $request.query }}" -> ./
buttons:
"Кнопка" -> {{$temp.match.targetState}}
  • В кнопках могут передаваться объекты:
buttons:
{ text: "Отправить местоположение", request_location: true, one_time_keyboard: false }
к сведению

Свойство text является обязательным для объектов, передаваемых в теге buttons.

Ограничения каналов

  1. Telegram и ВКонтакте:

    • Максимальная длина текста кнопки — 20 символов. Текст кнопки, выходящий за ограничение, переносится на следующую строку.
    • В канале Telegram на каждый набор кнопок обязательно должно быть отправлено хотя бы одно текстовое сообщение.
  2. Viber:

    • На одной строке можно разместить 1, 2, 3 или 6 кнопок.
  3. i-Digital: WhatsApp:

    • Кнопки с текстом и со ссылками нельзя использовать в одном стейте.
    • Максимальное количество кнопок в сообщении — 3.
    • Максимальная длина текста кнопки — 20 символов.
    • Кнопки, которые добавляются в первое сообщение бота в рассылке, необходимо регистрировать заранее. Другие кнопки регистрировать не нужно.

Управление количеством символов

Вы можете управлять количеством символов в строке кнопок для каналов ВКонтакте и Telegram из сценария. Для этого вызовите в стейте script:

script:
$response._buttonsRowLength = 30; // 30 символов в строке

Примеры использования

предупреждение
К одному ответу бота, указанному в теге a, нельзя одновременно добавить теги buttons и inlineButtons. Тем не менее можно добавить несколько ответов в один стейт и к каждому ответу добавить разные типы кнопок.

Telegram

  • Кнопки могут использоваться для запроса локации:
state: Buttons
a: Поделитесь вашим текущим местоположением.
buttons:
{ text: "Отправить местоположение", request_location: true, one_time_keyboard: false }

state: Location
event: telegramSendLocation
a: Локация получена
  • Кнопки могут использоваться для запроса номера телефона:
state: Order
a: Если все верно, отправьте свой номер телефона, и наш менеджер с вами свяжется.
buttons:
{text: "Отправить номер телефона", request_contact: true}
"Меню" -> /ChoosePizza

state: GetPhoneNumber
event: telegramSendContact
script:
$client.phone_number = $request.rawRequest.message.contact.phone_number;
a: Спасибо! Наш менеджер свяжется с вами по номеру телефона {{ $client.phone_number }}.

i-Digital: WhatsApp

Шаблон

Чтобы добавить кнопки в стартовое сообщение бота в рассылке для канала i-Digital: WhatsApp, необходимо зарегистрировать их в качестве шаблона в i-Digital.

Кнопки для других сообщений регистрировать не нужно. Также не нужно регистрировать кнопки в сценариях, предназначенных для обработки входящих обращений клиентов.

В шаблоне нужно указать текст сообщения, текст и содержание кнопки.

Шаблон с текстовыми кнопками

Текст сообщенияКнопка чата 1Кнопка чата 2
Автомобиль будет использоваться в личных целях?ДаНет
подсказка
Для получения формы шаблона обратитесь к своему аккаунт-менеджеру.

Пример сценария

В данном сценарии заранее были зарегистрированы кнопки. По нажатию на Да или Нет будут осуществлены переходы в /NormalButtons1 или /NormalButtons2.

state: Buttons
q!: buttons
a: Автомобиль будет использоваться в личных целях?
buttons:
"Да" -> /NormalButtons1
"Нет" -> /NormalButtons2

state: NormalButtons1
a: Перейдем к оформлению.

state: NormalButtons2
a: Тогда в каких целях будет использоваться автомобиль?