Telegram Bot 会话卡住怎么办？从命令冲突到转人工分流的完整排查指南

运营 Telegram Bot 的团队常常遇到一个棘手问题：用户明明在 Bot 菜单里点了「转人工」，消息却石沉大海，或者用户卡在欢迎语循环里无法联系到坐席。这种 Telegram Bot 会话卡住 的现象，本质上是 Bot 自动回复流程与人工坐席分流链路之间出现了断点。

本文将从命令配置、分流规则、坐席状态、套餐限制四个维度，结合 TG-Staff 等客服工具的操作细节，提供可复现的排查步骤。无论你是刚接入 Bot 客服的新团队，还是遇到间歇性卡顿的老手，都可以按顺序检查。

为什么 Telegram Bot 会话会卡在流程里？

会话卡住通常不是单一原因导致的，而是多个环节的连锁反应。以下是三类最常见的根因：

• 命令冲突：Bot 内的自定义命令（如 /start、/menu）覆盖或拦截了转人工指令，导致用户无法进入坐席分配队列。
• 分流规则未生效：分流范围设置错误（如指定了未在线的坐席），或者分流链接未正确配置，用户从 Bot 直接进入后无法触发分流逻辑。
• 坐席离线或额度不足：坐席未登录 Web 控制台，或套餐坐席额度已耗尽，导致系统无法分配会话。

理解了这些根因，接下来按步骤逐一排查。

第一步：检查 Bot 命令是否与转人工指令冲突

常见命令冲突场景与解决

很多 Bot 运营者会在 BotFather 中注册大量命令，比如 /start、/help、/support、/pricing。如果 /support 被定义为返回一个菜单按钮（而不是触发转人工节点），用户点击后就会卡在菜单里。

典型冲突示例：

命令	错误配置	正确配置
/support	显示帮助菜单，无转人工按钮	连接到「转人工」节点
/help	返回静态文本	添加「联系客服」按钮
/start	仅显示欢迎语	欢迎语后提供转人工入口

解决建议：

• 在 BotFather 中删除或重命名可能冲突的命令，或者将转人工设为独立命令（如 /staff）。
• 如果使用 TG-Staff 的流程编辑器，确保「转人工」节点不会被其他菜单分支覆盖。

使用可视化流程编辑器检查命令路径

TG-Staff 的拖拽式流程编辑器可以直观查看每条命令的走向。操作步骤如下：

1. 登录 TG-Staff 控制台，进入目标项目的「流程编辑」页面。
2. 找到用户触发转人工的入口节点（通常是 /start 或 /support）。
3. 检查该节点的分支：是否有一个箭头指向「转人工」或「联系客服」节点？如果没有，添加一个按钮或关键词匹配条件指向它。
4. 保存并发布流程。

如果流程编辑器里根本没有转人工节点，说明用户永远无法被分配给坐席。这是最常见也最容易修复的问题。

第二步：确认会话分流规则是否生效

会话分流是决定用户消息能否到达坐席的核心机制。TG-Staff 提供两种分流模式：轮流分配 和 在线优先。两种模式都需要正确配置项目客服范围。

分流范围：指定客服 vs 全部客服

在 TG-Staff 的项目设置中，你可以选择分流的范围：

• 全部客服：项目内所有坐席都能接收该项目的会话。
• 指定客服：只有被选中的坐席才能接收会话。

卡住场景：如果你选择了「指定客服」，但指定的坐席全部离线或额度已用完，用户消息就会一直排队，不会自动分配给其他坐席。

解决：临时切换到「全部客服」，或确保指定客服中有至少一人保持在线登录状态。

分流链接是否被误用或未配置

分流链接（魔法链接） 是 TG-Staff 提供的短链（如 https://app.tg-staff.com/{code}），它的作用是：

• 捕获访客的 IP、浏览器信息与 URL 参数（用于广告归因）。
• 确保用户点击后进入 Bot 并触发分流规则。

如果用户直接从 Bot 内点击菜单按钮进入（而非通过分流链接），分流规则可能不会触发，导致会话卡在自动回复阶段。

检查清单：

• 确认广告或社交媒体上的链接使用的是 TG-Staff 分流链接，而非普通 Bot 链接。
• 在 TG-Staff 控制台的「分流链接」页面，检查链接是否正确关联到目标项目。
• 如果已经配置了分流链接，测试时从该链接进入 Bot，而不是直接打开 Bot。

第三步：验证坐席在线状态与坐席额度

很多团队以为坐席安装了 Telegram 就算在线，实际上坐席需登录 TG-Staff Web 控制台才能接单。

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

