Посібник з міграції

Імпорт історії розмов

Переходите з іншого інструмента для чатів чи служби підтримки? Експортуйте історію у CSV або будь-який інший файл, передайте його AI-асистенту, і він перенесе всі розмови в Sonny через наш MCP-сервер. Це працює з будь-яким інструментом, бо зіставлення полів виконує ваш AI.

Нічого не надсилається

Імпортовані розмови — це історія. Sonny не надсилає листів чи повідомлень вашим клієнтам, не сповіщає команду, не запускає вебхуки, не використовує AI-відповіді та правила для вхідних і не розсилає опитування про задоволеність. Розмови з’являються закритими й уже прочитаними, тож у вхідних лишається спокій.

Перш ніж почати

Sonny, підключений до AI-асистента
Додайте MCP-сервер Sonny до Claude, Cursor або іншого AI-застосунку. Посібник з MCP займе близько хвилини.
Експорт зі старого інструмента
Експорт ваших розмов і повідомлень у CSV, JSON або таблиці. Якщо старий інструмент зберігає файли як посилання, залиште ці стовпці: Sonny може їх завантажити.
Канал для імпорту
Імпортовані чати використовують вебсайт каналу, а імпортовані листи — його адресу ел. пошти. AI може показати список ваших каналів і запитати, який вибрати.

Крок за кроком

  1. 01

    Підключіть Sonny

    Підключіть MCP-сервер Sonny до AI-асистента й увійдіть у свій робочий простір. Якщо ви підключалися раніше, підключіться знову, щоб AI побачив новий інструмент імпорту.

  2. 02

    Передайте експорт

    Прикріпіть файл або вкажіть AI, де він лежить, і скажіть, у який канал імпортувати.

  3. 03

    Попросіть зробити імпорт

    Скористайтеся запитом нижче як основою. AI прочитає файл, зіставить дані з форматом Sonny й надішле їх пакетами.

  4. 04

    Перевірте результат

    AI повідомить, що імпортовано, і про можливі проблеми. Відкрийте в Sonny кілька розмов, щоб переконатися, що все виглядає правильно, а потім дозвольте закінчити решту.

Приклад запиту

Змініть назви стовпців відповідно до вашого файлу.

prompt
Імпортуй розмови з export.csv у мій канал Sonny "Support" за допомогою інструмента import_conversations.
Кожен рядок — це одне повідомлення. Групуй рядки за ticket_id, який є externalId розмови, а message_id використовуй як externalId кожного повідомлення.
Повідомлення клієнтів — це incoming, відповіді агентів — outgoing, а приватні коментарі — notes.
Використовуй created_at як sentAt (час указано в UTC), а attachment_url — для attachments.
Спочатку імпортуй 5 розмов, щоб я міг перевірити їх у Sonny, а потім імпортуй решту пакетами по 20 і покажи мені підсумки.

Що буде перенесено

Розмови
Тема, статус, теги й відповідальний — як чати або розмови ел. поштою у вашому каналі.
Повідомлення
Повідомлення клієнтів, відповіді команди, внутрішні нотатки й відповіді чат-бота — кожне з оригінальною датою та часом.
Контакти
Зіставляються за адресою ел. пошти, а нові створюються. Контакти, які у вас уже є в Sonny, ніколи не змінюються.
Вкладення
Зображення, PDF, документи, таблиці й ZIP-файли до 25MB — за публічним посиланням або надіслані як сам файл.

Формат імпорту

AI надсилає розмови в такому вигляді. Писати його самому не потрібно, але корисно знати, за що відповідає кожне поле.

json
{
  "sourceId": "source_shop",
  "conversations": [
    {
      "externalId": "crisp-8812",
      "subject": "Delivery question",
      "contact": {
        "email": "ada@example.com",
        "name": "Ada"
      },
      "tags": [
        "Shipping"
      ],
      "messages": [
        {
          "externalId": "1",
          "direction": "incoming",
          "body": "Has my order shipped?",
          "sentAt": "2025-03-14T09:30:00Z"
        },
        {
          "externalId": "2",
          "direction": "outgoing",
          "body": "Yes, it left this morning.",
          "sentAt": "2025-03-14T09:41:00Z",
          "author": {
            "name": "Sam",
            "email": "sam@yourcompany.com"
          }
        },
        {
          "externalId": "3",
          "direction": "incoming",
          "body": "",
          "sentAt": "2025-03-14T09:45:00Z",
          "attachments": [
            {
              "url": "https://files.example.com/receipt.pdf"
            }
          ]
        }
      ]
    }
  ]
}
externalId
Ідентифікатор розмови у вашому старому інструменті. Обов’язкове поле. Повторний імпорт того самого ідентифікатора додає лише нове.
messages
Повідомлення розмови. Кожне потребує напрямку (incoming, outgoing або note), тексту й sentAt.
sentAt
Коли надіслано повідомлення, у форматі ISO 8601 з часовим поясом, наприклад 2025-03-14T09:30:00Z.
author
Хто його написав. Ел. пошта колеги прив’язує відповідь до нього в Sonny, а тип bot позначає відповіді чат-бота.
contact
Адреса ел. пошти й ім’я клієнта.
status
open, pending або closed. За замовчуванням — closed.
channel
chat або email. За замовчуванням — chat, якщо в каналу є вебсайт.
attachments
Файли: кожен — як публічний https url або як fileName, contentType і dataBase64.
tags
Назви тегів. Нові теги створюються автоматично.
assigneeEmail
Колега, якому призначено розмову.

Корисно знати

  • Можна запускати повторно. Якщо імпорт зупинився на півдорозі, запустіть його ще раз. Повідомлення, які вже перенесено, пропускаються, а невдалі вкладення завантажуються повторно.
  • Пакети. Один виклик приймає до 50 розмов, 1 000 повідомлень і 25 вкладень. Більші імпорти AI розбиває за вас.
  • Немає адреси ел. пошти? Розмова все одно імпортується, лише без контакту. Ім’я клієнта залишається на його повідомленнях.
  • Колеги. Відповідь прив’язується до колеги, якщо ел. пошта автора збігається з кимось у вашому робочому просторі. Інакше зберігається ім’я зі старого інструмента.
  • Хто може імпортувати. Власники, адміністратори й агенти. API-ключам потрібен доступ на запис до розмов, повідомлень і контактів, а для файлів ще й до attachments.

Для розробників

Не користуєтеся AI-асистентом? Надішліть той самий JSON на POST /api/v1/conversations/import з API-ключем. Повну схему дивіться в довіднику API.

Пов’язані посібники