Гид по Telegram-боту¶

Telegram-бот — самый простой способ управлять Nexus самостоятельно. Через бота можно автоматически получить профиль, пополнить баланс, выпускать и отзывать API-ключи, задавать лимиты, открывать обращение в поддержку и смотреть список моделей.

Адрес бота — @nexus_hubbot

1. Запуск бота¶

Откройте Telegram и найдите @nexus_hubbot.
Отправьте /start.

При первом /start бот сначала просит выбрать язык интерфейса, а затем валюту отображения: RUB, USD, EUR или CNY. После обоих выборов бот создаёт один профиль, сохраняет настройки и показывает новый публичный шестизначный Nexus ID вместе с главным меню.

Главное меню для активного профиля устроено так: отдельная крупная кнопка Пополнить, затем ряд Ключи + Модели, затем ряд История + Дополнительно.

В разделе Дополнительно находятся: Поддержка, Пригласить друзей, Перенести баланс и Сменить язык. Условия программы описаны в разделе Реферальная программа.

Для замороженного профиля верхний уровень сокращается до Модели и Дополнительно.

При этом внутри Дополнительно по-прежнему остаются доступны поддержка, перенос баланса и язык.

2. Создание профиля¶

Профиль создаётся после выбора языка и валюты. Он хранит ваш баланс, API-ключи и их настройки. Один Telegram-пользователь имеет ровно один профиль, а профиль сохраняет свой Nexus ID.

Nexus ID публичный: его можно использовать для пополнений и поддержки, но не как пароль или способ восстановления. Если у вас уже есть старый профиль и доступ к нему, используйте отдельный перенос баланса.

3. Перенос баланса¶

Перенос баланса подходит, если старый Telegram ещё доступен и на его профиле есть положительный доступный баланс.

В старом Telegram откройте Дополнительно.
Нажмите Перенести баланс.
Бот покажет одноразовую команду вида /start transfer_<token>.
На целевом Telegram откройте эту ссылку. Если это первый запуск, сначала выберите язык и валюту; после этого перенос будет обработан автоматически.

При применении переносится вся доступная положительная сумма в рублях на этот момент. Исходный и целевой профили остаются разными: Nexus ID, Telegram-связи, API-ключи, история, платежи и настройки не переносятся.

Ссылка действует ограниченное время и принимается один раз. Для недействительной, истёкшей или уже использованной ссылки бот показывает нейтральный ответ. Если ссылка истекла, создайте новую на исходном профиле.

4. Пополнение баланса¶

В главном меню выберите Пополнить.
Укажите сумму целыми рублями или в своей отображаемой валюте с кодом, например 10 USD.
Выберите доступный способ оплаты. Список, порядок, лимиты, подпись и отображаемая комиссия берутся из настроек платёжного контура.
Проверьте предпросмотр: сумму, способ оплаты, комиссию, сумму к оплате, корректировки и итог к зачислению.
Перейдите к оплате по ссылке выбранного способа.
Для проверки используйте статус только своего платёжного намерения; повторное пополнение создаёт новое намерение.

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

В истории балансный платёж показывается одним событием: отдельно видны основная сумма, бонус и общий итог к зачислению. Остальные балансные операции также показываются отдельными типизированными событиями.

Сообщение Digiseller после оплаты содержит ссылки на бот Nexus и документацию. Если покупка была оформлена без Nexus ID, в нём также будет одноразовый код активации и ссылка в бот. Откройте ссылку или выберите Пополнить → Активировать покупку и введите код. Transaction ID из сообщения нужен только для обращения в поддержку.

Кнопка Активировать покупку открывает сценарий активации уже оплаченной покупки. Отправьте одноразовый код из сообщения о платеже или откройте бота командой /start pay_<code>. Код принимается один раз; для недействительного, использованного и отозванного кода используется один нейтральный ответ.

