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

<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 клавиатуры, позволяет редактировать ее заново. *При удалении клавиатуры нарушатся ссылки из других клавиатур*
* **«Я хочу безвозвратно удалить эту клавиатуру»** —  полностью удаяет клавиатуру, ссылки на нее перестают работать


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://core4.gitbook.io/botpad/klaviatury-bota.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