1. Войдите в консоль и перейдите на страницу «Управление операторами».
2. Посмотрите столбец «Статус онлайн» для каждого оператора: зеленый означает, что оператор вошел в веб-консоль и находится онлайн, серый — офлайн.
3. Проверьте «Лимит операторов»: исчерпан ли лимит операторов, поддерживаемый текущим тарифом? Если лимит исчерпан, новые операторы не смогут войти, а старые — принимать заказы.
4. Убедитесь, что операторы назначены на правильный проект: в настройках проекта проверьте «Диапазон обслуживания клиентов» и убедитесь, что оператор находится в списке.

Если оператор онлайн, но лимит показывает 0, необходимо обновить тариф или освободить одно место оператора.

Шаг 4: Проверка ограничений тарифа и прав доступа

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

Конкретные последствия:

• Бесплатный пробный период: автоматически истекает через 3 дня, после чего приостанавливаются такие функции, как ссылки для маршрутизации, маршрутизация сессий, массовая рассылка сообщений и т. д.
• Стандартная версия: поддерживает ссылки для маршрутизации, маршрутизацию сессий, агентов (в рамках лимита), но без контроля контента и профилирования пользователей.
• Профессиональная версия: включает контроль контента, неограниченный перевод/массовую рассылку, профилирование пользователей и т. д.

Если срок действия тарифа истек, все настройки сохраняются, но функции приостанавливаются. После продления они восстанавливаются немедленно. Поэтому, если у пользователя возникла заминка, сначала проверьте, активен ли тарифный план.

Шаг 5: Тестирование и мониторинг цепочки перевода на оператора

После выполнения вышеуказанных проверок рекомендуется провести сквозное тестирование.

Контрольный список для тестирования с имитацией пользователя

1. Подготовьте тестовый аккаунт: используйте неавторизованный аккаунт Telegram (или режим инкогнито в браузере).
2. Перейдите по ссылке для маршрутизации: нажмите на ссылку маршрутизации TG-Staff, чтобы перейти к боту.
3. Запустите перевод на оператора: отправьте сообщение «оператор», «поддержка» или нажмите кнопку меню.
4. Проверьте со стороны агента: войдите в консоль, просмотрите «Список сессий» на предмет появления новой сессии и получил ли агент уведомление.
5. Подтвердите запись о распределении: в «Истории сессий» просмотрите записи о распределении, чтобы убедиться, что сообщение было назначено конкретному агенту.

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

Использование контроля контента и журналов аудита для выявления аномалий

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

Действия:

• Перейдите в консоль «Контроль контента» → «Журналы аудита».
• Отфильтруйте временной диапазон и проверьте, не было ли сообщений агента с пометкой «Заблокировано для отправки» или «Отправлено после повторного подтверждения».
• Если обнаружены ложные срабатывания по рискованным словам, настройте группы рискованных слов или отключите соответствующие правила.

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

Вопрос: Пользователь застрял в меню бота, ни одна кнопка не реагирует. Что делать?
Ответ: Проверьте, не перекрывают ли команды бота ключевые слова для перевода на оператора, или не подключена ли ветка меню к узлу перевода на оператора. Используйте редактор процессов TG-Staff, чтобы просмотреть путь команд и убедиться, что кнопка «Перевод на оператора» или «Связаться с поддержкой» указывает на узел распределения агентов.

Вопрос: Мой агент явно онлайн, но почему он не получает сообщения от пользователя?
Ответ: Агент должен войти в веб-консоль TG-Staff (app.tg-staff.com) и находиться в статусе «онлайн»; только статуса в Telegram недостаточно. Также проверьте, не исчерпан ли лимит агентов и входит ли этот агент в область маршрутизации.

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

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

Вопрос: Как избежать того, чтобы пользователь застревал в приветственном сообщении из-за конфликта команд?
Ответ: В редакторе процессов установите «Перевод на оператора» как отдельную команду (например, /staff) и убедитесь, что на нее не влияют другие ветки меню. Также рекомендуется включить режим «Онлайн в первую очередь» в настройках маршрутизации сессий, чтобы сократить время ожидания пользователя.

---

Следующие шаги:

• Зарегистрируйтесь на бесплатный 3-дневный пробный период TG-Staff, чтобы опробовать ссылки для маршрутизации и редактор процессов.
• Ознакомьтесь с документацией TG-Staff для получения подробных инструкций по настройке маршрутизации и редактированию команд.
• Свяжитесь с ботом поддержки @tgstaff_robot для индивидуальной помощи в устранении неполадок.