Кнопки
Компонент Кнопки отправляет пользователю текст с прикрепленным кнопками.
- Функции →
- Настройка компонента →
- Настройки для Телеграм →
- Настройки для Max →
- Настройки для ТамТам →
- Максимальное количество кнопок →
- Максимальное количество символов в кнопках →
- Максимальная длина текста →
- Использование ссылок →
Внешний вид кнопок
Функции
1. Переход на экраны.
2. Переход на внешний URL.
3. Отправка GET и POST запроса.
4. Запись текста кнопки или другого значения в переменную.
5. В Телеграм, ВК и Одноклассниках поддерживается ответ на сообщение с ID →
Настройка компонента
1. Создайте экран и добавьте на него компонент Кнопки.
2. Заполните поле с текстом — этот текст будет над кнопками.
3. Нажмите на кнопку Добавить кнопку.
4. В поле Текст на кнопке впишите текст кнопки.
5. Настройте переход по кнопке, выбрав из выпадающего списка нужный экран.
6. Для перехода по ссылке отметьте Внешний URL. Разместите ссылку для перехода на внешний ресурс. Переход на внешний URL поддерживают Telegram, Viber, ВКонтакте и Одноклассники.
Кнопка, которая переводит на внешний url не записывает в переменную ни текст кнопки ни другое значение
Для корректного сохранения бота проследите за тем, чтобы во всех кнопках, в которых нет перехода на внешний URL, были настроены экраны для перехода по кнопке.
7. Для перехода в веб-приложение в боте, отметьте Открыть Telegram Web App и разместите ссылку для перехода в ваше приложение.
8. Отметьте Возможность отправлять запрос для отправки запроса через кнопку. Добавьте необходимые параметры запроса в раскрывшихся настройках.
9. Если отметить Не выполнять answerCallbackQuery для Telegram, то пользователи смогут самостоятельно отвечать на нажатия инлайн-кнопок через нативный запрос Telegram.
10. Если заполнить Имя переменной, то текст кнопки запишется в эту переменную.
После этого можно добавить Значение переменной — вместо текста кнопки в переменную запишется заданное вами значение.
Если вы настроите как в примере на скриншоте, то в переменную button запишется текст с кнопки.
Вы можете записать новое Значение переменной, тогда это значение запишется вместо текста с кнопки.
В кнопках можно записывать как обычные, так и вложенные переменные.
Вложенные переменные в разделе Пользователи отображаются так:
Записываются вложенные переменные в кнопках следующим образом:
11. «Зафиксировать переменные в шаблонах» закрепит переменные и данные запроса за конкретной кнопкой в момент отправки переменных.
Если вы включите это свойство, то когда пользователь получит кнопки, переменные, которые были переданы вместе с кнопками, будут автоматически подставлены в компонент, даже если данные были переданы до того, как пользователь получил кнопки.
Если свойство отключено, то данные из переменных будут вставляться в компонент только в тот момент, когда пользователь бота нажмёт на кнопку, а не в момент отправки компонента. Другими словами, информация будет обновляться только тогда, когда пользователь кликает по кнопке, а не когда вы отправляете всю форму или компонент целиком.
Это свойство настраивается для каждой кнопки по отдельности.
12. Для добавления еще одной кнопки нажмите Добавить кнопку.
13. Для добавления кнопки в один ряд нужно нажать Добавить кнопку в этот ряд.
Настройки для Телеграм
Защитить контент — если включить чек-бокс, то пользователь бота не сможет скопировать и переслать информацию с кнопок.
Уникальный идентификатор эффекта сообщения — вместе с кнопками придёт выбранный вами анимированный эффект. Этот эффект можно выбрать из выпадающего списка или прописать вручную в виде числового кода.
Чтобы кнопки пришли в тихом режиме, активируйте чек-бокс «Отправить без звука в Telegram».
При активном чекбоксе «Включить предпросмотр ссылок» появляется возможность выбрать вид превью в Telegram, если вы отправляете ссылку.
Вы можете выбрать маленькое или большое превью из списка, а также при необходимости расположить его над текстом сообщения.
Авторазделение сообщений — если сообщение перед кнопками содержит теги, а в самом сообщении количество символов превышает ограничение Телеграм или длина сообщения заранее неизвестна, теги могут потеряться при автоматическом разбиении платформой. При включенном чек-боксе «Авторазделение сообщений», форматирование сохранится при любой длине текста.
Для корректной работы открывающий тег должен находиться на отдельной строке в начале, текст сообщения начинаться с новой строки, а закрывающий тег — на отдельной строке после последнего предложения.
Настройки для Max
Тип кнопки для Max задаётся отдельно в настройках каждой кнопки. Какой бы тип и цвет кнопки вы не выбрали, в Максе она будет отображаться всегда одним и тем же цветом.

