# Telegram Notification

Данный раздел позволяет связать систему с Telegram и определить, по каким событиям администратор будет получать уведомления в мессенджере. Это позволяет оперативно отслеживать изменения в системе и получать важную информацию без необходимости постоянно находиться в административной панели.

Настройки плагина разделены на несколько вкладок.

### 1. Вкладка «Главное»

Вкладка **«Главное»** содержит основные параметры подключения Telegram-бота к системе.

#### Доступный параметр

**Bot Token** — токен Telegram-бота, который используется для интеграции с системой и отправки уведомлений.

Токен выдается при создании нового бота в Telegram через официальный сервис **@BotFather**.

После создания бота BotFather отправляет сообщение, содержащее уникальный токен доступа. Этот токен необходимо скопировать и вставить в поле **Bot Token** в настройках плагина.

После сохранения токена система получает возможность взаимодействовать с ботом через API Telegram и использовать его для отправки уведомлений.

### 2. Дополнительная вкладка

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

Здесь доступны следующие элементы.

#### Персональная ссылка на бота

В данном разделе отображается поле **«Ссылка на бота»**.

Для каждого пользователя административной панели система автоматически формирует **уникальную персональную ссылку**. Эта ссылка используется для привязки конкретного пользователя к Telegram-боту.

Чтобы начать получать уведомления:

1. Скопируйте ссылку из поля **«Ссылка на бота»**.
2. Перейдите по полученной ссылке.

После перехода откроется чат с вашим Telegram-ботом. Необходимо нажать кнопку **Start**, чтобы активировать взаимодействие с ботом.

После этого бот будет связан именно с вашим аккаунтом в административной панели.

{% hint style="info" %}
Важно: для каждого пользователя админ-панели создаётся собственная уникальная ссылка, поэтому уведомления будут приходить только тем пользователям, которые активировали бота через свою персональную ссылку.
{% endhint %}

#### Настройка событий уведомлений

В этом разделе можно настроить события системы, по которым Telegram-бот будет отправлять уведомления.

Пользователь может выбрать нужные события из доступного списка уведомлений. Например, это могут быть:

* изменение статуса заявки
* создание новой заявки
* обновление информации по заявке
* другие системные события

Выбранные события определяют, какие именно уведомления будут приходить в Telegram.

Такая настройка позволяет гибко управлять уведомлениями и получать только те сообщения, которые действительно важны для работы.

### Завершение настройки

После заполнения всех необходимых полей и выбора нужных событий необходимо сохранить настройки.

После сохранения:

* плагин активирует интеграцию с Telegram
* система начинает отслеживать выбранные события
* бот автоматически отправляет уведомления при наступлении этих событий
* пользователь будет получать уведомления в Telegram после активации бота через персональную ссылку

Таким образом, плагин **Telegram Notification** позволяет оперативно получать системные уведомления прямо в Telegram, что значительно упрощает контроль за важными действиями и событиями в системе.
