inlineButtons
inlineButtons — inline-кнопки, отображаются внутри диалога в виде реплик чат-бота. При клике на inline-кнопку могут передаваться данные callback_data или URL.
Inline-кнопки поддерживаются только в каналах Telegram, Viber и i-Digital: WhatsApp.
Синтаксис
- Название каждой кнопки и соответствующие ей
callback_dataилиURLдобавляется в фигурных скобках{}после тега:text— название кнопки,url— ссылка на ресурс,callback_data— данные для функции обратного вызова.
inlineButtons:
{text:"Название кнопки", url:"Ссылка на ресурс"}inlineButtons:
{text:"Подписаться на обновления", callback_data: "Подписаться"}Ограничения каналов
-
- Максимальная длина текста кнопки – 15 символов. Текст кнопки, выходящий за ограничение, переносится на следующую строку.
- Если размер данных в
callback_dataпревышает 64 байта, то данные обрезаются.
-
- Максимальное количество рядов кнопок — 7.
-
- Кнопки с текстом и со ссылками нельзя использовать в одном стейте.
- Максимальное количество кнопок в сообщении – 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 123 45-67 |
Для получения формы шаблона обратитесь к своему аккаунт-менеджеру.
Пример сценария
state: inline
q!: Инструкция
a: Ознакомьтесь с инструкцией на нашем сайте.
inlineButtons:
{text:"Перейти на сайт", url:"https://example.com"}