Шаблонные кнопки

Шаблонные кнопки — это предустановленные наборы кнопок, которые можно многократно использовать в различных роботах и бизнес-процессах. В отличие от инлайн-кнопок, которые описываются JSON-строкой в каждом роботе, шаблоны создаются один раз и применяются по имени.

Назначение

• Стандартизировать наборы кнопок для типовых сценариев (подтверждение, оценка, выбор)
• Упростить настройку роботов: вместо JSON-описания указывается имя шаблона
• Централизованно управлять кнопками — изменение шаблона отражается во всех роботах, где он используется

Отличие от инлайн-кнопок

Характеристика	Инлайн-кнопки	Шаблонные кнопки
Описание	JSON в параметрах робота	Шаблон в интерфейсе Олчат
Переиспользование	Копировать JSON в каждый робот	Указать имя шаблона
Редактирование	В каждом роботе отдельно	Один раз в интерфейсе Олчат
Гибкость	Полная (любой JSON)	Ограничена шаблоном

Создание шаблона кнопок

Шаг 1. Откройте шаблоны

Перейдите в приложение Олчат, откройте раздел Шаблоны сообщений. Шаблоны кнопок создаются как часть шаблонов сообщений.

Шаг 2. Создайте шаблон

Нажмите Создать шаблон. Укажите название шаблона и добавьте кнопки:

• Текст кнопки — надпись, которую видит получатель
• Тип действия — callback (отправка данных) или URL (ссылка)
• Значение — callback_data или URL-адрес

Шаг 3. Настройте расположение

Распределите кнопки по строкам. Кнопки в одной строке отображаются рядом, каждая строка — на новой линии.

Использование в роботах

При настройке робота с кнопками выберите способ задания кнопок — Из шаблона. Укажите имя созданного шаблона.

Обработка нажатий

Обработка нажатий шаблонных кнопок выполняется точно так же, как для инлайн-кнопок:

1. После робота с шаблонными кнопками добавьте Ожидание сообщения
2. Выберите тип совпадения Нажатие кнопки
3. Укажите паттерн — значение callback_data из шаблона

Подробнее: Сообщение с кнопками.

Примеры шаблонов

Подтверждение / Отмена

[Подтвердить] → callback: confirm
[Отменить]    → callback: cancel

Оценка качества

[5 - Отлично] → callback: rate_5
[4 - Хорошо]  → callback: rate_4
[3 - Средне]  → callback: rate_3
[2 - Плохо]   → callback: rate_2
[1 - Ужасно]  → callback: rate_1

Выбор времени

[Утро (9:00-12:00)]  → callback: time_morning
[День (12:00-17:00)] → callback: time_afternoon
[Вечер (17:00-21:00)] → callback: time_evening

Примечания и рекомендации

Совет

Создайте стандартные шаблоны для часто используемых сценариев: «Да/Нет», «Подтвердить/Отменить», «Оценка 1-5». Это сэкономит время при настройке новых роботов.

Заметка

Изменение шаблона кнопок не влияет на уже отправленные сообщения — кнопки в них остаются прежними. Новый вид кнопок применяется только к будущим отправкам.

• Шаблоны кнопок привязаны к порталу Битрикс24 и доступны всем роботам на этом портале
• Callback-значения в шаблоне должны быть уникальными для корректной обработки нажатий