> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/administration/kanaly-opoveshenii/telegram.md).

# Telegram

**Настройка Telegram-бота для уведомлений**

**1. Создание бота через @BotFather**

1. Откройте Telegram, найдите **@BotFather** и запустите его.
2. Введите команду `/newbot` и следуйте инструкциям:
   * Укажите **имя бота** (например, `passoffice_bot`).
   * Получите **HTTP API-ключ** (сохраните его).

**2. Настройка бота в системе**

1. В разделе **«Конфигурирование» → «Каналы» → «Telegram»**:
   * Активируйте бота с помощью **бегунка**.
   * Введите:
     * **Название бота** (например, `passoffice_bot`).
     * **API-ключ** (полученный от @BotFather), для обновления API ключа:
       * Установите галочку **«Обновить API ключ»**
       * Введите **новый API ключ** в соответствующее поле и после этого нажмите **«Сохранить»**.
2. **Функции сообщений:**
   * Отправлять пин-код заявки в виде QR.
   * Отправлять QR-код пропуска.

**3. Подписка на уведомления**

1. **Для администраторов/операторов:**
   * В **«Настройках пользователя»** или **«Администрирование» → «Операторы»** нажмите **«Подписаться на Telegram-бота»**.
   * В Telegram найдите бота и отправьте `/start`.
2. **Отписка:**
   * Отправьте боту команду `/end` или нажмите **«Отписаться»** в настройках.

**4. Тестовая отправка сообщения**

* Нажмите **«Отправить тестовое сообщение»** → проверьте получение в Telegram.

***

#### **Настройка шаблонов сообщений**

Во вкладке **«Шаблоны»** можно:

1. **Выбирать получателей** (чек-боксы):
   * Администраторы, гости, операторы и др.
2. **Редактировать текст уведомлений** (поддерживаются теги форматирования):

**Доступные теги:**

```
<b>жирный</b>, <strong>жирный</strong>  
<i>курсив</i>, <em>курсив</em>  
<u>подчеркивание</u>, <ins>подчеркивание</ins>  
<s>зачеркивание</s>, <strike>зачеркивание</strike>  
<span class="tg-spoiler">спойлер</span>  
<a href="https://example.com">ссылка</a>  
<code>моноширинный код</code>  
<pre>блок кода</pre>  
<pre><code class="language-python">Python-код</code></pre>  
```