Настройка автоматических уведомлений о назначении

Автоматические уведомления о назначении — критический элемент SLA-метрик в Telegram-CRM. Без них агенты поддержки рискуют пропустить обращения в топик-группах, а время первого ответа (FRT) может выйти за рамки соглашения об уровне обслуживания. В Telegram Bot API существуют ограничения: для сообщений в группах действует лимит 30 сообщений в секунду, а также 20 сообщений в минуту на бота. Это напрямую влияет на архитектуру уведомлений.

Принцип работы уведомлений о назначении

Система уведомлений в Telegram-CRM строится на триггерах автоматизации. Когда обращение попадает в очередь и система назначает его агенту (вручную или по правилам распределения), срабатывает триггер-скрипт. Он отправляет сообщение в один из каналов:

• Личный чат агента — самый надёжный способ, но требует предварительной авторизации пользователя через бота.
• Топик-группа — уведомление приходит в служебный топик (например, «Уведомления»), но агент может не заметить его в потоке.
• Внешняя система — через webhook-интеграцию в корпоративный мессенджер или email.

Ограничения Telegram API для уведомлений

Шаг 1: Выбор канала уведомлений

Первый этап настройки — определить, куда система будет отправлять уведомления. Варианты:

1. Личный чат агента — используйте `/start` для инициализации бота. Без этого шага бот не может отправлять сообщения пользователю.
2. Служебный топик в группе — создайте отдельную тему (например, «Назначения») в топик-группе. Настройте бота на отправку только в этот топик.
3. Групповой чат без тем — наименее эффективный вариант: уведомления смешиваются с рабочими сообщениями.

Техническое примечание: Для отправки в личный чат агента бот должен иметь `chat_id` пользователя. Получить его можно только после того, как пользователь отправил боту хотя бы одно сообщение. Решение — принудительная авторизация всех агентов через бота при старте смены.

Шаг 2: Настройка триггеров назначения

Триггеры автоматизации определяют, при каких условиях отправляется уведомление. Базовые сценарии:

1. Назначение агента на тикет — срабатывает при ручном или автоматическом распределении.
2. Смена ответственного — при эскалации обращения или передаче другому агенту.
3. Истечение SLA — уведомление, если FRT или TTR превышает установленный лимит.

Пример конфигурации триггера: ``` Условие: Тикет назначен агенту {agent_name} Действие: Отправить сообщение в личный чат агента Шаблон: «Новое обращение #{ticket_id} от {client_name}. Тема: {ticket_subject}. Время на первый ответ: {sla_frt} мин. Ссылка: {ticket_url}» ```

Шаг 3: Формирование шаблонов уведомлений

Шаблоны ответов (canned responses) для уведомлений должны быть лаконичными. Telegram не поддерживает HTML-форматирование в полном объёме — доступны только жирный, курсив, `моноширинный`, ~~зачёркнутый~~ и ссылки вида `tg://user?id=12345`.

Рекомендуемая структура шаблона:

• Заголовок: «Новое обращение #ID» (жирный)
• Клиент: имя или ID (если имя скрыто)
• Тема: краткое описание из первого сообщения
• SLA: время на первый ответ и время разрешения
• Ссылка: прямая ссылка на топик в формате `https://t.me/c/group_id/topic_id`

Пример: ``` Новое обращение #1423 Клиент: Иван Петров Тема: Проблема с оплатой заказа №5678 SLA FRT: 15 мин, TTR: 60 мин Открыть тикет ```

Шаг 4: Настройка очередей и приоритетов

Уведомления должны учитывать приоритет обращения. В системе очередей обращений можно настроить:

1. Высокий приоритет — уведомление отправляется всем свободным агентам в личный чат + в служебный топик с пометкой `❗️`.
2. Средний приоритет — уведомление только назначенному агенту.
3. Низкий приоритет — уведомление без звукового сигнала (через `disable_notification: true` в Telegram Bot API).

Важно: Telegram Bot API поддерживает параметр `disable_notification`. Для низкоприоритетных обращений установите его в `true`, чтобы не отвлекать агентов от срочных задач.

Шаг 5: Тестирование и мониторинг

После настройки выполните тестовый сценарий:

1. Создайте тестовый тикет через бота или интерфейс.
2. Назначьте его агенту.
3. Проверьте получение уведомления в выбранном канале.
4. Измерьте задержку от назначения до получения.

Метрики для мониторинга:

• Процент доставленных уведомлений — если менее 95%, проверьте лимиты Telegram API.
• Средняя задержка доставки — при пиковой нагрузке (более 30 назначений в секунду) возможны задержки.
• Количество ошибок — ошибка 429 (Too Many Requests) указывает на превышение лимитов.

Шаг 6: Интеграция с базой знаний

Для ускорения первого ответа настройте автоматическую отправку ссылки на статью из базы знаний (Knowledge Base) вместе с уведомлением о назначении. Это позволяет агенту сразу видеть возможное решение.

Настройка:

1. В триггер назначения добавьте условие: если тема тикета совпадает с ключевыми словами из базы знаний.
2. В шаблон уведомления добавьте строку: `Рекомендуемая статья: {kb_article_url}`.
3. Убедитесь, что ссылка ведёт на конкретную статью, а не на общий раздел.

Ограничения и риски

1. Telegram не гарантирует доставку сообщений — при перегрузке серверов Telegram сообщения могут задерживаться или теряться. Для критических уведомлений используйте webhook-интеграцию в email или SMS.
2. Лимит на количество ботов в группе — в одной группе может быть не более 20 ботов. Если у вас несколько интеграций, планируйте их количество.
3. Приватность данных — не включайте в уведомления персональные данные клиентов (номера телефонов, адреса, данные карт). Telegram не шифрует сообщения в группах.

Автоматические уведомления о назначении — базовая, но критическая функция Telegram-CRM. Правильная настройка каналов, триггеров и шаблонов позволяет улучшить показатели SLA за счёт своевременного оповещения агентов. Однако учитывайте ограничения Telegram API: при пиковых нагрузках (более 30 назначений в секунду) используйте внешние системы уведомлений через webhook.

Для дальнейшей оптимизации ознакомьтесь с настройкой очередей обращений для разных языков и интеграцией с базой знаний для автоматических ответов.