# Telegram bot for administrators

This feature allows administrators to receive **notifications about changes in request statuses directly in Telegram**, without the need to constantly be in the admin panel.

### Where the setting is located

Admin panel → **Settings** → **General settings** → **Bot for administrators**

### Creating a Telegram bot

To enable notifications, you need to create your own Telegram bot.

1. Open Telegram and go to the bot **@BotFather**
2. Execute the command `/newbot`
3. Specify the bot's name and username
4. After creation you will receive:
   * **a link to the bot** (for example: `t.me/LaraScriptTest_bot`)
   * **token to access the HTTP API** (bot token)

<figure><img src="https://2918865942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2FwoBaLGC9wPJD3qzhGmPv%2Fimage.png?alt=media&#x26;token=68b92340-d836-4286-97b2-5fda21d0e798" alt="" width="563"><figcaption></figcaption></figure>

### Filling in settings in the admin panel

In the section **Telegram bot setup for administrators** two fields are available:

#### Link to the Telegram bot

Paste the link to the created bot **must include the protocol `https://`**\
**Example:**\
`https://t.me/LaraScriptTest_bot`

#### Telegram bot token

Paste the token obtained from @BotFather (field *token to access the HTTP API*).

After filling in both fields, save the settings.

> ⚠️ Note: these settings are performed **once for each user** and apply not to the entire admin panel, but to a specific user.

### Connecting the Telegram bot by the administrator

After saving the global settings, the administrator can enable Telegram notifications for their account.

#### Path:

**Profile** → **Account settings** → **Notification settings**

In this section the administrator can:

* select **request statuses**, for which they want to receive notifications;
* obtain **a personal link to the Telegram bot**, generated specifically for this user.

The link is **unique for each administrator** and contains a special parameter by which the system identifies the user.

To activate notifications you need to:

1. Follow the personal link
2. Start the bot in Telegram (the **Start**)

After that the bot will confirm successful connection, and the administrator will begin to receive notifications.

### How notifications work

* Each administrator receives **only those notifications**, which they selected in the settings.
* One Telegram bot can be used **by one administrator**.
* Each user connects to the bot via **their own unique link**.

### Why this is useful

* 🔔 instant notifications about request status changes
* 📱 process control without constantly logging into the admin panel
* 👥 convenient for teams where multiple administrators work simultaneously
* ⚡ faster response to requests and unusual situations
