> 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/questions-answers/faq.md).

# Часто задаваемые вопросы

Короткие ответы на вопросы, которые чаще всего задают в поддержку. Если тема описана подробнее, в ответе есть ссылка на статью.

## Тарифы и подписка

### Сколько агентов входит в тариф и сколько стоит дополнительный?

* «Блогер» — 1 ИИ-агент, создать дополнительных нельзя.
* «Бизнес», «Премиум» и «Всё включено» — 5 ИИ-агентов входят в тариф, а каждый дополнительный стоит 15 Botcoin в день.

Подробнее: [Тарифы](https://doc.nextbot.ru/price/tariffs.md).

### Сколько чатов включено в месяц?

Количество чатов тариф не ограничивает. Ограничение одно — баланс Botcoin: каждый ответ агента оплачивается по расходу токенов ИИ-модели.

На GPT-5.4, которую мы рекомендуем для старта, бонусных Botcoin хватает примерно на столько типичных диалогов в месяц:

* «Блогер» — около 90;
* «Бизнес» — около 110;
* «Премиум» — около 550;
* «Всё включено» — около 2 150.

Реальное число зависит от длины переписки, размера промпта и выбранной ИИ-модели: экономичные модели обходятся в несколько раз дешевле. Если Botcoin закончатся, докупите пакет: купленные Botcoin не сгорают. Как считается расход: [Расходы на LLM](https://doc.nextbot.ru/price/cenoobrazovanie/raskhody-na-llm.md).

### Сколько длится тестовый период?

14 дней с момента регистрации. Что важно знать о тесте:

* на баланс начисляется 25 Botcoin;
* Python Script недоступен;
* WhatsApp и MAX в тест не входят, их можно подключить за доплату;
* когда тест закончится, аккаунт перейдёт на тариф «Парковка», пока вы не оплатите подписку.

Подробнее о тарифе «Тест»: [Тарифы](https://doc.nextbot.ru/price/tariffs.md).

### Чем тариф «Премиум» отличается от тарифа «Бизнес»?

На «Премиуме» есть всё, что на «Бизнесе», и сверх того:

* интеграции Bitrix24, amoCRM, Kommo, U-ON, EnvyCRM, Notion и ElevenLabs;
* Таблицы;
* 1 800 Botcoin в месяц вместо 370;
* до 10 вариантов системного промпта вместо 3.

WhatsApp и MAX не входят ни в один из этих тарифов: их подключают отдельным пакетом в разделе «Интеграции». Полное сравнение: [Тарифы](https://doc.nextbot.ru/price/tariffs.md).

### Почему при подписке на несколько месяцев Botcoin начисляются только за один месяц?

Бонусные Botcoin начисляются каждый месяц, а не за весь оплаченный период сразу. Их количество зависит от тарифа:

* «Блогер» — 300;
* «Бизнес» — 370;
* «Премиум» — 1 800;
* «Всё включено» — 7 000.

Неистраченные бонусные Botcoin сгорают, когда заканчивается месяц подписки: если вы оплатили 5 ноября, остаток сгорит 5 декабря, и в этот же день придут новые бонусные Botcoin. Botcoin, которые вы докупили отдельно, не сгорают и переходят на следующий месяц.

### В каком часовом поясе заканчивается подписка?

Окончание подписки не зависит от часового пояса и времени оплаты. Подписка завершается в 00:00 по Гринвичу (UTC) в указанную дату.

Например, если в кабинете указано 12 ноября, подписка закончится в 00:00 UTC 12 ноября — в ночь с 11 на 12 ноября, по Москве в 03:00 12 ноября.

### Можно ли пользоваться Nextbot без тарифа, если просто пополнить Botcoin?

Нет. Купить Botcoin можно и без тарифа, и они не сгорают с окончанием подписки. Но Botcoin оплачивают запросы к ИИ-модели и другие платные операции, а каналы связи и интеграции работают только при активной подписке — даже если подключён свой API-ключ.

Когда подписка заканчивается, аккаунт переходит на тариф [«Парковка»](https://doc.nextbot.ru/price/tariffs.md#tarif-parkovka). На нём работает только тестовый чат. Если вы не оплатите подписку:

* через 14 дней отключаются каналы связи и интеграции — после оплаты их придётся настроить заново;
* через 2 месяца безвозвратно удаляются данные из Базы знаний, Таблиц и Облака.

### Нужно ли заново регистрироваться на Nextbot.kz, чтобы оплатить в тенге?

Нет. Аккаунт общий для Nextbot.ru и Nextbot.kz: на обоих доменах те же логин и пароль, те же агенты, Botcoin и настройки. Чтобы оплатить подписку или Botcoin в тенге, откройте [раздел оплаты на Nextbot.kz](https://app.nextbot.kz/account?nameComponent=PricingPlanSubscriptions) и войдите с данными от Nextbot.ru.

Если войти на Nextbot.kz не получается, напишите в [техподдержку](https://t.me/nextbot_support_bot): укажите email аккаунта и текст ошибки, которую видите при входе.

## Botcoin и расходы

### Что такое Botcoin?

Botcoin — внутренняя валюта Nextbot. Ею оплачиваются запросы к ИИ-модели и платные сервисы внутри платформы, например озвучка через ElevenLabs.

Botcoin бывают двух видов:

* **бонусные** — приходят с подпиской каждый месяц, неистраченные сгорают в конце месяца подписки (считается от дня оплаты, а не по календарю);
* **резервные** — вы покупаете их сами, они не сгорают и расходуются после бонусных.

Подробнее: [Тарифы](https://doc.nextbot.ru/price/tariffs.md).

### Как уменьшить расход Botcoin?

* **Сократите системный промпт и историю диалога.**
* **Для простых задач возьмите экономичную ИИ-модель** — с пометкой Mini, Nano, Flash или Haiku, например GPT-5.4 Mini или Claude Haiku 4.5. Как выбрать: [Языковые модели](https://doc.nextbot.ru/functional/setting-up-agent/yazykovye-modeli.md).
* **Вынесите справочную информацию из промпта** в подходящий источник знаний: в [Справочник](https://doc.nextbot.ru/functional/knowledge-base/spravochniki.md) — типовые точные ответы (контакты, условия доставки, цены, характеристики), в [Базу знаний](https://doc.nextbot.ru/functional/knowledge-base/baza-znanii.md) — объёмные материалы, по которым нужен поиск по смыслу.
* **Подключите свой API-ключ** — тогда за работу ИИ-модели вы платите напрямую провайдеру. Подробнее: [Свои API-ключи](https://doc.nextbot.ru/functional/setting-up-agent/svoi-klyuch-openai.md).

После изменений протестируйте агента на реальных вопросах и сравните расход в диалогах.

### Как узнать, сколько тратит агент при тестировании?

Без своего API-ключа расход зависит от:

* длины промпта;
* объёма материалов из источников знаний;
* длины диалога;
* выбранной ИИ-модели.

Чтобы узнать расход своего агента, откройте раздел [«Диалоги»](https://doc.nextbot.ru/functional/dialogi.md) и выберите чат, в котором тестировали агента: расход токенов и Botcoin указан в правом верхнем углу.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-7bef7d3d8e35cc237c503887deca8831c2fde146%2Ffaq-dialogi-raskhod-botcoin.png?alt=media" alt="Шапка диалога в разделе «Диалоги»: справа вверху блок с расходом Botcoin, входящими и исходящими токенами"><figcaption><p>Расход Botcoin и токенов по диалогу — в правом верхнем углу</p></figcaption></figure>

### Если я добавил свой API-ключ, Botcoin всё равно списываются?

Да. Со своим ключом Nextbot списывает 0,01 Botcoin за каждый запрос к ИИ-модели. Запрос — это любое действие агента, на которое тратятся токены: анализ сообщения клиента, поиск по источникам знаний, формулирование ответа и т. д. На один ответ клиенту может уйти несколько запросов.

Саму работу ИИ-модели вы оплачиваете её провайдеру (OpenAI, Anthropic и другим). Использовать можно ключи OpenAI, Anthropic, xAI, DeepSeek и OpenRouter.

Подробнее: [Свои API-ключи](https://doc.nextbot.ru/functional/setting-up-agent/svoi-klyuch-openai.md).

### Как повышается уровень ключа OpenAI и как списываются деньги?

Уровень Usage tier в OpenAI повышается автоматически по мере оплат и трат на API. Для 3-го уровня OpenAI сейчас указывает условие: оплачено от $100 и прошло не менее 7 дней с первого успешного платежа.

Деньги списываются по факту трат: автоматически с карты или с заранее пополненного баланса — зависит от способа оплаты, подключённого в OpenAI.

Nextbot при своём ключе дополнительно списывает 0,01 Botcoin за каждый запрос к ИИ-модели — то есть за любое действие агента, на которое тратятся токены.

### Как посчитать расход на месяц?

1. Настройте агента полностью: промпт, источники знаний, функции и свой ключ, если планируете его использовать.
2. Проведите несколько тестовых диалогов и посмотрите средний расход на один диалог.
3. Умножьте его на число диалогов в день и на 30 — получится примерный расход в месяц.

### Тратит ли агент токены, пока диалог на паузе?

Почти нет. Текст и картинки, которые клиент присылает во время паузы, сохраняются в переписке. Агент обработает их, когда пауза снимется и он начнёт отвечать, — тогда и спишутся токены.

Исключение — голосовые сообщения. Если включено распознавание голосовых, они распознаются сразу, даже на паузе, и на это тратятся токены.

У выключенного агента токены не тратятся.

### Как сделать, чтобы агент продолжал работать, если закончились деньги на ключе?

Сам агент на Botcoin не переключится. Пока на ключе нет денег, агент отвечает клиентам стандартным сообщением об ошибке, которое задаётся в настройках агента. Есть два способа это исправить:

* **пополните баланс у провайдера ИИ-модели**, например OpenAI или Anthropic, — агент сразу начнёт отвечать как обычно;
* **удалите свой ключ в настройках агента** — агент перейдёт на трату только Botcoin.

Если бонусных Botcoin не хватает, купите дополнительный пакет — он не сгорает с окончанием тарифа.

Купите Botcoin в настройках аккаунта на вкладке «Покупка Botcoin» или нажмите на баланс Botcoin в правом верхнем углу:

* из России — [app.nextbot.ru](https://app.nextbot.ru/account?nameComponent=PricingPlanBucks);
* из Казахстана и других стран — [app.nextbot.kz](https://app.nextbot.kz/account?nameComponent=PricingPlanBucks).

## Промпт и знания агента

### Какой длины должен быть промпт?

Как можно короче. Промпт уходит в ИИ-модель с каждым сообщением клиента, поэтому длинный промпт стоит дороже, а в длинном списке задач модель чаще что-то пропускает. В промпте оставьте роль агента, правила общения и логику работы. Остальное вынесите:

* объёмные материалы — в [Базу знаний](https://doc.nextbot.ru/functional/knowledge-base/baza-znanii.md);
* точные справочные данные, например контакты, цены и условия доставки, — в [Справочник](https://doc.nextbot.ru/functional/knowledge-base/spravochniki.md);
* несколько независимых сложных процессов — в отдельных агентов. Например, если агент одновременно продаёт и ведёт техподдержку, сделайте двух агентов.

### Куда загрузить прайс?

Зависит от размера:

* **десятки позиций** — в [Справочник](https://doc.nextbot.ru/functional/knowledge-base/spravochniki.md). ИИ-модель получает его целиком при каждом сообщении клиента: Справочник на 300 вопросов добавляет к каждому запросу примерно 4–5 тысяч токенов;
* **сотни и тысячи позиций** — в [таблицу](https://doc.nextbot.ru/functional/knowledge-base/tablicy.md) и функцию с действием [«Поиск в таблице»](https://doc.nextbot.ru/functional/knowledge-base/tablicy/poisk-v-tablice.md). Тогда ИИ-модель получает только найденные строки. Таблицы доступны на тарифах «Премиум» и «Всё включено»;
* **большой прайс на тарифе «Бизнес»** — разбейте данные по смыслу в [Базу знаний](https://doc.nextbot.ru/functional/knowledge-base/baza-znanii.md): агент найдёт нужный фрагмент поиском по смыслу.

### Может ли агент брать информацию с сайтов, ссылки на которые мы ему дали?

По ссылкам из промпта или сообщений в диалоге агент перейти не может. У агента есть [веб-поиск](https://doc.nextbot.ru/functional/knowledge-base/veb-poisk.md), его включают в настройках агента: ИИ-модель сама ищет в интернете, когда это нужно для ответа. Но веб-поиск работает только с моделями OpenAI и ищет по всему интернету — ограничить его вашими сайтами нельзя.

Чтобы агент отвечал по вашим материалам:

* загрузите их в [источники знаний](https://doc.nextbot.ru/functional/knowledge-base.md): Справочник, Базу знаний, документы или таблицы;
* если ваша база знаний опубликована в GitBook, подключите её в «Источники знаний» → «GitBook» — агент будет искать ответы прямо в ней. Подробнее: [GitBook](https://doc.nextbot.ru/functional/knowledge-base/gitbook.md).

### Где хранить изображения, которые агент должен отправлять клиентам?

Загрузите файлы во встроенное [Облако](https://doc.nextbot.ru/functional/oblako.md), скопируйте ссылку и вставьте её в промпт или Базу знаний. Сторонние хостинги вроде ImgBB или Imgur не нужны.

Чтобы агент отправлял картинку в чат, а не ссылку, включите отправку изображений по ссылкам в настройках агента. Подробнее: [Изображения](https://doc.nextbot.ru/functional/setting-up-agent/golosovye-soobsheniya-i-izobrazheniya/izobrazheniya.md).

## Каналы и подключение

### Как подключить агента к чату на сайте?

Выберите агента, откройте «Интеграции» → «Чат на сайт» и следуйте инструкции на странице. Есть два варианта:

* виджет в углу сайта;
* встроенный чат на странице.

Подробнее: [Чат на сайт](https://doc.nextbot.ru/functional/integrations/chat-na-sait.md).

### Как подключить агента к Telegram?

Откройте «Интеграции» → «Telegram Bot» и нажмите «Мастер подключения»: он задаст вопросы и проведёт только по нужным вам шагам. Подробнее: [Подключение Telegram через мастер](https://doc.nextbot.ru/functional/integrations/telegram/instrukciya-dlya-podklyucheniya-telegram-cherez-master-podklyuchenii.md).

### Как подключить агента к Bitrix24?

Интеграция доступна на тарифах «Премиум» и «Всё включено». В Bitrix24 нужны права администратора и подписка на Битрикс24 Маркетплейс. Есть два способа подключения:

* мессенджеры подключены к Nextbot, а переписка передаётся в CRM — [Коммуникация через Nextbot](https://doc.nextbot.ru/functional/integrations/bitrix24/podklyuchenie/podklyuchenie-nextbot-kak-kanal.md);
* мессенджеры подключены к открытым линиям Bitrix24, а агент отвечает в них как чат-бот — [Коммуникация через Bitrix24](https://doc.nextbot.ru/functional/integrations/bitrix24/podklyuchenie/podklyuchenie-nextbot-kak-chatbot.md).

Обзор возможностей: [Bitrix24](https://doc.nextbot.ru/functional/integrations/bitrix24.md).

### Можно ли подключить несколько аккаунтов WhatsApp к одному агенту?

Нет. Для каждого номера WhatsApp нужен отдельный агент. Подробнее: [WhatsApp](https://doc.nextbot.ru/functional/integrations/whatsapp.md).

### Почему в виджете или чате на сайте искажается текст?

Чаще всего это не ошибка агента, а переводчик браузера или расширение (Google Translate, Яндекс Переводчик и аналоги). Он переводит страницу вместе с окном [виджета](https://doc.nextbot.ru/functional/integrations/chat-na-sait/vidzhet-dlya-saita.md) или [встроенного чата](https://doc.nextbot.ru/functional/integrations/chat-na-sait/chat-lending-na-veb-sait-iframe.md): ответы агента, кнопки, подсказки и даже текст, который вводит посетитель.

Как проверить:

1. Откройте тот же диалог в разделе [«Диалоги»](https://doc.nextbot.ru/functional/dialogi.md). Если там текст правильный, а на сайте — «ломаный», причина в браузере посетителя.
2. Отключите перевод страницы и расширения-переводчики, обновите сайт и снова откройте чат.
3. Если текст стал нормальным, менять промпт и код виджета не нужно.

### Почему деление сообщений не работает в виджете или чате на сайте?

[Деление сообщений](https://doc.nextbot.ru/functional/setting-up-agent/delenie-soobshenii.md) не поддерживается в [виджете](https://doc.nextbot.ru/functional/integrations/chat-na-sait/vidzhet-dlya-saita.md), во [встроенном чате](https://doc.nextbot.ru/functional/integrations/chat-na-sait/chat-lending-na-veb-sait-iframe.md) и в [тестовом чате](https://doc.nextbot.ru/functional/chat.md). В этих каналах ответ агента приходит одним сообщением, даже если деление включено.

## Поведение агента

### Почему в тестовом чате агент учитывает изменения промпта, а в Telegram — нет?

Новый промпт применяется сразу, но агент опирается и на историю диалога: он видит свои прошлые ответы и может их повторять. Чтобы проверить изменения с чистого листа, отправьте в чат Telegram команду `/restart` — она очистит историю диалога.

### Почему агент отвечает по-разному в тестовом чате и в мессенджерах?

Промпт и функции одинаковы во всех каналах. Разница в том, что пишут люди: в тестовом чате вопросы обычно короткие и чёткие, а клиенты в мессенджерах пишут свободно — с ошибками, сленгом и лишними подробностями.

Поэтому проверяйте агента на реальных формулировках: возьмите вопросы из [«Диалогов»](https://doc.nextbot.ru/functional/dialogi.md) и повторите их в тестовом чате.

### Почему агент повторяет одну и ту же фразу или отправляет дубли?

Одной известной причины нет. Проверьте по порядку:

1. **Не пишет ли клиент несколько сообщений подряд.** Агент отвечает на каждое, и кажется, что он повторяется. Включите [Буфер сообщений](https://doc.nextbot.ru/functional/setting-up-agent/bufer-soobshenii.md) — агент подождёт и ответит на все сообщения разом.
2. **Промпт.** Нет ли в нём повторяющихся или противоречащих друг другу инструкций, например одного и того же приветствия в нескольких местах.
3. **ИИ-модель.** Если промпт в порядке, а проблема остаётся, попробуйте другую модель в настройках агента и сравните ответы в тестовом чате.

### Почему агент реагирует на отложенное сообщение так, будто его написал клиент?

Служебная инструкция из [отложенной отправки](https://doc.nextbot.ru/functional/setting-up-agent/otlozhennaya-otpravka.md) или [контекста в диалоге](https://doc.nextbot.ru/functional/functions/sending-result/dobavit-kontekst-v-dialog.md) попадает в историю как входящее сообщение. Не пишите «если клиент промолчал» и не ссылайтесь на «стартовое сообщение»: сформулируйте, что сказать клиенту, и для надёжности начните текст с `[СИСТЕМА]`. Подробнее: [Инструкции в отложенных и системных сообщениях](https://doc.nextbot.ru/functional/setting-up-agent/system-prompt/instrukcii-v-otlozhennykh-i-sistemnykh-soobsheniyakh.md).

### Когда диалог встаёт на паузу?

* Оператор написал в диалог, и включён [«Контроль вмешательства оператора»](https://doc.nextbot.ru/functional/setting-up-agent/upravlenie-aktivnostyu-agenta.md).
* Оператор написал стоп-фразу из блока [«Управление диалогом по ключевым фразам»](https://doc.nextbot.ru/functional/setting-up-agent/upravlenie-dialogom-po-klyuchevym-frazam.md).
* Выполнилась функция с настройкой [«Поставить на паузу»](https://doc.nextbot.ru/functional/functions/behavior-scenario.md#postavit-na-pauzu).
* Сработал сценарий с действием [«Пауза диалога»](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh.md#pauza-dialoga).
* Клиент превысил [лимит расходов на пользователя](https://doc.nextbot.ru/functional/setting-up-agent/limit-rashodov-na-polzovatelya.md).
* Оператор вручную поставил диалог на паузу в разделе [«Диалоги»](https://doc.nextbot.ru/functional/dialogi.md).

Паузу можно снять вручную в разделе «Диалоги», фразой из «Управления диалогом по ключевым фразам» или автоматически через заданное время — это настраивается в «Контроле вмешательства оператора».

### Может ли агент первым написать клиенту, например новому лиду?

Пока нет: клиент должен начать диалог сам. Написать клиенту по вашей инициативе можно двумя способами:

* [рассылки](https://doc.nextbot.ru/functional/rassylki.md) — по клиентам, которые уже писали агенту;
* роботы Bitrix24 — отправляют стартовое сообщение новому лиду. Подробнее: [Bitrix24](https://doc.nextbot.ru/functional/integrations/bitrix24.md).

### Может ли агент переслать администратору скриншот или фото от клиента?

Сам файл — нет, но ссылку на него — да:

1. В действии «Админу в мессенджер» добавьте поле со значением «Ссылка на последнее изображение пользователя». Подробнее о действии: [Админу в мессенджер](https://doc.nextbot.ru/functional/functions/sending-result/adminu-v-messendzher.md).
2. Проверьте, кто привязан как администратор в настройках канала: отчёт придёт ему. Например, в Telegram для этого отправляют одноразовый пароль администратора боту в личные сообщения или в группу. Подробнее: [Получение отчётов](https://doc.nextbot.ru/functional/integrations/telegram/poluchenie-otchetov.md).

В отчёте придёт ссылка на последнюю картинку, которую прислал клиент.

## Помощь и консультации

### Как получить консультацию по настройке?

Напишите в [техподдержку](https://t.me/nextbot_support_bot): там разберут ваш вопрос.


---

# 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/questions-answers/faq.md?ask=<question>&goal=<user_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.
