Чек-лист миграции с onlyTG на TG-Staff в 2026: боты, агенты, сценарии и маршрутизация

Если ваша команда использует onlyTG для управления Telegram-поддержкой, но обнаружила, что его функционал для совместной работы агентов, маршрутизации диалогов или внутреннего контроля контента становится недостаточным, миграция на TG-Staff — достойное обновление. TG-Staff предлагает более полное управление агентами, визуальный редактор процессов и возможности маршрутизации диалогов, а также встроенные функции контроля контента и мониторинга адресов криптокошельков для Web3-команд.

Эта статья — практичный чек-лист миграции, который поможет вам плавно перейти с onlyTG на TG-Staff, избежав потери данных, простоев агентов или прерывания обслуживания пользователей.

Подготовка к миграции: проверка статуса подписки onlyTG и резервное копирование данных

Прежде чем приступить к TG-Staff, уделите 15 минут следующей подготовке — это самый важный и часто упускаемый этап миграции.

Экспорт токена бота и API-ключей из onlyTG

Токен бота — единственный ключ для подключения бота к платформе поддержки. Он понадобится вам при миграции на любую платформу.

1. Войдите в BotFather, найдите своего бота и используйте команду /mybots для входа в настройки бота.
2. Нажмите API Token или скопируйте строку токена. Если токен уже отображался в консоли onlyTG, сделайте скриншот для резервной копии.
3. Если в onlyTG настроены сторонние API (например, ключи Google Translate или DeepL), экспортируйте их тоже.

Важно: токен бота равнозначен паролю администратора бота, не разглашайте его публично. После завершения миграции вы сможете повторно ввести этот токен в TG-Staff для авторизации.

Резервное копирование шаблонов сообщений и правил сегментации пользователей

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

• Шаблоны сообщений: скопируйте весь текст автоматических ответов бота из onlyTG, включая логику условных ветвлений. Рекомендуется сохранять в виде скриншотов или Markdown-файлов.
• Правила сегментации пользователей: запишите все созданные метки и условия группировки (например, «активные пользователи», «VIP-клиенты»). В профессиональной версии TG-Staff поддерживаются профили пользователей и сегментация, и вы сможете воссоздать эти правила позже в консоли.

Шаг 1: Создание проекта в TG-Staff и авторизация бота

После завершения резервного копирования войдите в консоль TG-Staff, зарегистрируйтесь и начните 3-дневную бесплатную пробную версию.

Быстрая авторизация с помощью токена бота

1. В левом меню консоли нажмите «Проекты», затем «Создать проект».
2. Введите название проекта (рекомендуется использовать то же имя, что и у бота в onlyTG, для удобства команды).
3. В поле «Токен бота» вставьте токен, полученный от BotFather.
4. Нажмите «Авторизовать», и TG-Staff автоматически загрузит аватар, имя и описание бота.

Весь процесс занимает не более 1 минуты. Никаких дополнительных действий в BotFather не требуется — TG-Staff напрямую управляет Webhook-адресом бота.

Проверка статуса бота и обмена сообщениями

После авторизации в разделе «Детали проекта» консоли статус бота отобразится как «Онлайн». Рекомендуется немедленно провести тест отправки и получения сообщений:

1. Отправьте боту в Telegram сообщение (например, «Привет»).
2. В панели «Диалоги» TG-Staff должен появиться новый диалог.
3. Войдите в веб-портал как агент, ответьте на это сообщение и проверьте, получил ли его пользователь.

Если канал сообщений работает, значит, TG-Staff успешно принял управление ботом. В это время бот в onlyTG всё ещё работает, но рекомендуется как можно скорее отключить сервис бота в onlyTG, чтобы избежать одновременного ответа с двух платформ.

Шаг 2: Восстановление команды поддержки и настройка прав доступа

Система агентов в onlyTG обычно основана на группах Telegram или простом совместном использовании аккаунтов, тогда как TG-Staff предоставляет отдельные аккаунты агентов, права на уровне проектов и запись распределения диалогов.

