> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/scenarii/proverka-podpiski-telegram.md).

# Проверка подписки Telegram

Опция **«Проверка подписки Telegram»** позволяет автоматически проверять, подписан ли пользователь в группе/канале Telegram, и в зависимости от результата выполнять дополнительные действия (например, отправить сообщение пользователю).

#### Используйте эту опцию, если ваш сценарий строится вокруг подписки:

1. Бот должен проверять, состоит ли человек в нужном канале/группе.
2. Нужно подтвердить факт оплаты, если клиент получает доступ через платную подписку в Telegram.
3. Важно запускать разные ветки сценария в зависимости от того, подписан пользователь или нет (например, дать доступ к урокам только подписчикам, а остальным предложить подписаться).

### Как подготовить группу/канал <a href="#undefined" id="undefined"></a>

Перед настройкой сценария нужно получить ID нужной Telegram‑группы или канала.

* Добавьте вашего Telegram‑бота в эту группу/канал.
* Выдайте боту права администратора. Как это сделать, [читайте ниже](#kak-vydat-botu-prava-administratora).
* После получения прав администратора в этой группе/канале отправьте команду `get_id_group`.
* Скопируйте полученный ID — он понадобится при настройке условия.

### Важный нюанс про ID группы <a href="#id" id="id"></a>

Обратите внимание: ID группы **изменится**, если в настройках Telegram группы вы поменяете «Тип группы» (с частной на публичную или наоборот). Можно работать со всеми типами групп telegram.

<figure><img src="/files/mQHJiJKlzE73ZSkiAlc9" alt=""><figcaption></figcaption></figure>

К примеру, была у вас группа "Частная" ID группы: 5689545, вы сменили на другой тип "Публичная" ID группы изменился: -10045658978.

После изменения типа группы/канала:

* Повторно отправьте команду `get_id_group` в вашу группу.
* Получите новый ID и обновите его в настройках проверки подписки в NEXTBOT.

Иначе бот будет использовать старый ID и не сможет корректно проверить, подписан ли пользователь на актуальную группу.<br>

### Настройка сценария в NEXTBOT <a href="#nextbot" id="nextbot"></a>

1. Откройте раздел «Сценарии» и создайте новый сценарий, например который запускается при старте диалога с новым пользователем.\
   Назовите сценарий для удобства "Проверка telegram подписки"
2. В блоке «Дополнительные условия» включите опцию «Проверка подписки Telegram».
3. В блоке Условия нажмите на кнопку "Добавить группу/канал". В поле «Группа/канал» вставьте ID, который вы получили командой `get_id_group`. Либо:\
   Это поле так же принимает ссылку на группу/канал вида: "@groupName", или ссылка "t.me/groupName.
4. В параметре «Ожидание» выберите нужный статус:

   * «Пользователь подписан» или
   * «Пользователь не подписан»

   <figure><img src="/files/jJvNRNpjvNCvAriYb7Ag" alt=""><figcaption></figcaption></figure>

Чтобы бот сообщал пользователю, что он не подписан на группу, настройте условие «Пользователь не подписан» и добавьте действие «Отправить сообщение».

<figure><img src="/files/L6DI7qTcq4jndIB5u9bl" alt=""><figcaption></figcaption></figure>

* В качестве текста сообщения можно указать, например: «Вы не подписаны на нашу группу. Пожалуйста, подпишитесь, чтобы получить доступ к материалам».
* После этого при обращении нового пользователя к ИИ‑агенту бот проверит подписку и, если пользователь не состоит в группе, отправит указанное сообщение.

### Как выдать боту права администратора

1. В вашей Telegram-группе в правом верхнем углу нажимаем на "троеточие" и выбираем "Управление группой"
2.

```
<figure><img src="../../.gitbook/assets/{8B9A930E-17ED-4C01-A806-3D5E3A662E0A}.png" alt=""><figcaption></figcaption></figure>
```

3. Во вкладке "Администраторы" нажмите "Добавить администратора" и добавьте вашего Telegram бота.
4. Готово


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://doc.nextbot.ru/functional/scenarii/proverka-podpiski-telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.