> 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="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FmOCEgSmeR8mNkK1Kj9EZ%2Fimage.png?alt=media&amp;token=41b6cb97-5050-4abb-a66d-77f3b9541671" alt=""><figcaption><p>Страница настройки клавиатуры</p></figcaption></figure>

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

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

<figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FBmljjJsh7h1H3Qo8DqTO%2Fimage.png?alt=media&amp;token=d181f00f-7530-4bbb-9c7b-c750bc91f533" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2Fpzsdm9gAToGsnTPxOYPY%2Fimage.png?alt=media&amp;token=8448572a-bf9b-4bf2-bba4-b2cfe9c2ebcc" alt=""><figcaption><p>Часть клавиш в ряду нее заполнена, соседние займут свободное место</p></figcaption></figure>

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

<figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FmbD7qtlfzIAqoUb8C6mC%2Fimage.png?alt=media&amp;token=fe258e88-f945-4512-95fa-d6f12285db5c" alt=""><figcaption></figcaption></figure>

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

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

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

  <figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2F0hhbQLZHnAxbSiVkscNU%2Fimage.png?alt=media&amp;token=d913eed2-0072-479a-ad83-acb2602564de" alt=""><figcaption></figcaption></figure>
* **Действие «Выбрать квиз»** — после выбора действия появится выпадающее меню квизов созданных в боте, после выбора квиза он будет подключен к кнопке и будет вызываться при ее нажатии

  <figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2Fj9vLrREQtFjkUdHP8gOv%2Fimage.png?alt=media&amp;token=289e998e-3be2-4345-9402-233fef289708" alt=""><figcaption></figcaption></figure>
* **Действие «Вызвать клавиатуру»** —после выбора действия появится выпадающее меню клавиатур созданных в боте, после выбора клавиатуры она будет подключен к кнопке и будет вызываться при ее нажатии
* ![](https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FI7KJhegIpsSVqBBlZgqn%2Fimage.png?alt=media\&token=e268c99d-5dbb-4201-b166-3b55f4afd7fa)&#x20;
* **Действие «CallBack param»** — позволяет вызвать плагин с параметрами, недокументированная опция, используется по согласованию с техподдержкой. Пример msg-r:1 вызовет плагин диалогов, через который с пользователем нажавшим кнопку можно будет общаться через Телеграм-группу подключенную к боту.&#x20;

  <figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FpK8SVXy4sEjwOcqVa4T5%2Fimage.png?alt=media&amp;token=d0918d85-2097-49c0-bbcd-21eee34a62e2" alt=""><figcaption></figcaption></figure>
* Если бот не подключен к группе, при нажатии кнопки в боте будет выведено сообщение&#x20;

  <figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FiPZYT0A0zrTDkyH3HHsa%2Fimage.png?alt=media&amp;token=ef1b188a-b1b0-4a35-9044-57971acc5144" alt=""><figcaption></figcaption></figure>
* **Действие «Запросить контакт»** — будет выведена кнопка  позволяющая поделиться с ботом телефоном на который зарегистрован аккаунт, достаточно запросить его один раз. Будет отображаться в результатах квизов.<br>

  <figure><img src="https://3119169064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKlowKCchylGIyYRzwPcW%2Fuploads%2FOkgx1oDdeO5YDOqPv4qL%2Fimage.png?alt=media&amp;token=a3cc50d9-cb90-48b5-bf53-a68b54167b01" alt=""><figcaption></figcaption></figure>
* **Действие «Запросить локацию»** — будет выведена кнопка  позволяющая поделиться с ботом текущей геопозицией. Будет отображаться в результатах квизов.
* **Действие «В главное меню»** — выведет кнопку вызывающую главное меню, дополнительных настроек не требует

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

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

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

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