Приглашение агентов и назначение отдельных аккаунтов

1. В консоли в разделе «Управление агентами» нажмите «Пригласить агента».
2. Введите email агента (каждому агенту нужен отдельный email для входа в веб-портал).
3. Настройте «Права проекта» для агента: можно указать, какие проекты видит агент и имеет ли он права на редактирование.
4. После получения письма-приглашения агент устанавливает пароль и может войти.

По сравнению с onlyTG, преимущества TG-Staff:

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

Сопоставление с ролями агентов onlyTG

Если в вашей команде onlyTG есть роли «Администратор», «Руководитель поддержки», «Обычный оператор», их можно настроить в TG-Staff через конфигурацию прав. Например, руководитель может видеть все диалоги, а обычный оператор — только назначенные ему.

Шаг 3: Миграция сценариев общения и правил распределения

Это самый трудоемкий этап миграции, но визуальный редактор командных потоков TG-Staff значительно снижает порог восстановления.

Визуальный командный поток: создание взаимодействия с ботом без кода

Редактор командных потоков TG-Staff использует перетаскиваемые узлы, вам не нужно писать код для построения логики автоматических ответов бота.

1. В консоли в разделе «Командные потоки» нажмите «Создать поток».
2. Перетащите узел «Приветственное сообщение» из панели узлов слева на холст и введите текст вашего приветствия из onlyTG.
3. Перетащите узел «Меню», настройте текст кнопок и логику переходов (например, «Посмотреть цены» → «Отправить карточку с ценами»).
4. Перетащите узел «Условное ветвление», чтобы направлять пользователей к разным ответам в зависимости от ключевых слов.

По сравнению с текстовой конфигурацией onlyTG, интерфейс перетаскивания TG-Staff более интуитивен, особенно для многошаговых взаимодействий (например, опросы, создание заявок). Вы можете скопировать шаблоны сообщений из onlyTG в соответствующие узлы.

Настройка распределения диалогов и ссылок для перенаправления

Распределение диалогов определяет, как сообщения пользователей назначаются агентам. TG-Staff предлагает два режима:

• Поочередное распределение (по умолчанию): новые диалоги последовательно назначаются агентам с правами, подходит для команд с постоянным количеством агентов.
• Приоритет онлайн: сначала назначает онлайн-агентам, если все офлайн, возвращается к поочередному распределению, подходит для команд с нефиксированным графиком.

В «Настройках проекта» → «Распределение диалогов» вы можете выбрать режим и указать, какие агенты участвуют в распределении.

