---
description: "How to link Telegram for notifications"
---

# How to link Telegram

To receive notifications in Telegram, link Telegram to your profile. After linking, you can choose Telegram as a delivery channel for any notification type.

## When it is useful

- You want notifications on your phone via Telegram.
- You need alerts when you are not in the app.
- You work from mobile devices.

## What to know

- A **Telegram bot** must be configured by an administrator.
- A **deep link** opens Telegram to complete linking.
- The system stores your Telegram chat information for sending notifications.

## Before you start

- The Telegram bot is configured by an administrator.
- You can open Telegram on your device.
- You are logged in.

## Steps

### 1. Open notification settings

Go to **Profile** → **Notifications** → **Channels** tab.

### 2. Find the Telegram section

Scroll to **Telegram** in the channel list.

### 3. Click connect

Click **Log in with Telegram** next to Telegram.

The system generates an authorization token and opens a deep link to the Telegram bot.

### 4. Open the link in Telegram

Follow the deep link (new tab or Telegram app).

### 5. Confirm linking in Telegram

The bot saves your chat and links the channel. You may get a confirmation from the bot.

### 6. Return to the app

Go back and check the channel status.

### 7. Check status

Status should change to **Connected**.

If it does not update, click **Check status** or refresh the page.

## Result

After a successful link you can:

- Choose Telegram as a delivery channel for any notification type
- Receive Telegram notifications when you are not in the app
- Run a test with **Test**

## Verification

1. Click **Test** next to Telegram.
2. You should receive a test notification in Telegram.
3. If nothing arrives, check bot configuration or try unlinking and linking again.

## Troubleshooting

### Token is not generated

**Issue:** **Log in with Telegram** fails or shows “Could not generate token”.

**What to do:**
- Confirm the Telegram bot is configured by an administrator.
- Refresh the page and try again.
- Ask your administrator to verify the channel configuration.

### Status does not update

**Issue:** After the deep link, status does not show **Connected**.

**What to do:**
- Click **Check status** or refresh the page.
- Make sure you followed the deep link in Telegram.
- Check messages from the bot to confirm the chat was saved.

### Notifications do not arrive

**Issue:** After linking, notifications do not arrive in Telegram.

**What to do:**
- Confirm Telegram is selected as a channel for that notification type.
- Run **Test**.
- Confirm the Telegram channel is configured on the bot by an administrator.
- Try unlink and link again.

## Unlink

1. Open settings → **Channels** tab.
2. Find **Telegram**.
3. Click **Disconnect**.
4. The channel is unlinked; you may still see it in settings until you refresh selections.
5. To link again, repeat the steps above.

## Related guides

- [How to configure a notification for an event type](configure-notification-type.md)
- [How to test a channel](test-notification-channel.md)
- [How to link Viber](connect-viber-channel.md)
