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

Переїзд на Respondo

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

Огляд#

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

Одноразовий імпорт

Дані копіюються один раз. Respondo не синхронізується назад зі старим хелпдеском і не тримає з ним живого з’єднання.

Ви обираєте, що переїжджає

Кожну категорію — статті, розмови, збережені відповіді, налаштування — можна ввімкнути або вимкнути. Статті можна навіть відбирати поштучно.

Чесний прогрес

Живий екран прогресу показує реальні лічильники по категоріях — імпортовано, оновлено, пропущено, з помилкою — і скасувати можна будь-якої миті.

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

Підтримувані джерела#

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

ДжерелоБаза знаньПовторно вживані відповіді
ZendeskСтатті Help CenterМакроси
IntercomСтаттіЗбережені відповіді (недоступно — див. обмеження нижче)
FreshdeskSolutionsЗаготовлені відповіді
Ваш старий хелпдеск — джерело міграції, а не канал. Після імпорту розмови живуть у своїх справжніх каналах (email, чат-віджет), і ваш старий інструмент більше не відіграє жодної ролі. Щоб продовжувати отримувати нові повідомлення, підключіть свої канали в Respondo — міграція цього за вас не робить.

Що імпортується#

Імпорт виконується в чотирьох незалежних категоріях. Які з них включити, ви обираєте на кроці Вибір майстра:

КатегоріяЧим це стає в Respondo
Статті бази знаньОпубліковані статті стають джерелом знань для вибраного вами AI-агента — агент одразу може відповідати на їх основі. Можна імпортувати все або відібрати окремі статті, з фільтром за мовою для багатомовних довідкових центрів.
Минулі розмовиТікети й розмови приходять в Inbox як вирішені розмови з повною історією повідомлень і контактами. З них також видобуваються якісні пари «питання-відповідь» як навчальні дані, щоб агент вчився того, як ваша команда відповідає насправді.
Макроси / збережені відповіді / заготовлені відповідіВаші повторно вживані відповіді стають збереженими відповідями (Налаштування → Макроси), які учасники команди можуть вставляти в будь-яку розмову.
Налаштування робочого просторуЧасовий пояс, розклади робочих годин (включно зі святами) і назва вашої компанії. Ніщо не застосовується наосліп — майстер показує порівняння кожного налаштування, і записуються лише ті зміни, які ви приймаєте.

Імпортовані розмови не запускають жодної автоматизації: ані відповідей бота, ані ескалацій, ані сповіщень. Вони тихо приходять як історія. Оскільки в старому хелпдеску їх вирішила людина, вони потрапляють у Вирішено командою, а не в Вирішено AI.

Потрібні облікові дані#

Кожному провайдеру потрібні 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 (ключ адміністратора імпортує найбільше)
Підключення джерела, запуск імпорту і його скасування вимагають дозволу керування каналами — за замовчуванням Owner та Admin або будь-яка власна роль з увімкненим дозволом «Канали». Учасники команди без нього все одно можуть відкрити майстер і спостерігати за прогресом запущеної міграції.

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

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

КрокЩо відбувається
1. ПідключенняВведіть облікові дані лише на читання. Respondo перевіряє їх і читає ваш робочий простір, щоб порахувати, що доступно для імпорту.
2. ВибірУвімкніть потрібні категорії, виберіть AI-агента, який має отримати знання, і за бажанням відберіть окремі статті.
3. Попередній переглядПерегляньте порівняння налаштувань робочого простору — кожна запропонована зміна показується поруч із вашим поточним значенням, і ви приймаєте їх поодинці.
4. ЗапускІмпорт виконується як фонове завдання з живим прогресом по категоріях. Можна покинути сторінку й повернутися — хаб показує запущену міграцію на картці її провайдера.

На робочий простір одночасно може виконуватися лише одна міграція. Запущений імпорт можна скасувати з екрана прогресу, а пізніше — запустити імпорт знову: уже імпортовані елементи розпізнаються й оновлюються або пропускаються замість дублювання.

Імпортовані розмови — нативні#

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

Коли початковий канал визначити неможливо, Respondo кладе розмову туди, де ви справді зможете її продовжити: якщо в контакту є придатна email-адреса, вона стає email-розмовою; інакше — розмовою віджета, якій для читання адреса не потрібна.

Можна спершу мігрувати, а канали підключити пізніше. Імпортовані розмови читаються одразу; якщо їхній канал (наприклад, email) ще не підключений, композер просто попросить підключити його перед відповіддю — а щойно ви це зробите, імпортовані розмови автоматично стають придатними для відповіді.

Обмеження#

Що можна імпортувати, обмежене тим, що відкриває публічний API кожного вендора. Майстер чесний щодо цього — категорія, яку джерело не може віддати, показується недоступною з причиною, замість тихого імпорту нічого:

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

Якщо запуск завершився з помилками в частині категорій, його статус повідомляється як частковий, і екран прогресу показує, яка категорія впала і чому. Можна усунути причину (наприклад, протермінований API-токен) і запустити імпорт знову.