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: Тогда в каких целях будет использоваться автомобиль?