inlineButtons
inlineButtons
— инлайн-кнопки, отображаются внутри диалога в виде реплик чат-бота. При клике на инлайн-кнопку могут передаваться данные callback_data
или URL
.
предупреждение
Список каналов, которые поддерживают инлайн-кнопки
Синтаксис
- Название каждой кнопки и соответствующие ей
callback_data
илиURL
добавляются в фигурных скобках{}
после тега:text
— название кнопки,url
— ссылка на ресурс,callback_data
— данные для функции обратного вызова.
к сведению
Свойство text
является обязательным для объектов, передаваемых в теге inlineButtons
.
inlineButtons: {
text: "Название кнопки", // Обязательное свойство
url: "Ссылка на ресурс"
}
inlineButtons: {
text: "Подписаться на обновления", // Обязательное свойство
callback_data: "Подписаться"
}
Ограничения каналов
-
- Максимальная длина текста кнопки — 15 символов. Текст кнопки, выходящий за ограничение, переносится на следующую строку.
- Если размер данных в
callback_data
превышает 64 байта, то данные обрезаются. - На каждый набор инлайн-кнопок обязательно должно быть отправлено хотя бы одно текстовое сообщение.
-
- Максимальн ое количество рядов кнопок — 7.
-
- Кнопки с текстом и со ссылками нельзя использовать в одном стейте.
- Максимальное количество кнопок в сообщении — 2.
- Максимальная длина текста кнопки — 20 символов.
- В сообщении может быть только одна кнопка со ссылкой на сайт.
- В сообщении может быть только одна кнопка с номером телефона.
- Кнопки, которые добавляются в первое сообщение бота в рассылке, необходимо регистрировать заранее. Другие кнопки регистрировать не нужно.
Примеры использования
предупреждение
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"}