Документация

Миграция в Respondo

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

Обзор#

Мастер миграции подключается к вашему текущему хелпдеску с учётными данными API только для чтения, показывает вам ровно то, что нашёл, даёт выбрать, что переносить, и затем импортирует всё в фоне, пока вы продолжаете работать. Когда он завершится, ваши статьи питают ИИ-агента, прошлые диалоги лежат в Инбоксе с полной историей, а сохранённые ответы готовы к использованию.

Разовый импорт

Данные копируются один раз. Respondo не синхронизируется обратно со старым хелпдеском и не держит с ним живое соединение.

Вы выбираете, что переносить

Каждую категорию — статьи, диалоги, сохранённые ответы, настройки — можно включить или выключить. Статьи можно выбирать даже поштучно.

Честный прогресс

Живой экран прогресса показывает реальные счётчики по категориям — импортировано, обновлено, пропущено, с ошибкой — и отменить можно в любой момент.

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

Поддерживаемые источники#

Respondo умеет импортировать из трёх хелпдесков. Каждый называет вещи немного по-своему — мастер всюду использует терминологию самого вендора:

ИсточникБаза знанийПереиспользуемые ответы
ZendeskСтатьи Help CenterМакросы
IntercomСтатьиСохранённые ответы (недоступно — см. ограничения ниже)
FreshdeskSolutionsШаблонные ответы
Ваш старый хелпдеск — источник миграции, а не канал. После импорта диалоги живут в своих настоящих каналах (email, чат-виджет), и ваш старый инструмент больше никакой роли не играет. Чтобы продолжать получать новые сообщения, подключите свои каналы в Respondo — миграция этого за вас не делает.

Что импортируется#

Импорт идёт по четырём независимым категориям. Какие включить, вы выбираете на шаге Выбор мастера:

КатегорияЧем это становится в Respondo
Статьи базы знанийОпубликованные статьи становятся источником знаний для выбранного вами ИИ-агента — агент может сразу отвечать по ним. Можно импортировать всё или выбрать отдельные статьи, с фильтром по языку для многоязычных справочных центров.
Прошлые диалогиТикеты и беседы попадают в Инбокс как решённые диалоги с полной историей сообщений и контактами. Из них также добываются качественные пары вопрос-ответ как обучающие данные, чтобы агент учился тому, как ваша команда отвечает на самом деле.
Макросы / сохранённые ответы / шаблонные ответыВаши переиспользуемые ответы становятся сохранёнными ответами (Настройки → Макросы), которые участники могут вставить в любой диалог.
Настройки рабочего пространстваЧасовой пояс, расписания рабочих часов (включая праздники) и название вашей компании. Ничего не применяется вслепую — мастер показывает дифф каждой настройки бок о бок, и записываются только принятые вами изменения.

Импортированные диалоги не запускают никакой автоматики: ни ответов бота, ни эскалаций, ни уведомлений. Они приходят тихо, как история. Поскольку в старом хелпдеске их решил человек, они попадают в Решено командой, а не в Решено ИИ.

Необходимые учётные данные#

Каждому провайдеру нужны учётные данные API только для чтения. Шаг «Подключение» мастера точно говорит, где их создать:

ИсточникВы вводитеГде взять
ZendeskПоддомен, email администратора и API-токенВ Zendesk: Admin → Apps and integrations → APIs → Zendesk API
IntercomAccess token и ваш регион данных (США, ЕС или Австралия)В Intercom Developer Hub: создайте внутреннее приложение в Your apps, затем скопируйте его Access Token из Authentication
FreshdeskДомен и API-ключВ Freshdesk: Profile settings → View API key (ключ администратора импортирует больше всего)
Подключение источника, запуск импорта и его отмена требуют разрешения управление каналами — по умолчанию это Владельцы и Администраторы либо любая пользовательская роль с включённым разрешением «Каналы». Участники без него всё равно могут открыть мастер и наблюдать за прогрессом идущей миграции.

Запуск мастера#

Откройте хаб миграции на /migrate или дойдите до него через Знания → Добавить источник → Переехать с хелпдеска. Выберите источник — и мастер проведёт вас через четыре шага:

ШагЧто происходит
1. ПодключениеВведите учётные данные только для чтения. Respondo проверит их и прочитает ваше рабочее пространство, чтобы посчитать, что доступно для импорта.
2. ВыборВключите нужные категории, выберите ИИ-агента, которому достанутся знания, и при желании отберите отдельные статьи.
3. ПредпросмотрПросмотрите дифф настроек рабочего пространства — каждое предложенное изменение показано напротив вашего текущего значения, и вы принимаете их по одному.
4. ЗапускИмпорт идёт фоновой задачей с живым прогрессом по категориям. Можно уйти со страницы и вернуться — хаб показывает идущую миграцию на карточке её провайдера.

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

Импортированные диалоги — нативные#

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

Когда исходный канал определить нельзя, Respondo кладёт диалог туда, где его реально можно продолжить: если у контакта есть пригодный email-адрес, он становится email-диалогом; иначе — диалогом виджета, которому адрес не нужен, чтобы оставаться читаемым.

Можно сначала мигрировать, а каналы подключить позже. Импортированные диалоги читаемы сразу; если их канал (например, email) ещё не подключён, композер просто предложит его подключить, прежде чем вы сможете ответить, — а как только подключите, импортированные диалоги автоматически станут отвечаемыми.

Ограничения#

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

  • Сохранённые ответы Intercom мигрировать нельзя — публичный API Intercom их не отдаёт.
  • Настройки Intercom переносят только часовой пояс рабочего пространства; API не отдаёт рабочие часы.
  • Очень длинные диалоги Intercom (больше примерно 500 частей) импортируются обрезанными — API возвращает не более 500 частей на диалог.
  • Zendesk и Freshdesk поддерживают все четыре категории: диалоги, базу знаний, переиспользуемые ответы и настройки.

Если запуск завершился с ошибками в части категорий, его статус отображается как частичный, а экран прогресса показывает, какая категория упала и почему. Можно устранить причину (например, истёкший API-токен) и запустить импорт снова.