Кроме того, ссылки для перенаправления (Diversion Link) в TG-Staff — это уникальный инструмент привлечения трафика. Вы можете создать короткую ссылку (например, https://app.tg-staff.com/abc123), при переходе по которой TG-Staff захватывает IP пользователя, информацию о браузере и параметры URL, а затем перенаправляет на вашего бота. Это очень полезно для атрибуции рекламы и отслеживания из нескольких каналов — в onlyTG обычно нет встроенного аналога.

Шаг 4: Миграция контроля контента и соблюдения требований (Профессиональная версия)

Если ваша команда работает в сфере Web3, криптовалют или финансов, контроль контента — это важная часть миграции, которую нельзя игнорировать. Встроенный модуль контроля контента в TG-Staff Professional позволяет точно отслеживать сообщения, отправляемые операторами, предотвращая случайную или несанкционированную отправку конфиденциальной информации.

Настройка мониторинга рискованных фраз и адресов кошельков

1. В консоли перейдите в раздел «Контроль контента» → «Рискованные фразы» и нажмите «Создать фразу».
2. Введите название фразы (например, «Черный список адресов кошельков»).
3. Добавьте рискованные ключевые слова: вы можете ввести полный адрес TRC20/ERC20/BTC или фрагмент адреса (например, T9yD14). TG-Staff поддерживает префиксное и точное совпадение.
4. Свяжите рискованную фразу с конкретным проектом и включите «Мониторинг исходящих сообщений оператора».
5. Установите действие при срабатывании: можно выбрать «Всплывающее окно с подтверждением» или «Заблокировать отправку».

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

Аудит и оповещения: просмотр записей о срабатываниях

Как только оператор инициирует срабатывание правила контроля, вы можете просмотреть подробные журналы в разделе «Контроль контента» → «Записи срабатываний», включая:

• Оператор, вызвавший срабатывание
• Соответствующая сессия
• Время срабатывания
• Совпавшее рискованное слово

Эти записи можно использовать для аудита соответствия, обучения сотрудников или разрешения споров. Рекомендуется после миграции сначала создать тестовое рискованное слово (например, test-risk), попросить оператора отправить сообщение, содержащее это слово, и проверить, срабатывает ли контроль корректно.

Шаг 5: Тестирование полного цикла и переключение на реальный трафик

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

После успешного тестирования выполните следующие действия для официального переключения:

1. Остановите службу Бота в onlyTG (или отзовите токен Бота).
2. В TG-Staff убедитесь, что все агенты вошли в систему и находятся в сети.
3. Сообщите команде поддержки: новая платформа запущена, старая платформа прекращает использование.
4. Обновите свои рекламные материалы и ссылки в соцсетях, указав новые ссылки распределения TG-Staff.

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

Вопрос: Могу ли я продолжать использовать Бота onlyTG после миграции на TG-Staff?

Ответ: Да. TG-Staff использует тот же токен Бота для управления, поэтому Бот onlyTG не перестанет работать сразу. Рекомендуется сначала завершить все тесты в TG-Staff, а затем остановить службу Бота onlyTG, чтобы избежать путаницы из-за одновременного ответа двух платформ.

Вопрос: Можно ли импортировать историю чатов пользователей из onlyTG в TG-Staff?

Ответ: В настоящее время TG-Staff не поддерживает прямой импорт истории чатов из onlyTG. После миграции новые сессии будут храниться в TG-Staff. Рекомендуется экспортировать важные диалоги из onlyTG в качестве резервной копии для последующего просмотра.

Вопрос: Повлияет ли процесс миграции на обычное использование Telegram пользователями?

Ответ: При правильном выполнении пользователи практически ничего не заметят. Вам нужно только авторизовать токен Бота в TG-Staff и настроить агентов; после отправки сообщения пользователем оно автоматически попадет в очередь сессий TG-Staff. Рекомендуется выполнять переключение в часы низкой нагрузки и заранее уведомить команду поддержки.

Вопрос: Чем отличается функция ссылок распределения TG-Staff от onlyTG?

Ответ: Ссылки распределения (Diversion Link) TG-Staff — это короткие ссылки на официальном домене, которые могут захватывать IP-адрес посетителя, информацию о браузере и параметры URL, что подходит для атрибуции рекламного трафика. В onlyTG, вероятно, нет подобных встроенных возможностей атрибуции. После миграции рекомендуется заново создать ссылки распределения и обновить рекламные материалы.

Вопрос: Поддерживает ли TG-Staff оплату криптовалютой?

Ответ: Да. Помимо оплаты кредитной картой через Stripe, TG-Staff принимает платежи в сети USDT (TRC20), что подходит для команд, предпочитающих криптовалюту. Вы можете выбрать способ оплаты USDT в разделе «Моя подписка» в консоли.

---

Миграция на TG-Staff — не сложный процесс. Если следовать вышеуказанному чек-листу, большинство команд смогут завершить переключение за 1–2 часа. Если у вас возникнут проблемы во время миграции, обратитесь к официальной документации по миграции или свяжитесь с Ботом поддержки для получения оперативной помощи.

Зарегистрируйтесь в TG-Staff прямо сейчас и начните 3-дневный бесплатный пробный период: https://app.tg-staff.com/