# 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>  
```


---

# 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://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/administration/kanaly-opoveshenii/telegram.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.