Миграция данных в Telegram-CRM: пошаговый чеклист для службы поддержки

Перенос истории обращений, базы знаний и настроек SLA из старой системы в Telegram-CRM — задача, которая требует внимательного подхода. Разберём последовательность действий, которая минимизирует потери данных и сохранит метрики времени первого ответа (FRT) и времени разрешения (TTR) на приемлемом уровне.

Этап 1. Аудит исходной системы

Прежде чем трогать настройки Telegram Bot API, зафиксируйте текущее состояние. Без этого невозможно будет верифицировать корректность переноса.

Параметр	Что проверяем	Типичные проблемы
Объём данных	Количество тикетов, вложений, медиафайлов	Telegram API имеет ограничения на хранение медиа: файлы могут быть недоступны, если не скачаны своевременно
Структура обращений	Категории, теги, статусы (открыт/в работе/закрыт)	Несоответствие полей: в старой CRM могли быть кастомные статусы
Пользователи	Список агентов поддержки, супервизоров, роли	Разные права доступа: в топик-группах Telegram роли назначаются через бота
SLA-метрики	Текущие значения FRT, TTR, очередь обращений	При смене системы SLA обнуляются — нужно переносить исторические данные отдельно

Важно: Учитывайте особенности доступа к истории сообщений в Telegram. Для групп без форумного режима может потребоваться ручной экспорт через Telegram Desktop.

Этап 2. Подготовка Telegram-CRM к приёму данных

Настройка целевой среды включает три обязательных шага:

Создание топик-группы — включите форумный режим в настройках группы. Без него каждое обращение будет теряться в общем потоке сообщений.
Интеграция бота — подключите Telegram Bot API. Убедитесь, что бот имеет права администратора: `can_manage_topics`, `can_delete_messages`, `can_pin_messages`.
Настройка очереди обращений — определите, как тикеты распределяются между агентами. Для этого используются триггеры автоматизации: например, назначение на свободного оператора по принципу round-robin.

> Ограничение: Telegram не поддерживает вложенные категории в топиках. Если в старой системе была иерархия типа «Техподдержка → Биллинг → Возвраты», её придётся отобразить через теги или отдельные группы.

Этап 3. Экспорт данных из старой системы

Формат экспорта зависит от того, откуда вы переносите данные:

Zendesk, Freshdesk, Help Scout — стандартный CSV/JSON через API. Обратите внимание на вложения: их нужно скачать отдельно, так как Telegram хранит только превью.
Google Таблицы или Excel — экспорт в CSV, затем конвертация в JSON через скрипт. Поле `user_id` (Telegram ID клиента) должно быть заполнено — без него бот не сможет привязать тикет к конкретному диалогу.
Другая Telegram-CRM — используйте экспорт через того же бота. Если система не предоставляет API, остаётся ручной парсинг через Telegram Desktop.

Критический момент: Личные данные клиентов (ФИО, телефон, email) не должны передаваться в открытом виде. Используйте шифрование на этапе передачи — например, через SFTP или зашифрованный архив.

Этап 4. Импорт и маппинг полей

На этом этапе вы сопоставляете поля старой системы с атрибутами тикета в Telegram-CRM. Типичная таблица маппинга:

Поле в старой CRM	Поле в Telegram-CRM	Примечание
`ticket_id`	`topic_id`	Создаётся автоматически при импорте
`subject`	Заголовок топика	Длина ограничена 255 символами
`description`	Первое сообщение в топике	Есть ограничение по длине сообщения
`status`	Тег статуса	Например, `#открыт`, `#закрыт`
`assignee`	ID агента	Должен совпадать с Telegram ID
`created_at`	Дата создания топика	Фиксируется при импорте, не изменяется
`attachments`	Ссылки на файлы	Telegram не хранит файлы — используйте внешнее хранилище

Импорт выполняется через webhook-интеграцию: вы отправляете POST-запрос на URL бота с JSON-массивом тикетов. Бот создаёт топики и назначает их агентам. Для больших объёмов (более 1000 тикетов) разбивайте на пакеты по 50–100 запросов — учитывайте лимиты Telegram API на количество сообщений.

Этап 5. Перенос базы знаний и шаблонов ответов

База знаний (Knowledge Base) и canned response — это то, что экономит время первого ответа (FRT). Перенос включает:

Шаблоны ответов — экспорт в JSON, импорт через интерфейс Telegram-CRM. Для каждого шаблона укажите категорию (например, «Возврат средств») и переменные (`{имя_клиента}`, `{номер_заказа}`).
Статьи базы знаний — если Telegram-CRM поддерживает встроенный справочник, перенесите статьи с разметкой Markdown. Если нет — используйте внешнюю wiki со ссылками в тикетах.
Триггеры автоматизации — настройте правила, которые срабатывают при определённых событиях. Например: при создании тикета с тегом «Срочно» автоматически назначается супервизор.

> Совет из практики: Не переносите все шаблоны «как есть». Заодно пересмотрите их актуальность — часто часть заготовок не используется, но захламляет интерфейс.

Этап 6. Тестирование и верификация

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

Создайте тестовую топик-группу — дубликат рабочей, но с ограниченным доступом.
Запустите импорт 10–20 тикетов — проверьте корректность маппинга, отображение статусов, привязку к агентам.
Проверьте SLA-метрики — в тестовой группе создайте обращение и замерьте FRT. Если метрика не соответствует настройкам, проверьте триггеры автоматизации.
Протестируйте эскалацию обращения — убедитесь, что при превышении TTR тикет переходит к супервизору.

Чеклист для верификации:

Все тикеты отображаются в очереди обращений.
Агенты видят только свои назначенные тикеты (проверьте права доступа).
Шаблоны ответов подставляются корректно.
База знаний доступна по ссылкам из тикетов.
Вложения открываются (если используются внешние хранилища).

Этап 7. Переключение и мониторинг

После успешного тестирования выполните переключение:

Остановите приём новых обращений в старой системе (например, отключите бота или измените автоответчик).
Запустите финальный импорт — перенесите тикеты, созданные после тестового прогона.
Активируйте Telegram-CRM — включите бота в рабочей топик-группе.
Мониторьте первые 24 часа — следите за очередью обращений, временем первого ответа и количеством нераспределённых тикетов.

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

Заключение: что важно запомнить

Миграция данных в Telegram-CRM — это не просто копирование записей. Это перестройка процессов: от структуры топик-групп до логики эскалации. Главные риски — потеря истории обращений и нарушение SLA из-за неправильной настройки очередей.

Рекомендация: Начните с переноса последних 30 дней активных тикетов. Остальную историю оставьте в архиве старой системы — к ней можно обращаться по запросу. Это сократит время миграции и снизит нагрузку на Telegram API.

Подробнее о настройке топик-групп и триггеров автоматизации читайте в статьях: