Migratiehandleiding

Je gespreksgeschiedenis importeren

Stap je over van een andere chat- of helpdesktool? Exporteer je geschiedenis als CSV of in een ander bestand, geef het aan je AI-assistent, en die zet elk gesprek via onze MCP-server in Sonny. Het werkt met elke tool, want je AI doet de koppeling van de velden.

Er wordt niets verstuurd

Geïmporteerde gesprekken zijn geschiedenis. Sonny stuurt er geen e-mails of berichten voor naar je klanten, waarschuwt je team niet, activeert geen webhooks, voert geen AI-antwoorden of inboxregels uit en verstuurt geen tevredenheidsenquêtes. Ze komen binnen als gesloten en al gelezen, dus je inbox blijft rustig.

Voordat je begint

Sonny gekoppeld aan je AI-assistent
Voeg de MCP-server van Sonny toe aan Claude, Cursor of een andere AI-app. De MCP-handleiding kost ongeveer een minuut.
Een export uit je oude tool
Een CSV-, JSON- of spreadsheetexport van je gesprekken en berichten. Slaat je oude tool bestanden op als links, bewaar dan die kolommen: Sonny kan ze downloaden.
Een kanaal om in te importeren
Geïmporteerde chats gebruiken de website van het kanaal en geïmporteerde e-mails het e-mailadres. Je AI kan je kanalen opsommen en vragen welk kanaal ze moet gebruiken.

Stap voor stap

  1. 01

    Koppel Sonny

    Koppel de MCP-server van Sonny aan je AI-assistent en log in op je werkruimte. Heb je hem al eerder dan vandaag gekoppeld, koppel dan opnieuw zodat je AI de nieuwe importtool ziet.

  2. 02

    Geef je export mee

    Voeg het bestand toe of wijs je AI ernaar en vertel in welk kanaal ze moet importeren.

  3. 03

    Vraag om te importeren

    Gebruik de prompt hieronder als uitgangspunt. Je AI leest het bestand, zet het om naar het formaat van Sonny en stuurt het in batches.

  4. 04

    Controleer de resultaten

    Je AI meldt wat er is geïmporteerd en of er problemen waren. Open een paar gesprekken in Sonny om te zien of ze er goed uitzien en laat haar daarna de rest afmaken.

Voorbeeldprompt

Pas de kolomnamen aan op je bestand.

prompt
Importeer de gesprekken in export.csv in mijn Sonny-kanaal "Support" met de tool import_conversations.
Elke rij is één bericht. Groepeer de rijen op ticket_id, dat is de externalId van het gesprek, en gebruik message_id als externalId van elk bericht.
Berichten van klanten zijn incoming, antwoorden van agents zijn outgoing en privéopmerkingen zijn note.
Gebruik created_at als sentAt (de tijden zijn in UTC) en attachment_url voor attachments.
Importeer eerst 5 gesprekken zodat ik ze in Sonny kan controleren, importeer daarna de rest in batches van 20 en laat me de totalen zien.

Wat er meekomt

Gesprekken
Onderwerp, status, tags en toegewezen persoon, als chat- of e-mailgesprekken in je kanaal.
Berichten
Klantberichten, antwoorden van je team, interne notities en chatbotantwoorden, elk met de oorspronkelijke datum en tijd.
Contacten
Gekoppeld op e-mailadres en aangemaakt als ze nieuw zijn. Contacten die je al in Sonny hebt, worden nooit gewijzigd.
Bijlagen
Afbeeldingen, pdf’s, documenten, spreadsheets en ZIP-bestanden tot 25MB, via een openbare link of als bestand zelf meegestuurd.

Het importformaat

Je AI stuurt gesprekken in deze vorm. Je hoeft het niet zelf te schrijven, maar het helpt om te weten waar elk veld voor dient.

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
De ID van het gesprek in je oude tool. Verplicht. Als je dezelfde ID opnieuw importeert, wordt alleen toegevoegd wat nieuw is.
messages
De berichten van het gesprek. Elk bericht heeft een richting (incoming, outgoing of note), een tekst en sentAt nodig.
sentAt
Wanneer het bericht is verstuurd, in ISO 8601 met een tijdzone, bijvoorbeeld 2025-03-14T09:30:00Z.
author
Wie het schreef. Het e-mailadres van een teamlid koppelt het antwoord in Sonny aan die persoon, en het type bot markeert chatbotantwoorden.
contact
Het e-mailadres en de naam van de klant.
status
open, pending of closed. Standaard closed.
channel
chat of email. Standaard chat als het kanaal een website heeft.
attachments
Bestanden, elk als openbare https-url, of met fileName, contentType en dataBase64.
tags
Namen van tags. Nieuwe tags worden voor je aangemaakt.
assigneeEmail
Het teamlid aan wie het gesprek wordt toegewezen.

Goed om te weten

  • Veilig om opnieuw uit te voeren. Stopt een import halverwege, voer hem dan opnieuw uit. Berichten die al zijn overgekomen worden overgeslagen en mislukte bijlagen worden opnieuw geprobeerd.
  • Batches. Elke aanroep accepteert maximaal 50 gesprekken, 1.000 berichten en 25 bijlagen. Je AI splitst grotere imports voor je op.
  • Geen e-mailadres? Het gesprek wordt toch geïmporteerd, alleen zonder contact. De naam van de klant blijft bij zijn berichten staan.
  • Teamleden. Een antwoord wordt aan een teamlid gekoppeld als het e-mailadres van de auteur overeenkomt met iemand in je werkruimte. Anders behoudt het de naam uit je oude tool.
  • Wie mag importeren. Eigenaars, beheerders en agents. API-sleutels hebben schrijftoegang nodig tot gesprekken, berichten en contacten, plus bijlagen voor bestanden.

Voor ontwikkelaars

Gebruik je geen AI-assistent? Stuur dezelfde JSON met een API-sleutel naar POST /api/v1/conversations/import. De API-referentie bevat het volledige schema.

Gerelateerde handleidingen