После активации бот показывает оплаченную сумму, корректировки, итог к зачислению, итоговый баланс и назначенный Nexus ID. Новому пользователю предлагается выпустить API-ключ, затем доступны кнопки Модели и Документация. Сценарий не запрашивает Transaction ID и не добавляет пользовательский поиск платежа.

Код пополнения¶

Если поддержка отправила вам код пополнения, откройте Пополнить → Активировать код пополнения и отправьте код. Для этого сценария не используются ссылки или параметры /start.

Код пополнения — это начисление от поддержки, а не оплата покупки. Он принимается один раз; для недействительного, использованного, отозванного и истёкшего кода бот показывает один нейтральный ответ. После успешной активации бот показывает сумму начисления и текущий баланс.

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

Баланс общий для всех API-ключей вашего профиля. Перед оплатой сверяйте Nexus ID в профиле: пополнение другого Nexus ID зачислится на другой аккаунт.

5. Выпуск полноценного API-ключа¶

После пополнения можно выпустить полноценный ключ без ограничения по времени.

В главном меню выберите Ключи.
Нажмите Выпустить ключ.
Новый ключ получит последовательное имя вида #1, #2, #3 внутри вашего профиля.
Скопируйте новый ключ и сохраните его в надежном месте. Сообщение с plaintext-ключом бот удалит автоматически.

Используйте ключ как Bearer-токен с базовым URL https://api.nexus-hub.ru.

6. Имя ключа и лимит расходов¶

Удобно, когда у вас несколько проектов или нужно ограничить расход.

Откройте Ключи. По умолчанию бот показывает только активные и неистёкшие ключи.
При необходимости переключайтесь между фильтрами Активные, Все и Отозванные. Фильтр и страница сохранятся, если открыть карточку ключа и вернуться назад.
Нажмите на нужный ключ.
Выберите Изменить название, чтобы задать понятное имя.
Выберите один из вариантов лимита, чтобы задать или снять ограничение расходов.

Лимит ограничивает, сколько может потратить отдельный ключ; при достижении лимита ключ останавливается, пока вы не повысите лимит. Баланс профиля при этом остается общим для всех ключей.

7. Доступные модели для ключа¶

У каждого ключа можно отдельно ограничить, какие модели ему доступны.

Откройте Ключи и нажмите на нужный ключ.
Выберите Доступные модели.
На верхнем экране выберите один из готовых вариантов:
Доступны все — ключ видит все публичные модели;
Запретить все — ключ временно не сможет вызывать модели.
Ниже нажмите на нужное семейство моделей, например Семейство Claude, Семейство Gemini, Семейство DeepSeek, Семейство GLM или Семейство GPT / Codex.
На отдельном экране семейства:
можно включить всё семейство целиком;
можно включить или выключить отдельные публичные модели этого семейства.
Каждый выбор сохраняется сразу. Нажмите Назад, чтобы вернуться к списку семейств.

8. Списки разрешенных IP¶

Ключ можно ограничить так, чтобы он работал только с доверенных IP-адресов.

Откройте Ключи и нажмите на нужный ключ.
Выберите Список IP.
Добавьте или удалите адреса, которым разрешено использовать ключ.

Если список пустой, ключ работает с любого адреса.

9. Отзыв ключа¶

Откройте Ключи и нажмите на нужный ключ.
Выберите Отозвать.
Подтвердите.

Отозванный ключ сразу перестает работать. Отзывайте любой ключ, который больше не используете или который мог попасть в чужие руки.

10. История запросов и баланса¶

В главном меню выберите История.
Выберите период: 24ч, 7д, 30д, Всё время или Свои даты.
При выборе Свои даты отправьте начальную и конечную даты в формате ДД.ММ.ГГГГ (UTC).
Переключайтесь между вкладками Все, API и Баланс.

В шапке бот показывает сводку именно за выбранный период: общее число запросов, число ошибок, списанную сумму и входные/выходные токены только по тарифицированным запросам. На странице не более пяти событий; у каждого события есть раскрытая детализация. Время в таблице всегда отображается в UTC.

