> ## Documentation Index
> Fetch the complete documentation index at: https://faq.exode.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram-бот школы

> Как подключить собственного Telegram-бота школы, привязать Telegram учеников и автоматически приглашать их в канал и чат группы.

Школа подключает собственного Telegram-бота: он работает под вашим именем и с вашим токеном. Через бота ученики входят в школу по Telegram, получают личные приглашения в Telegram-канал и чат своей группы и служебные сообщения от школы.

## Что умеет бот

* Показывает кнопку **Войти через Telegram** на странице входа в публичную школу. В приватной школе кнопки нет; если снова сделать школу публичной, она вернётся.
* Привязывает Telegram-аккаунт ученика к его профилю.
* Присылает ученику персональные ссылки-приглашения в Telegram-канал и чат группы.
* Удаляет ученика из канала и чата, когда его исключают из группы.
* Присылает ученикам с привязанным Telegram служебные сообщения: о неудачном списании и прекращении подписки (только в коммерческой школе), код для восстановления пароля, данные для входа, если аккаунт создан автоматически. Напоминаний о курсах и вебинарах бот не присылает.

## Подключение бота

> [!NOTE]
>
> Настройка доступна в публичной школе, в которой включена регистрация через Telegram. В приватной школе раздел настройки Telegram не показывается. В корпоративной школе это **Публичная компания** и **Приватная компания**, а новая компания создаётся приватной — см. [Подключение и настройка компании](https://faq.exode.biz/ru/corporate/setup.md).

**1. Включите Telegram в способах регистрации**

Откройте **Моя школа → Вход и регистрация** (в корпоративной школе — **Компания → Вход и регистрация**). В блоке **Способы регистрации** включите **Telegram** и сохраните. Ниже появится раздел **Настройка Telegram**.

**2. Создайте бота**

В Telegram откройте [@BotFather](https://t.me/BotFather) и создайте бота. BotFather выдаст токен бота.

**3. Получите Client ID**

В @BotFather выберите бота и откройте настройку **Login Widget**. Если метод не включён, нажмите **Switch to OpenID Connect Login** и подтвердите. Скопируйте **Client ID**.

**4. Добавьте адрес школы в BotFather**

В тех же настройках добавьте адрес школы в **Redirect URIs** и **Trusted Origins**. Точные ссылки — для базового домена и для своего домена, если он подключён, — показаны в подсказке **Как подключить** в разделе **Настройка Telegram**.

**5. Заполните настройки в школе**

В разделе **Настройка Telegram** вставьте **Client ID** в блок **Telegram-логин**, а токен — в поле **Токен бота** в блоке **Уведомления от бота**. Поле **Имя бота** заполнится автоматически: платформа проверит токен в Telegram и подставит имя бота.

**6. Сохраните**

Нажмите **Сохранить**. Сохранить форму можно, только если заполнены и **Client ID**, и **Токен бота**.

> [!TIP]
>
> Telegram применяет изменения не сразу и может кешировать настройки. Проверяйте вход через Telegram в режиме инкогнито.

Если токен неверный, под полем появится ошибка от Telegram, а имя бота не подставится. Подробнее о способах входа — в статье [Вход и регистрация](https://faq.exode.biz/ru/general/school-setup/registration-settings.md).

## Как ученик привязывает Telegram

Ученик может привязать Telegram тремя способами:

* **В настройках профиля.** **Настройки → Настройки аккаунта → Телеграм**. Пункт показывается, если в школе настроен бот. Пока Telegram не привязан, рядом написано «Не привязан».
* **В уроке курса.** Если ученик состоит в группе с подключённым Telegram, а аккаунт ещё не привязан, в уроке появляется блок **Подключите телеграм** — «После этого бот пришлет вам ссылку-приглашения».
* **При оплате (только в коммерческой школе).** Если для группы включено **Запрашивать Telegram перед оплатой**, ученик привязывает Telegram прямо на странице оплаты.

При привязке ученик разрешает боту школы писать ему в личные сообщения — без этого бот не сможет прислать приглашение. Один Telegram-аккаунт можно привязать только к одному профилю в школе. Отвязать Telegram ученик может в тех же настройках профиля, платформа попросит подтвердить действие.

## Telegram-канал и чат группы

Каждую группу курса можно связать с Telegram-каналом, Telegram-чатом или обоими сразу.

**1. Подготовьте канал и чат**

Добавьте бота школы администратором канала и чата и дайте ему права приглашать и удалять участников.

**2. Откройте настройки группы**

Перейдите в **Курсы → выберите курс → Группы → выберите группу → Настройки** и откройте вкладку **Чат и канал**.

**3. Укажите ID канала и чата**

В блоке **Через Telegram** заполните **ID канала в Telegram** и **ID группы в Telegram**. Это числовые идентификаторы, например «-12345678». Ссылка **Инструкция** рядом с заголовком блока ведёт на пошаговое руководство.

**4. Настройте приветствие и сохраните**

В блоке **Настройки Telegram** при необходимости заполните **Приветственное сообщение при отправке пригласительной ссылки** и включите **Запрашивать Telegram перед оплатой** (в корпоративной школе — **Запрашивать Telegram перед записью на курс**). Сохраните настройки группы.

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

> [!NOTE]
>
> На той же вкладке, в блоке **На платформе**, включаются **Групповой чат в мессенджере** и **Канал в мессенджере**. Это чаты внутри платформы, они работают независимо от Telegram. Подробнее — в статье [Настройки группы](https://faq.exode.biz/ru/general/groups/group-settings.md).

### Как работают приглашения

| Событие | Что делает бот |
| - | - |
| Ученика с привязанным Telegram добавили в группу: после оплаты, вручную или автоматически | Присылает личное сообщение с кнопками **👉 Канал** и **👉 Группа** |
| Ученик из группы привязал Telegram позже | Присылает приглашения во все его группы с подключённым Telegram, куда он ещё не приглашён |
| Ученика исключили из группы: вручную, после отмены подписки, возврата, перевода в другую группу или удаления группы | Отзывает его ссылку и удаляет из канала и чата |
| Сотрудник нажал **Разослать приглашения** | Присылает приглашения всем участникам с привязанным Telegram, которые ещё не получили ссылку в текущий канал и чат |

Правила приглашений:

* Каждая ссылка персональная и одноразовая: по ней может вступить только один человек.
* Текст сообщения — ваше **Приветственное сообщение** до 500 символов с поддержкой Markdown (V2). Если оно не задано, бот пишет «Ссылка приглашения».
* Если сменить ID канала или чата, уже добавленные ученики не получат приглашение автоматически. Нажмите **Разослать приглашения**.
* Приглашения рассылаются в фоне. Если в группе много участников, рассылка займёт некоторое время.

### Пропущенные приглашения

Если в группе есть участники с привязанным Telegram, которым ещё не отправлена ссылка в текущий канал или чат, на вкладке **Чат и канал** появляется блок **Пропущенные приглашения в Telegram** с кнопкой **Разослать приглашения** и счётчиком таких участников. После подтверждения появится сообщение «Рассылка приглашений запущена».

Статус каждого участника виден в списке учеников группы, в колонке **Telegram**. Колонка показывается, только если к группе подключён Telegram.

| Статус | Что значит |
| - | - |
| **Ссылка отправлена** | Бот прислал приглашение в текущий канал и чат |
| **Ссылка не отправлена** | Приглашение ещё не отправлено |
| **Telegram не привязан** | Ученик не привязал Telegram к профилю |
| **Отправлена ссылка на прошлый чат** | Приглашение было в канал или чат, который заменили новым. Нужна повторная рассылка |

### Запрашивать Telegram перед оплатой

> [!NOTE]
>
> Проверка на странице оплаты есть только в коммерческой школе. В корпоративной школе переключатель называется **Запрашивать Telegram перед записью на курс**.

Если включить эту настройку, привязанный Telegram станет обязательным условием покупки тарифа, который записывает ученика в эту группу:

* авторизованный ученик без Telegram видит «Для продолжения — подключите Telegram» и не может перейти к оплате, пока не привяжет аккаунт;
* неавторизованный покупатель видит «Для продолжения — войдите через Telegram» и входит в школу через Telegram.

Так у каждого покупателя будет Telegram, и бот сможет сразу прислать приглашение.

## Частые вопросы

> **Почему в настройках школы нет раздела «Настройка Telegram»?**
>
> Раздел появляется, только если школа публичная и в **Способах регистрации** включён **Telegram**. Включите переключатель и сохраните настройки.

> **Почему не сохраняются настройки бота?**
>
> Форма сохраняется, только когда заполнены оба обязательных поля: **Client ID** и **Токен бота**. Если под полем токена ошибка, проверьте, что токен скопирован из @BotFather полностью.

> **Ученик оплатил курс, но не получил приглашение в Telegram-канал. Почему?**
>
> Проверьте по порядку: привязан ли у ученика Telegram, указан ли токен бота в школе, правильно ли заполнены ID канала и чата в группе, добавлен ли бот администратором с правом приглашать участников. Если ученик заблокировал бота, сообщение до него не дойдёт. После исправления нажмите **Разослать приглашения** на вкладке **Чат и канал**.

> **Можно ли переслать ссылку-приглашение другому человеку?**
>
> Нет смысла: ссылка одноразовая и персональная. После первого вступления по ней никто больше не войдёт. Кроме того, ссылка отзывается, когда ученика исключают из группы.

> **Мы поменяли Telegram-чат группы. Как пригласить туда всех учеников?**
>
> После сохранения нового ID откройте вкладку **Чат и канал** и нажмите **Разослать приглашения**. Бот пришлёт ссылки всем участникам с привязанным Telegram, у которых ещё нет приглашения в новый чат. В списке учеников у них сейчас статус **Отправлена ссылка на прошлый чат**.

> **Удалит ли бот ученика из чата, если у него закончился доступ?**
>
> Бот удаляет ученика из канала и чата, когда ученика исключают из группы: вручную, после отмены подписки, после возврата, при переводе в другую группу или при удалении группы.

> **Ученик пишет, что «Этот Telegram уже привязан к другому аккаунту». Что делать?**
>
> Один Telegram-аккаунт можно привязать только к одному профилю в школе. Ученику нужно отвязать Telegram от другого профиля в **Настройки → Настройки аккаунта → Телеграм** или использовать другой Telegram-аккаунт.

> **Можно ли изменить текст сообщения с приглашением?**
>
> Да. Заполните **Приветственное сообщение при отправке пригласительной ссылки** на вкладке **Чат и канал** — до 500 символов, поддерживается Markdown (V2). Кнопки **👉 Канал** и **👉 Группа** бот добавит сам.

> **Можно ли делать рассылки ученикам через бота?**
>
> Нет. Бот присылает только приглашения в канал и чат группы и служебные сообщения: о проблемах с подпиской, код восстановления пароля и данные для входа. Для регулярных сообщений используйте канал группы.

***

*Обновлено: 2026-10-17 07:07 UTC*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.