Руководство по настройке диверсионных ссылок (магических ссылок) TG-Staff: полные шаги по созданию, копированию и размещению

В сценариях B2B SaaS поддержки клиентов Telegram Bot часто используется для обработки запросов пользователей. Однако отслеживание канала, с которого пользователь пришел в бота, всегда было проблемой — Telegram не предоставляет нативной атрибуции источников, и операторам сложно различать трафик от рекламы, социальных сетей или сообществ. Диверсионные ссылки TG-Staff (магические ссылки) созданы именно для решения этой задачи. В этой статье мы подробно разберем от определения, сценариев использования, настройки до размещения, как с помощью официальных коротких ссылок домена https://app.tg-staff.com/{code} добиться точной атрибуции трафика и маршрутизации сессий поддержки.

Что такое диверсионная ссылка (магическая ссылка) TG-Staff?

Диверсионная ссылка (Diversion Link, также называемая магической ссылкой) — это официальная короткая ссылка домена, предоставляемая TG-Staff, в формате https://app.tg-staff.com/{code}. Ее основной рабочий процесс:

1. Пользователь нажимает на короткую ссылку → 2. Система захватывает IP-адрес посетителя, информацию о браузере (User-Agent) и параметры отслеживания, добавленные в URL → 3. Автоматически перенаправляет на указанного Telegram-бота, и пользователь сразу входит в диалог.

В отличие от обычных ссылок на бота (например, t.me/YourBot?start=xxx), диверсионная ссылка перехватывает и записывает информацию об источнике посетителя перед перенаправлением. Эти данные сохраняются в профиле пользователя TG-Staff для последующего анализа. Эта функция доступна только в тарифах Standard и выше (также доступна для ознакомления в бесплатном пробном периоде).

Зачем нужны диверсионные ссылки? — Сценарии использования и ключевая ценность

Диверсионные ссылки решают конкретную проблему: Telegram Bot сам по себе не может определить, из какого канала пришел пользователь. Вы можете одновременно запускать Google Ads, рекламу в Facebook, продвижение через KOL и ссылки в сообществах, но все пользователи, попадая в бот, видят одно и то же приветствие, и вы не можете адаптировать взаимодействие в зависимости от источника. Ниже приведены три типичных сценария.

Сценарий 1: Атрибуция рекламных кампаний