Для тарифицированных запросов детализация показывает компоненты расчёта в рублях и фактическое списание. Для старых записей, где подробная формула недоступна, бот показывает токены и фактическое списание с соответствующей пометкой.

Если Telegram-клиент или сервер не поддерживает rich-таблицу, бот автоматически переключится на обычный текстовый список с той же клавиатурой.

11. Обращение в поддержку¶

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

Для вопросов по пополнению создайте обращение и укажите данные транзакции. Если покупка была сделана без Nexus ID, сначала используйте одноразовый код активации из сообщения после оплаты. Не отправляйте полный API-ключ, prompts или полные тела запросов.

Черновик сохраняется на короткое время, поэтому возврат назад не стирает уже введённые данные, а перезапуск бота не начинает сценарий заново.

В разделе Мои обращения можно открыть карточку тикета и увидеть его статус, что происходит сейчас, время создания и обновления, контакт, число вложений, ваше сообщение и переписку с поддержкой. Статусы также могут показывать ожидание пользователя или внешнего сервиса. Кнопка Ответить открывает черновик, в который можно добавить текст, фото и документы. Отправка выполняется отдельной кнопкой Отправить, а по кнопке Открыть вложения бот заново пришлёт сохранённые файлы без повторной загрузки на сервер.

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

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

После решения откройте карточку обращения и выберите, помогло ли решение. Можно поставить необязательную оценку от 1 до 5. Если проблема осталась, нажмите Переоткрыть: проблема осталась, отправьте новый комментарий — обращение будет переоткрыто. Повторная отправка того же ответа не создаёт дубликат.

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

Если вопрос связан с ошибочным пополнением или переносом доступа, в описании обращения сразу укажите:

ваш текущий Nexus ID;
номер заказа / инвойса;
что именно произошло: создан новый аккаунт, не тот Nexus ID, не виден баланс, потерян старый Telegram.

12. Партнёрская программа¶

В меню Дополнительно откройте Партнёрская программа, чтобы подать заявку или проверить её статус. Форма заполняется по шагам: имя или название компании, контакт, ссылки на площадки, описание аудитории, средний охват, формат продвижения, юрисдикция выплаты и необязательный комментарий. Чтобы вернуться к предыдущему шагу или выйти из формы, используйте кнопку Назад.

Заявку можно сохранить как черновик, отправить на рассмотрение и отозвать до завершения проверки. После отправки бот показывает один из статусов: Черновик, Отправлена, На рассмотрении, Одобрена, Отклонена или Отозвана. При решении бот присылает отдельное уведомление; если заявку отклонили, в нём будет безопасное сообщение с дальнейшими действиями.

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

Партнёрская программа не гарантирует одобрение заявки. Доступные возможности и условия определяются после проверки; публичных уровней или рейтингов партнёров в интерфейсе нет.

13. Доступные модели и цены¶

В главном меню выберите Модели, чтобы увидеть доступные вам модели и цены в выбранной валюте отображения.

В этом же разделе доступны кнопки Новости, Статус и Документация, а Назад возвращает в главное меню. Кнопка Новости отображается, когда для бота настроена ссылка на канал.

Экран моделей разбит по отдельным страницам семейств GPT / Codex, Claude, Gemini, DeepSeek и GLM. На каждой странице семейства бот показывает одну общую таблицу с моделью, ID, ценами входа, выхода, кэша, записи кэша, фиксированной ценой за запрос и доступными эндпоинтами. Цены хранятся и рассчитываются в рублях, а в интерфейсе отображаются в выбранной валюте.

Если Telegram-клиент не поддерживает rich-таблицу, бот автоматически покажет упрощённый текстовый список цен вместо ошибки.

Список зависит от настроек вашего ключа, поэтому ориентируйтесь на ответ /v1/models именно для своего ключа, а не на чужой пример.

Будьте в курсе¶

Новости и анонсы публикуются в нашем канале.