Настройки для ТамТам
Цвет и Тип кнопки для Там Там задаётся отдельно в настройках каждой кнопки.
Для обычной текстовой кнопки и кнопки с запросом доступны три цвета — серый, синий, красный.
Для остальных типов — переход на внешний URL, Поделиться контактом и местоположением изменение цвета не поддерживается. Это означает что при выборе этих типов, в ТамТам кнопка будет приходить серой.
Максимальное количество кнопок
Telegram — более 100 кнопок.
Max — более 100 кнопок.
ТамТам — более 100 кнопок.
Фейсбук* — 3 кнопки.
Инстаграм* — 3 кнопки.
Viber — 24 кнопки.
ВКонтакте — 6 кнопок.
Одноклассники — 100 кнопок.
Максимальное количество символов в кнопках
Telegram допускает 35 знаков на кнопке, включая пробелы. Если их больше, то Telegram посреди текста вырезает кусок текста и вставляет троеточие.
Telegram допускает 35 знаков на кнопке, включая пробелы. Если их больше, то Telegram посреди текста вырезает кусок текста и вставляет троеточие.
Max и ТамТам обрезает текст после 68 символов и вставляет троеточие.
Фейсбук* обрезает текст после 23 символа и вставляет троеточие.
Viber позволяет добавить много знаков в кнопки. Нужно учитывать, что большой текст переносится на новую строку, и часть текста может быть не видна, а часть передвинуться на соседнюю кнопку.
ВКонтакте допускает до 40 символов с пробелами, если символов больше, то кнопки не отправляются.
В Одноклассниках может быть 42 знака, остальные платформа обрежет и вставит троеточие.
Максимальная длина текста
Telegram, Одноклассники, ВКонтакте и WhatsApp поддерживают 4096 символов латиницей и кириллицей независимо от количества кнопок и длинны текста в них.
Max и ТамТам поддерживает 3990 символов кириллицей или латиницей перед кнопками. Если текст будет больше, то он придет несколькими сообщениями.
Viber поддерживает 7000 символов на латинице и максимум 5700 на кириллице. Если текст написан латиницей, то не зависит от количества кнопок и длины текста в них. Если текст написан кириллицей, то каждая кнопка «съедает» 21-24 символа от текста по умолчанию + количество символов в тексте кнопки. Чем больше кнопок, тем меньше текста можно прислать.
Фейсбук* принимает 640 символов на латинице или кириллице независимо от количества кнопок и длины текста в них. Если больше — сообщение не приходит (ограничение Facebook*).
WhatsApp принимает не более 4096 символов, в них входит: сам текст + фраза «Варианты ответов:» с переносами строк (съедает 19 символов) + сами кнопки (каждая кнопка из 1 символа съедает 5 символов — перенос строки, «1. », текст самой кнопки). Чем больше кнопок, тем меньше текста можно прислать.
Использование ссылок
Переход на внешний URL в компоненте Кнопки работает в следующих платформах — Telegram, Viber, Max, ТамТам, ВКонтакте, Одноклассники.
Настройки выполнения компонентов
Выключить компонент — при активном чекбоксе компонент не будет выполняться, как если бы его не было в сценарии. Чтобы компонент снова заработал, достаточно снять чекбокс.
Если платформа недоступна, выполнить следующий компонент — бот пропустит выполнение компонента, перейдя к следующему, если выбранная платформа не будет доступна.
*Продукты Meta признаны экстремистскими и запрещены в РФ.