Предположим, вы управляете кросс-граничным SaaS-продуктом и одновременно запускаете рекламу в Google Ads, Facebook Ads и Twitter. Используя диверсионные ссылки, вы можете создать отдельные короткие ссылки для каждого канала (например, https://app.tg-staff.com/abc для Google Ads, https://app.tg-staff.com/def для Facebook Ads). Когда пользователь нажимает на объявление и переходит в бот, TG-Staff записывает в его профиль источник канала, что позволяет оценивать конверсию по каждому каналу и оптимизировать распределение рекламного бюджета.

Сценарий 2: Отслеживание многоканального взаимодействия

Помимо платной рекламы, вы можете управлять несколькими сообществами в Telegram, привлекать KOL или публиковать посты в разных соцсетях. С помощью диверсионных ссылок вы можете добавлять пользовательские параметры в конец URL (например, ?source=telegram-group-a, ?source=kol-john), чтобы различать источники пользователей из разных сообществ. Эти параметры будут захвачены вместе с запросом и отображены в поле «Источник» в профиле пользователя.

Сценарий 3: Распределение нагрузки в часы пик

В сочетании с правилами распределения сессий TG-Staff (поочередное распределение / приоритет онлайн) диверсионные ссылки могут служить буфером в часы пик. Например, вы можете встроить диверсионную ссылку в текст рекламы; когда одновременно поступает много пользователей, система автоматически распределяет их по правилам между доступными операторами, не допуская перегрузки одного оператора. Кроме того, благодаря записи источника оператор сразу знает, из какой кампании пришел пользователь, и может предоставить более точное обслуживание.

Предварительные условия: проверка тарифа и подготовка прав

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

• Требования к тарифу: Ваш аккаунт TG-Staff должен быть на тарифе Standard или Professional (в пробный период также можно создавать и использовать диверсионные ссылки; после окончания пробного периода необходимо обновиться до тарифа Standard ($8.99/мес) для продолжения использования. Годовая подписка выгоднее, подробнее на странице тарифов).
• Подключение проекта бота: У вас должен быть хотя бы один проект Telegram Bot, подключенный к TG-Staff (то есть выполнена привязка Bot Token).
• Права оператора: Аккаунт оператора, используемый для настройки диверсионных ссылок, должен иметь права «Управление проектами» или «Диверсионные ссылки». Если вы не уверены, свяжитесь с администратором проекта для настройки прав в разделе «Управление операторами».

Пошаговое руководство: создание и копирование дистрибьюторских ссылок

Ниже приведен полный процесс настройки. Рекомендуется выполнять действия по порядку.

Шаг 1: Переход на страницу управления дистрибьюторскими ссылками

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

Шаг 2: Создание новой дистрибьюторской ссылки

Нажмите кнопку «Создать ссылку» в правом верхнем углу страницы. В появившейся форме введите идентификационное имя. Рекомендуется использовать осмысленные имена, например «Весенняя распродажа 2025», «Реклама Google Ads» или «Продвижение KOL Чжан Сань», для удобства последующего управления. Система автоматически сгенерирует уникальную строку code (например, abc123) и объединит ее в полную короткую ссылку https://app.tg-staff.com/abc123.

• Подсказка: имя используется только для внутреннего управления и не отображается внешне. code является уникальным идентификатором ссылки, его нельзя изменить после создания, но вы можете в любое время удалить и создать новую ссылку.
• Необязательное действие: в некоторых версиях можно указать целевой Bot-проект, на который будет вести ссылка (если у учетной записи несколько проектов). Выберите правильный проект, чтобы обеспечить корректный переход.

Шаг 3: Копирование ссылки и добавление параметров отслеживания

После создания нажмите кнопку «Копировать» рядом с ссылкой, чтобы получить полную короткую ссылку. Затем вы можете добавить в конец пользовательские параметры URL для дальнейшей дифференциации источников трафика. Рекомендуется использовать стандартный формат UTM-параметров, например:

https://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale

или более простые пользовательские параметры:

https://app.tg-staff.com/abc123?source=google-ads&campaign=spring

Требования к формату параметров: допускаются только буквы, цифры, символ подчеркивания (_) и дефис (-). Если значение параметра содержит китайские символы или специальные знаки (например, пробел, &), предварительно выполните URL-кодирование (encodeURIComponent), иначе может произойти сбой перехода или потеря данных атрибуции.

Практика запуска: как использовать направляющие ссылки в рекламе и соцсетях

После создания направляющей ссылки наступает этап запуска. Ниже приведены лучшие практики для разных каналов.

Запуск в рекламных платформах

• Google Ads: в поле «Конечный URL» кампании вставьте направляющую ссылку (с UTM-метками). Рекомендуется также настроить «Шаблон отслеживания» для передачи дополнительных параметров, таких как Click ID, но убедитесь, что конечный URL по-прежнему указывает на короткую ссылку TG-Staff.
• Meta Ads (Facebook/Instagram): в поле «Ссылка на сайт» вставьте направляющую ссылку. Meta автоматически добавит параметр fbclid, но вам всё равно потребуется вручную добавить utm_source=facebook для различения источников.
• Twitter Ads / LinkedIn Ads: аналогичные действия — вставьте направляющую ссылку в целевой URL объявления.

Запуск в соцсетях и сообществах

• Группы/каналы Telegram: отправляйте направляющую ссылку напрямую. Поскольку Telegram генерирует предпросмотр ссылки, рекомендуется в описании указать «Нажмите на ссылку, чтобы начать диалог с поддержкой».
• Посты Twitter / LinkedIn: встраивайте короткую ссылку в пост или используйте инструменты Bio Link (например, Linktree), указав направляющую ссылку как одну из целей перехода.
• Продвижение через KOL: создавайте отдельные направляющие ссылки для каждого KOL (или используйте разные UTM-метки) для удобного отслеживания результатов и оплаты.

Просмотр данных

Когда пользователь переходит по направляющей ссылке в бота, информация об источнике автоматически записывается в профиль пользователя TG-Staff. В разделе «Управление пользователями» вы можете просматривать IP-адрес, информацию о браузере и параметры URL (например, utm_source, source). Пользователи Pro-версии получают более детальные отчёты по анализу источников.

Часто задаваемые вопросы и устранение неполадок

При настройке могут возникнуть следующие проблемы; проверьте их по списку:

• Ссылка не перенаправляет: проверьте, онлайн ли бот (действителен ли токен бота, не приостановлен ли проект). Сама направляющая ссылка не зависит от статуса бота (она только перенаправляет), но если бот заблокирован или токен недействителен, пользователь не сможет начать диалог после перехода.
• Параметры не работают: убедитесь, что формат параметров корректен (без кириллицы, пробелов и спецсимволов) и они правильно закодированы. Откройте направляющую ссылку вручную в браузере и проверьте, отображаются ли параметры в адресной строке. Если нет — параметры не передаются.
• Агент не получает диалог: проверьте правильность настройки правил маршрутизации. Если используется режим «Сначала онлайн» и все агенты офлайн, система переключится на круговое распределение; если всё равно нет свободных агентов, убедитесь, что аккаунты агентов онлайн и имеют права на обработку этого проекта.
• Источник в профиле пользователя пуст: информация, захваченная направляющей ссылкой, записывается только при первом клике пользователя. Если пользователь нажимает повторно или заходит в бота другим способом, поле источника может быть перезаписано или остаться пустым. Рекомендуется создавать отдельные ссылки для каждой сессии пользователя.

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

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

Вопрос: Можно ли создать несколько направляющих ссылок в одном проекте?
Ответ: Да. TG-Staff не ограничивает количество направляющих ссылок в одном проекте; вы можете создавать отдельные ссылки для разных акций, каналов или временных периодов для удобного независимого отслеживания.

Вопрос: Поддерживает ли направляющая ссылка HTTPS? Безопасна ли она для конфиденциальности пользователей?
Ответ: Да, все направляющие ссылки используют принудительное HTTPS-шифрование. Собираемая информация (IP, браузер, параметры URL) используется только для атрибуции и не применяется в других целях, что соответствует общим требованиям защиты конфиденциальности.

Вопрос: Что произойдёт, если после перехода по направляющей ссылке в бота нет свободных агентов?
Ответ: Пользователь обычным образом попадёт в сценарий автоответов бота. Если у вас настроено правило маршрутизации «Сначала онлайн» и все агенты офлайн, система переключится на круговое распределение; если все агенты офлайн, диалог останется в очереди и будет назначен агенту, когда тот появится онлайн.

Вопрос: Есть ли различия в функциональности направляющих ссылок между стандартной и Pro-версиями?
Ответ: Базовые функции создания и запуска одинаковы. Pro-версия дополнительно позволяет просматривать более детальные данные об источнике в профиле пользователя, а также связывать направляющие ссылки с правилами внутреннего контроля (например, ограничивать конкретные ссылки только для определённых агентов).

---

Попробуйте направляющие ссылки TG-Staff прямо сейчас: перейдите на app.tg-staff.com, зарегистрируйтесь для бесплатного пробного периода и создайте свою первую «магическую» ссылку по шагам из этой статьи. Для более глубокого изучения продвинутых настроек (например, управление UTM-метками, привязка к внутреннему контролю) обратитесь к официальной документации. Если у вас возникнут вопросы в процессе настройки, свяжитесь с @tgstaff_robot для получения оперативной поддержки.