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

inlineButtons

inlineButtons — инлайн-кнопки, отображаются внутри диалога в виде реплик чат-бота. При клике на инлайн-кнопку могут передаваться данные callback_data или URL.

предупреждение
Список каналов, которые поддерживают инлайн-кнопки

Синтаксис

  • Название каждой кнопки и соответствующие ей callback_data или URL добавляются в фигурных скобках {} после тега:
    • text — название кнопки,
    • url — ссылка на ресурс,
    • callback_data — данные для функции обратного вызова.
к сведению

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

inlineButtons: {
text: "Название кнопки", // Обязательное свойство
url: "Ссылка на ресурс"
}
inlineButtons: {
text: "Подписаться на обновления", // Обязательное свойство
callback_data: "Подписаться"
}

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

  1. Telegram:

    • Максимальная длина текста кнопки — 15 символов. Текст кнопки, выходящий за ограничение, переносится на следующую строку.
    • Если размер данных в callback_data превышает 64 байта, то данные обрезаются.
    • На каждый набор инлайн-кнопок обязательно должно быть отправлено хотя бы одно текстовое сообщение.
  2. Viber:

    • Максимальное количество рядов кнопок — 7.
  3. i-Digital: WhatsApp:

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

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

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

Telegram

state: inlineButtons
q!: Инструкция
a: Ознакомьтесь с инструкцией на нашем сайте.
inlineButtons:
{text:"Перейти на сайт", url:"https://example.com"}

i-Digital: WhatsApp

Шаблон

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

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

Шаблон кнопки со ссылкой
Текст сообщенияНазвание кнопкиURL
Свяжитесь с нами.Перейти на сайтhttps://example.com
Шаблон кнопки для звонка
Текст сообщенияНазвание кнопкиНомер телефона
Свяжитесь с нами.Позвонить+7 (890-12) 3-45-67
подсказка
Для получения формы шаблона обратитесь к своему аккаунт-менеджеру.

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

 state: inline
q!: Инструкция
a: Ознакомьтесь с инструкцией на нашем сайте.
inlineButtons:
{text:"Перейти на сайт", url:"https://example.com"}