> For the complete documentation index, see [llms.txt](https://core4.gitbook.io/botpad/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://core4.gitbook.io/botpad/klaviatury-bota.md).

# Клавиатуры бота

<figure><img src="/files/5N1dIVN9WSFr8ga2TIHB" alt=""><figcaption><p>Страница настройки клавиатуры</p></figcaption></figure>

При создании или редактировании клавиатуры можно задать вывод сообщения с  изображением или медиафайлом, при переключении на клавиатуру, это дает возможность создавать простые «страницы» в боте для вывода информации или создания подраздела.

**Настройка размера клавиатуры**

<figure><img src="/files/E9leOXzAfEv2dZjkWzg0" alt=""><figcaption></figcaption></figure>

Размер клавиатуры определяется при помощи меню клавиатуры в котором кликом по ячейке можно задать количество рядов и количество столбцов в клавиатуре. Размер клавиатуры можно переопределить при редактировании (При уменьшении клавиши не вошедшие в новый размер будут сброшены).

{% hint style="success" %}
Если название клавиши в ряду не задано, она не будет создана, а соседние клавиши займут ее пространство
{% endhint %}

**Например набор клавиш типа:**\
\[Button-01]\[Button-02]\[Button-03]\
\[Button-11]\
\[Button-21]\[Button-22]

**В конструкторе будет выглядеть как:**

<figure><img src="/files/M5wltpmkfSYTaAb9Bo6o" alt=""><figcaption><p>Часть клавиш в ряду нее заполнена, соседние займут свободное место</p></figcaption></figure>

**А в бот будет выведено как:**

<figure><img src="/files/UkKPflU1VJEtie14LsPz" alt=""><figcaption></figcaption></figure>

**Настройка кнопок**

После того как размер клавиатуры определен, мы можем настроить действие кнопок, доступны следующие варианты:

* **Введено только название кнопки** — используется только при настройке клавиатуры, в рабочем режиме название кнопки продублируется в чат, но не будет обработано

  <figure><img src="/files/o0X0TgHLooAPtzQTg9cs" alt=""><figcaption></figcaption></figure>
* **Действие «Выбрать квиз»** — после выбора действия появится выпадающее меню квизов созданных в боте, после выбора квиза он будет подключен к кнопке и будет вызываться при ее нажатии

  <figure><img src="/files/606kDtagroHgzE2yTT9U" alt=""><figcaption></figcaption></figure>
* **Действие «Вызвать клавиатуру»** —после выбора действия появится выпадающее меню клавиатур созданных в боте, после выбора клавиатуры она будет подключен к кнопке и будет вызываться при ее нажатии
* ![](/files/nPAdmQvJmPecs8wlxelp)&#x20;
* **Действие «CallBack param»** — позволяет вызвать плагин с параметрами, недокументированная опция, используется по согласованию с техподдержкой. Пример msg-r:1 вызовет плагин диалогов, через который с пользователем нажавшим кнопку можно будет общаться через Телеграм-группу подключенную к боту.&#x20;

  <figure><img src="/files/3tFHQ6TwPBUZUDafE6a8" alt=""><figcaption></figcaption></figure>
* Если бот не подключен к группе, при нажатии кнопки в боте будет выведено сообщение&#x20;

  <figure><img src="/files/ndFQMukfgOdG5EVW0mNF" alt=""><figcaption></figcaption></figure>
* **Действие «Запросить контакт»** — будет выведена кнопка  позволяющая поделиться с ботом телефоном на который зарегистрован аккаунт, достаточно запросить его один раз. Будет отображаться в результатах квизов.<br>

  <figure><img src="/files/vX2rjUasZ9akFjtFJOhY" alt=""><figcaption></figcaption></figure>
* **Действие «Запросить локацию»** — будет выведена кнопка  позволяющая поделиться с ботом текущей геопозицией. Будет отображаться в результатах квизов.
* **Действие «В главное меню»** — выведет кнопку вызывающую главное меню, дополнительных настроек не требует

**Другие поля формы настройки клавиатуры:**

* **«Сообщение при появлении клавиатуры:»** — позволяет вывести сообщение при появлении клавиатуры
* **«Прикрепленный файл:»** — прикрепит к сообщению медиафайл. Если прикреплен, отметив чекбокс можно удалить
* **«Это основная клавиатура»** — делает клавиатурой по умолчанию. Клавиатура будет выводиться когда у бота не будет инструкций по клавиатуре

**Дополнительные параметры:**

* **«Я хочу очистить эту клавиатуру»** — сбрасывает все кнопки, но не удаляет ID клавиатуры, позволяет редактировать ее заново. *При удалении клавиатуры нарушатся ссылки из других клавиатур*
* **«Я хочу безвозвратно удалить эту клавиатуру»** —  полностью удаяет клавиатуру, ссылки на нее перестают работать