Как выгрузить данные из старого хелпдеска: обращения, статьи, контакты

Выгрузка — та половина миграции, которая целиком в ваших руках, и та, за которую большинство команд берётся слишком поздно. Чтобы начать, не нужно выбирать новый инструмент: полная проверенная выгрузка полезна, даже если вы никуда не уходите, — это ваш резервный экземпляр, ваша позиция на переговорах и доказательство того, чем вы на самом деле владеете.

Разбираем, что именно забирать из старого хелпдеска, каким путём вытаскивать каждый тип объектов и какие ловушки не видны до второй недели работы в новом инструменте.

Что можно (и нужно) выгрузить

Хелпдеск хранит больше типов данных, чем помнит средний администратор. Полный набор, который стоит забрать:

• Обращения и переписки — сообщения, их авторы, метки времени, статусы, исполнители и теги.
• Контакты и организации — карточки клиентов с пользовательскими полями и связи между ними.
• Статьи базы знаний — тексты, категории, флаги видимости и картинки внутри них.
• Макросы и сохранённые ответы — формулировки, к которым клиенты уже привыкли.
• Описания пользовательских полей — не только значения, но и типы с допустимыми вариантами.
• История CSAT — оценки и комментарии, если вы отчитываетесь по динамике удовлетворённости.
• Вложения — файлы, висящие на обращениях и статьях; в основную выгрузку они почти никогда не попадают.

Три пути выгрузки

Любой массовый хелпдеск даёт ту или иную комбинацию трёх маршрутов:

1. Штатная массовая выгрузка. Кнопка или задание по расписанию, которое отдаёт CSV, JSON или XML. Запускается быстрее всего, но часто спрятана за более дорогим тарифом, иногда ограничена по объёму и редко бывает полной: обычные пробелы — вложения и картинки статей.
2. API. Полный и скриптуемый, но с постраничной выдачей и ограничением частоты запросов. Этим путём добирают всё, что упустила массовая выгрузка, и только он надёжно вытаскивает вложения.
3. Сервис миграции. Принимающий вендор сам выгружает данные через API старого инструмента. Сил уходит меньше всего — только проследите, что сырую копию для своего архива вы тоже получаете или можете снять сами.

Разумный план сочетает первые два: массовая выгрузка закрывает лёгкие 90%, скрипты к API добирают остальное. Даже если миграцию делает принимающая сторона, свою копию выгрузки всё равно оставьте себе.

Обращения: формат важнее объёма

CSV расплющивает, JSON сохраняет. Выгрузка в CSV обычно даёт строку на обращение или на сообщение и теряет ветвление ответов, роли авторов и метаданные — то, ради чего история вообще нужна. Если есть выгрузка в JSON или путь через API, берите их: импорт на принимающей стороне всегда сможет упростить структуру, но выдумать её заново — нет.

Практические правила выгрузки обращений:

• Выгружайте партиями, от старых к новым, с оглядкой на ограничение частоты запросов. На крупном аккаунте полная история под квотами API тянется днями — поставьте её по расписанию, а не сидите рядом.
• Зафиксируйте, в каком часовом поясе приходят даты. Большинство API отдают UTC, а часть массовых выгрузок молча переводит метки времени в местное время. Сверьте несколько записей с интерфейсом, прежде чем доверять тысячам.
• Фильтруйте до выгрузки. Обращения, закрытые как спам и закрытые одним словом, раздувают задачу и засоряют поиск на новой стороне. Их ещё никто ни разу не искал.
• Заберите историю статусов, если это возможно. Отчёты по SLA и времени решения строятся на переходах между состояниями, а не на одном финальном статусе.

Контакты и организации

Контакты весят мало, поэтому к ним относятся небрежно — а потом квартал вычищают дубли. До выгрузки:

• Убедитесь, что адрес почты заполнен у тех карточек, которые вам важны: почти на любой принимающей стороне именно он служит ключом склейки дублей.
• Выгружайте пользовательские поля вместе с их описаниями, а не одни значения. Выпадающий список, приехавший свободным текстом, — это ущерб навсегда.
• Сохраните связи контактов с организациями — обычно они лежат в отдельной выгрузке или на отдельной ручке API.

База знаний: выгрузка со скрытыми зависимостями

Тексты статей выгружаются в HTML без проблем. А вот их зависимости — нет:

• Картинки обычно подгружаются по ссылке, а не вшиты внутрь: выгрузка ссылается на файлы в CDN старого вендора. Скачайте каждое такое изображение сейчас — эти адреса могут умереть вместе с закрытием аккаунта.
• Черновики и флаги видимости в части выгрузок теряются или схлопываются. Отметьте до переезда, какие статьи были только для своих, иначе рискуете опубликовать на весь мир регламент эскалаций.
• Дерево категорий часто выгружается отдельно от статей. Заберите структуру целиком, вместе с порядком сортировки.
• Ссылки между статьями ведут на старые адреса. Переписывать их вы будете при импорте, а список нужен уже сейчас.

Макросы, автоматизации и всё остальное

Макросы в большинстве инструментов выгружаются текстом — работа на полчаса. А правила автоматизации и маршрутизации обычно не выгружаются ни в каком пригодном виде: опишите их руками, человеческим языком, и отнеситесь к переписыванию как к шансу спроектировать заново, а не скопировать. Заодно выгрузите теги, историю CSAT и все представления, на которых держится ваша отчётность.

Ловушки, которые всплывают на второй неделе

• Ссылки на вложения с истекающим сроком. Выгрузка ссылается на адреса в хранилище, которые перестают открываться после закрытия аккаунта. Копируйте файлы, а не ссылки.
• Потолки выгрузки. Часть массовых заданий молча обрезается на лимите строк. Сверяйте количество: в выгрузке должно быть столько же обращений, сколько показывает интерфейс.
• Сопоставление агентов. Сообщения ссылаются на учётные записи агентов внутренними идентификаторами. Выгрузите заодно список агентов, иначе авторство превратится в ребус.
• Удалённые и архивные обращения. Одни маршруты их отдают, другие нет. Решите осознанно, что из этого вам нужно.
• Троттлинг посреди задания. Скрипт, не умеющий отступать при ограничении частоты запросов, падает в три часа ночи и оставляет неполную выгрузку, которая выглядит полной.

Проверьте выгрузку, прежде чем на неё положиться

Непроверенная выгрузка — это надежда, а не резервная копия. До того как объявить победу:

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

Пара слов о большой тройке

У Zendesk, Freshdesk и Intercom есть законные пути выгрузки — массовый экспорт и хорошо описанные API, — хотя доступность зависит от тарифа, а админский доступ нужен везде. Данные в заложниках не держит никто: трение возникает из-за полноты и форматов, а не из-за запретов. Заложите день на изучение особенностей своего инструмента и сначала загляните в документацию вендора по выгрузке — это первоисточник по тому, что входит именно в ваш тариф. Если параллельно выбираете, куда переезжать, наше сравнение с Zendesk разбирает путь миграции в обе стороны.

При чём здесь MoveDesk

Миграция «под ключ» в MoveDesk проделывает всю эту выгрузку из вашего старого аккаунта за вас — обращения, контакты, статьи, макросы и вложения из Zendesk, Intercom или Freshdesk, — и бесплатно на любом тарифе. Свою сырую копию выгрузки мы всё равно советуем оставить: это ваши данные, а вторая копия ничего не стоит.

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