Диагностика неисправностей распределения сессий Telegram: руководство по исправлению проблем с неназначенными новыми сессиями и недоставкой сообщений агентам

Распределение сессий — одна из ключевых функций B2B SaaS-системы поддержки клиентов. Она определяет, будет ли новый пользователь, вошедший в Telegram Bot, своевременно назначен доступному агенту. Однако многие команды при настройке TG-Staff сталкиваются с проблемами: «новые сессии остаются без ответа», «агент онлайн, но не получает сообщения», «сессия постоянно не назначена».

Эта статья — руководство по диагностике неисправностей распределения сессий для руководителей операционных и клиентских команд. Мы начнем с самых распространенных симптомов, шаг за шагом разберем логику конфигурации и предоставим печатный чек-лист для поиска неисправностей. Если вы используете Telegram Bot для поддержки клиентов или управления сообществом, эта статья поможет быстро локализовать проблему и восстановить нормальную работу системы.

Обзор распространенных симптомов неисправностей распределения сессий

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

• Новая сессия никогда не назначается ни одному агенту: после входа пользователя в Bot агенты не видят новую сессию, или сессия остается в статусе «не назначена».
• Агент онлайн, но не получает уведомления о новой сессии: агент вошел в веб-портал, статус отображается как «онлайн», но новая сессия не появляется, требуется ручное обновление.
• Потеря или задержка сообщений: агент ответил на сообщение, но пользователь его не получил, или сообщение пользователя не отображается в окне сессии.

Эта статья в основном сосредоточена на первых двух сценариях. Если вы столкнулись с задержкой или потерей сообщений, сначала проверьте действительность Bot Token, стабильность сети и отсутствие срабатывания правил модерации контента (профессиональная версия).

Шаг 1: Проверка статуса онлайн агента и входа в учетную запись

Это самая часто игнорируемая причина неисправностей. Многие команды считают, что «агент вошел в Telegram» означает статус онлайн, но в TG-Staff **агент должен войти в веб-портал (https://app.tg-staff.com/）并保持会话页面打开**，才能接收新会话。

Шаги по устранению:

1. Убедитесь, что аккаунт оператора вошел в веб-портал (проверьте, отображается ли статус онлайн на аватаре в правом верхнем углу).
2. Проверьте, разрешает ли браузер TG-Staff отправлять уведомления (Chrome: Настройки → Конфиденциальность и безопасность → Настройки сайтов → Уведомления, убедитесь, что app.tg-staff.com не заблокирован).
3. Попросите оператора вручную обновить страницу чатов: нажмите F5 или кнопку обновления браузера, подождите 5 секунд и проверьте, появился ли новый чат.
4. Если оператор долго бездействовал, сессия могла истечь. Выйдите из аккаунта и войдите снова, затем протестируйте один раз.

Распространенное заблуждение: Оператор вошел в TG-Staff Bot на телефоне (например, @tgstaff_robot) и думает, что так сможет получать чаты. На самом деле оператор должен использовать веб-портал для обслуживания пользователей.

Шаг 2: Проверьте правильность настройки правил распределения

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

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

Режим последовательного распределения: порядок операторов и логика опроса

• Последовательное распределение — режим по умолчанию. Система опрашивает операторов в порядке их списка и назначает чат следующему доступному онлайн-оператору.
• Если оператор офлайн, система пропускает его и переходит к следующему.
• Ключевой момент: Если все операторы офлайн, новый чат остается в статусе «Не назначен», пока кто-то не выйдет онлайн и не возьмет его вручную, или система не перераспределит его.

Пример: В проекте 3 оператора (A, B, C) в порядке A → B → C. При новом чате система сначала проверяет, онлайн ли A: если да, назначает; если нет, проверяет B и т. д. Если A, B, C все офлайн, назначения не происходит.

Режим «Сначала онлайн»: механизм возврата при полном офлайне

• Режим «Сначала онлайн» приоритетно назначает чаты операторам, которые сейчас онлайн (не в фиксированном порядке, а случайным образом или по нагрузке).
• Когда все операторы офлайн, система возвращается к логике последовательного распределения. Это означает, что если все операторы офлайн, новый чат также остается в статусе «Не назначен».
• Рекомендация: Если в вашей команде несколько операторов и некоторые из них не всегда онлайн, используйте режим «Сначала онлайн», чтобы онлайн-операторы своевременно получали чаты.

Шаги по устранению:

1. Перейдите в консоль TG-Staff → Настройки проекта → Правила распределения чатов.
2. Убедитесь, что выбран ожидаемый режим (последовательное vs сначала онлайн).
3. Проверьте, не пуст ли список операторов — если в списке никого нет, то никто не сможет принять чат.
4. Если используется диапазон «Назначенные операторы», убедитесь, что все целевые операторы добавлены (см. Шаг 3).

Шаг 3: Проверьте настройки диапазона операторов проекта

Это очень скрытая точка настройки. В настройках проекта TG-Staff есть опция «Диапазон операторов», которая делится на:

• Все операторы: Все операторы проекта могут получать чаты этого бота.
• Назначенные операторы: Только выбранные операторы могут получать чаты.

Если вы выбрали «Назначенные операторы», но забыли добавить целевого оператора в список, то даже если он онлайн, он не получит новый чат.

Шаги по устранению:

1. Перейдите в Настройки проекта → Диапазон операторов.
2. Убедитесь, что выбрано «Все операторы» или «Назначенные операторы».
3. Если выбрано «Назначенные операторы», проверьте, содержит ли список все необходимые аккаунты операторов.
4. Если оператора нет в списке, нажмите «Добавить оператора», чтобы добавить его, затем сохраните.

Шаг 4: Проверка связи между дистрибьюторской ссылкой и ботом

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

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

Шаги проверки:

1. В консоли TG-Staff → Управление дистрибьюторскими ссылками найдите нужную ссылку.
2. Проверьте, действителен ли связанный с этой ссылкой токен бота — если токен был сброшен или бот удалён, ссылка станет недействительной.
3. Убедитесь, что срок действия ссылки не истёк (дистрибьюторские ссылки могут иметь срок действия).
4. Откройте дистрибьюторскую ссылку в режиме инкогнито и проверьте, корректно ли выполняется перенаправление (должно вести на страницу диалога с вашим Telegram-ботом).
5. Если после перенаправления бот не отвечает, проверьте, запущен ли бот (отправьте боту в Telegram /start для теста).

Быстрый способ проверки: Откройте дистрибьюторскую ссылку в окне инкогнито Chrome и посмотрите, на какой URL ведёт финальное перенаправление в адресной строке. Если перенаправление идёт на неправильного бота или показывает 404, значит, ссылка настроена неверно, и её нужно пересоздать.

Шаг 5: Использование системных логов и профилей пользователей для дополнительной диагностики

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

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

Пользователи стандартной версии: Если расширенные статистические функции недоступны, вы можете напрямую связаться с ботом поддержки TG-Staff (@tgstaff_robot), указав ID вашего проекта и описание проблемы. Команда техподдержки поможет провести диагностику.

Контрольный список для устранения неполадок с распределением сессий (краткая версия)

Ниже представлен печатный контрольный список для быстрой проверки каждого пункта:

№	Пункт проверки	Статус (✓ / ✗)
1	Оператор вошёл в веб-портал (https://app.tg-staff.com/）？	☐
2	Статус оператора отображается как “Онлайн”?	☐
3	Браузер разрешает TG-Staff отправлять уведомления?	☐
4	Правило распределения не пустое (в настройках проекта есть хотя бы один оператор)?	☐
5	Режим правила распределения корректен (поочередное распределение или приоритет онлайн)?	☐
6	Область обслуживания проекта включает этого оператора (если выбрано “Конкретный оператор”)?	☐
7	Токен бота действителен и бот работает?	☐
8	Дистрибьюторская ссылка не истекла и указывает на правильного бота?	☐
9	Оператор случайно не отметил сессию как “Завершена”, что мешает получению новых сессий?	☐
10	Пробовали перезагрузить страницу сессий или выйти и войти снова?	☐

Если все 10 пунктов пройдены, но проблема остаётся, рекомендуем обратиться в службу поддержки TG-Staff или ознакомиться с официальной документацией (https://docs.tg-staff.com/）获取更多配置细节。

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

Вопрос: Новая сессия отображается как “Не распределена”, хотя оператор онлайн. Что делать?

Ответ: Сначала убедитесь, что оператор вошёл в веб-портал TG-Staff (а не только в Telegram). Затем проверьте, включает ли область обслуживания проекта этого оператора, и настроено ли правило распределения на “Конкретный оператор” без его добавления. Наконец, попробуйте перезагрузить страницу сессий или выйти и войти снова.

Вопрос: Когда оператор офлайн, кому автоматически распределяются новые сессии?

Ответ: Это зависит от правила распределения. В режиме “Поочередное распределение” система пропускает офлайн-операторов и назначает сессию следующему доступному онлайн-оператору. Если все операторы офлайн, новые сессии остаются в статусе “Не распределены” до тех пор, пока оператор не войдёт в систему и не возьмёт их вручную или не произойдёт повторное распределение. В режиме “Приоритет онлайн” также используется логика поочередного распределения.

Вопрос: Дистрибьюторская ссылка не работает. Как проверить?

Ответ: Проверьте, использует ли дистрибьюторская ссылка правильный токен бота и работает ли сам бот. Попробуйте открыть ссылку в окне инкогнито и посмотреть, на какой URL ведёт перенаправление. Если срок действия ссылки истёк, пересоздайте её в консоли TG-Staff.

Вопрос: Почему оператор не получает уведомления о новых сессиях (нет всплывающего окна/звука)?

Ответ: Проверьте, разрешает ли браузер отправку уведомлений от веб-портала TG-Staff (настройки Chrome/Safari). Кроме того, оператор должен держать страницу сессий открытой (не сворачивать и не переключаться на другие вкладки), иначе браузер может блокировать уведомления.

Вопрос: Поддерживает ли бесплатная пробная версия распределение сессий?

Ответ: Да. В период бесплатного пробного использования функция распределения сессий полностью доступна, включая оба режима: поочередное распределение и приоритет онлайн. После окончания пробного периода для продолжения использования потребуется подписка на стандартную или профессиональную версию (подробнее о ценах см. на странице тарифов).

---

Попробуйте стабильное распределение сессий прямо сейчас: Зарегистрируйтесь в TG-Staff для бесплатного 3-дневного пробного периода без кредитной карты и протестируйте все настройки на реальном проекте. Если возникнут проблемы, которые невозможно решить, свяжитесь с @tgstaff_robot для получения техподдержки. Больше деталей по настройке — в официальной документации (https://docs.tg-staff.com/）。