> 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/integrations/lichnyi-telegram.md). # Личный Telegram Интеграция подключает ваш аккаунт Telegram к ИИ-агенту по QR-коду. Бот для этого не нужен: Nextbot подключается к аккаунту как ещё одно устройство — так же, как Telegram Desktop. После подключения агент отвечает на входящие сообщения от вашего имени, и собеседник видит обычную переписку с вами. Такой формат подходит для продаж, личных консультаций и работы с клиентами, которые пишут вам напрямую. Если агент должен работать через Telegram-бота — используйте другие [типы подключения Telegram](/functional/integrations/telegram/podklyuchenie.md). Чем личный Telegram отличается от подключения через «Telegram для бизнеса» — в [сравнении вариантов](/functional/integrations/telegram/podklyuchenie.md#lichnyi-telegram-ili-business). {% hint style="info" %} Чтобы ИИ-агент не отвечал знакомым, родственникам и в других нежелательных диалогах, поставьте такие диалоги на паузу в окне диалога Nextbot. {% endhint %} Telegram может ограничить или заблокировать аккаунт за признаки автоматизации, жалобы пользователей и агрессивные рассылки. Сторонние сервисы на это решение повлиять не могут. ## Оплата пакета {% hint style="info" %} Пакет личного Telegram приобретается отдельно для каждого ИИ-агента. К одному агенту подключается один аккаунт Telegram. {% endhint %} 1. Перейдите в раздел **Интеграции** и откройте **Личный Telegram**. 2. Проверьте, к какому ИИ-агенту вы подключаете Telegram. Название агента отображается в верхней панели, перед путём `Интеграции › Личный Telegram`. Если выбран не тот агент, нажмите на его название и выберите нужного. 3. Нажмите **«Оплатить»** и выберите период подписки. 4. Дождитесь, пока подключение будет создано. Обычно это занимает несколько минут. Чтобы обновить статус, нажмите значок обновления рядом со сроком оплаты. После оплаты на странице появится срок действия пакета — например, `оплачено до 01.10.2026, 01:59`. Когда подключение будет создано, статус изменится на `Не авторизован — подключите аккаунт по QR-коду`. Теперь можно подключать аккаунт. ## Подключение по QR-коду 1. Откройте Telegram на телефоне, на котором выполнен вход в нужный аккаунт. 2. Перейдите в **Настройки** → **Устройства** и нажмите **Подключить устройство** (в некоторых версиях приложения — **Сканировать QR-код**). Откроется камера. 3. В Nextbot нажмите **«Получить QR код»**. 4. Наведите камеру телефона на QR-код. {% hint style="info" %} QR-код действует ограниченное время, поэтому сначала откройте камеру в Telegram и только потом получайте код. Если код устарел, нажмите **«Получить QR код»** ещё раз. Если новый код не появляется, нажмите **«Перезагрузить»**, подождите несколько минут и повторите попытку. {% endhint %} #### Облачный пароль Если в аккаунте Telegram включён облачный пароль (двухэтапная аутентификация), после сканирования QR-кода его нужно ввести. Введите пароль в поле, которое появится на странице интеграции, и отправьте его. Облачный пароль задаётся в Telegram в разделе **Настройки** → **Конфиденциальность** → **Облачный пароль**. Nextbot не может восстановить или сбросить этот пароль: если вы его не помните, восстановите его в Telegram. #### После подключения Статус подключения обновится, и ИИ-агент начнёт отвечать на входящие сообщения. Если статус не изменился, нажмите значок обновления рядом со сроком оплаты. Что ещё произойдёт после подключения: * Telegram пришлёт в служебный чат `Telegram` уведомление о входе с нового устройства — это нормально; * в Telegram в разделе **Настройки** → **Устройства** появится новый сеанс — это подключение Nextbot; * держать телефон включённым не нужно: сеанс Nextbot работает независимо от него. {% hint style="warning" %} Не завершайте сеанс Nextbot в разделе **Устройства** и не нажимайте **«Завершить другие сеансы»**. Иначе ИИ-агент отключится от аккаунта, и потребуется снова авторизоваться по QR-коду. {% endhint %} ### Статус подключения Состояние подключения отображается в блоке `Подключение личного Telegram`: * `Статус подключения` — авторизован ли аккаунт и может ли ИИ-агент работать; * `оплачено до` — срок действия пакета; * **«Подробнее о текущем статусе»** — расшифровка текущего статуса и рекомендации, что делать дальше. ## Управление подключением | Кнопка | Назначение | | ------------------------- | ---------------------------------------------------------------------------------------------------------- | | **Оплатить** | Оплатить или продлить пакет личного Telegram. | | **Получить QR код** | Получить QR-код для авторизации аккаунта. | | **Перезагрузить** | Перезапустить подключение, если QR-код не генерируется, статус не обновляется или агент перестал отвечать. | | **Отключить** | Отключить аккаунт Telegram от ИИ-агента. Кнопка доступна, когда аккаунт авторизован. | | **Перенести подключение** | Перенести подключение и оплаченный пакет на другого ИИ-агента. | ### Перенос подключения на другого агента Чтобы перенести подключение на другого ИИ-агента, нажмите **«Перенести подключение»** на странице интеграции. {% hint style="info" %} При переносе подключения списывается 1 оплаченный день. Если у выбранного агента уже есть подключение личного Telegram, оставшиеся дни переносимого подключения добавятся к его пакету с учётом списания 1 дня за перенос. Если остался 1 оплаченный день, перенос недоступен — для переноса должно оставаться 2 или более оплаченных дня. {% endhint %} 1. Выберите агента, на которого нужно перенести подключение. 2. Поставьте галочку, подтверждающую, что клиент уведомлён о списании одного оплаченного дня. 3. Нажмите **«Подтвердить перенос»**. ## Настройки личного Telegram В блоке `Настройка личного Telegram` задаётся, как ИИ-агент работает с входящими сообщениями и групповыми чатами. ### Отмечать сообщения как прочитанные Настройка в разделе `Входящие сообщения`. * **Включена** — входящие сообщения сразу отмечаются прочитанными, и собеседник видит, что его сообщение прочитано. В группах сообщения отмечаются прочитанными, только если агент в них отвечает. * **Выключена** — Nextbot не отмечает сообщения прочитанными, и в вашем Telegram они остаются непрочитанными, пока вы не откроете чат. ### Отвечать в группе Настройка в разделе `Групповые чаты`. * **Включена** — ИИ-агент отвечает в групповых чатах, в которых состоит подключённый аккаунт. * **Выключена** — агент игнорирует сообщения в группах. {% hint style="warning" %} Настройка действует на все группы аккаунта, в том числе на личные — семейные, дружеские, рабочие. Включайте её, только если агент действительно должен отвечать в группах. {% endhint %} ### Считать группу одним диалогом * **Включена** — все сообщения из одной группы обрабатываются как один общий диалог с указанием автора каждого сообщения. * **Выключена** — для каждого участника группы, который написал сообщение, в Nextbot создаётся отдельный диалог. ### Отчёты администратору В блоке `Отчёты администратору` настраивается, кому ИИ-агент отправляет отчёты: одному человеку в личные сообщения или в группу. Отчёты приходят сообщениями от подключённого аккаунта Telegram. 1. Задайте пароль в поле `Одноразовый пароль администратора`. 2. Отправьте этот пароль подключённому аккаунту: * **в личные сообщения** — с того аккаунта Telegram, на который нужно получать отчёты. Отчёты будут приходить этому человеку лично; * **в групповой чат**, в котором состоит подключённый аккаунт, — отчёты будут приходить в эту группу. 3. Дождитесь сообщения `Вы получили права администратора`. После привязки пароль обнулится. {% hint style="info" %} Чтобы привязать группу, должна быть включена настройка **«Отвечать в группе»**. После привязки её можно выключить, если агент должен только присылать отчёты в группу, но не отвечать в ней. {% endhint %} Текущий получатель отображается под полем пароля — в строках `Сейчас: отчёты отправляются…` и `Текущий id пользователя для отчётов`. * Получатель отчётов может быть только один. Чтобы сменить его, задайте новый пароль и отправьте его из нужного чата — новая привязка заменит текущую. * Если id не обновился сразу после привязки, нажмите значок обновления рядом с ним. * Чтобы отвязать получателя, нажмите значок корзины. Чтобы ИИ-агент отправлял отчёты, добавьте в функцию/сценарий действие **«Админу в мессенджер»**. ## Инструкции по безопасной работе с Telegram В нижней части страницы интеграции находится блок `Инструкции по безопасной работе с Telegram`. В нём три вкладки: * **Подключение** — порядок подключения аккаунта к Nextbot; * **Как снизить риск блокировки** — рекомендации по безопасной работе с аккаунтом; * **Блокировки Telegram** — какие блокировки бывают и что с ними делать. ### Возможные проблемы QR-код не появляется или не сканируется: * Если код устарел, нажмите **«Получить QR код»** ещё раз. * Сканируйте код в самом Telegram — через **Настройки** → **Устройства** → **Подключить устройство**, а не камерой телефона. * Если код не генерируется, нажмите **«Перезагрузить»**, подождите несколько минут и повторите попытку. ИИ-агент перестал отвечать: 1. Проверьте статус подключения и нажмите **«Подробнее о текущем статусе»**. 2. Проверьте срок действия пакета в строке `оплачено до`. 3. Откройте в Telegram **Настройки** → **Устройства** и убедитесь, что сеанс Nextbot не завершён. Если он завершён, снова подключите аккаунт по QR-коду. 4. Убедитесь, что диалог не поставлен на паузу в Nextbot. 5. Если ничего не помогло, нажмите **«Перезагрузить»** и через несколько минут проверьте статус. ИИ-агент отвечает знакомым или в личных группах: Поставьте нежелательные диалоги на паузу или заблокируйте их в окне диалога Nextbot. Чтобы агент не отвечал в группах, выключите настройку **«Отвечать в группе»**. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://doc.nextbot.ru/functional/integrations/lichnyi-telegram.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.