Anleitung zum Umstieg

Konversationsverlauf importieren

Du wechselst von einem anderen Chat- oder Helpdesk-Tool? Exportiere deinen Verlauf als CSV oder in einer anderen Datei, gib sie deinem KI-Assistenten, und er übernimmt jede Unterhaltung über unseren MCP-Server in Sonny. Das funktioniert mit jedem Tool, weil deine KI die Zuordnung übernimmt.

Es wird nichts gesendet

Importierte Unterhaltungen sind Verlauf. Sonny schreibt deshalb keine E-Mails oder Nachrichten an deine Kunden, benachrichtigt dein Team nicht, löst keine Webhooks aus, startet keine KI-Antworten oder Posteingangsregeln und verschickt keine Zufriedenheitsumfragen. Sie kommen geschlossen und bereits gelesen an, dein Posteingang bleibt also ruhig.

Bevor du loslegst

Sonny mit deinem KI-Assistenten verbunden
Füge den MCP-Server von Sonny zu Claude, Cursor oder einer anderen KI-App hinzu. Die MCP-Anleitung dauert etwa eine Minute.
Ein Export aus deinem alten Tool
Ein CSV-, JSON- oder Tabellen-Export deiner Unterhaltungen und Nachrichten. Speichert dein altes Tool Dateien als Links, behalte diese Spalten: Sonny kann sie herunterladen.
Ein Kanal für den Import
Importierte Chats nutzen die Website des Kanals, importierte E-Mails seine E-Mail-Adresse. Deine KI kann deine Kanäle auflisten und nachfragen, welchen sie verwenden soll.

Schritt für Schritt

  1. 01

    Sonny verbinden

    Verbinde den MCP-Server von Sonny mit deinem KI-Assistenten und melde dich in deinem Arbeitsbereich an. Hast du ihn schon vor heute verbunden, verbinde ihn neu, damit deine KI das neue Import-Tool sieht.

  2. 02

    Gib ihr deinen Export

    Hänge die Datei an oder verweise deine KI darauf und sag ihr, in welchen Kanal importiert werden soll.

  3. 03

    Bitte sie um den Import

    Nimm den Prompt unten als Ausgangspunkt. Deine KI liest die Datei, ordnet sie dem Format von Sonny zu und sendet sie in Stapeln.

  4. 04

    Ergebnisse prüfen

    Deine KI meldet, was importiert wurde und ob es Probleme gab. Öffne ein paar Unterhaltungen in Sonny und prüfe, ob sie richtig aussehen, und lass sie dann den Rest erledigen.

Beispiel-Prompt

Passe die Spaltennamen an deine Datei an.

prompt
Importiere die Unterhaltungen aus export.csv mit dem Tool import_conversations in meinen Sonny-Kanal "Support".
Jede Zeile ist eine Nachricht. Gruppiere die Zeilen nach ticket_id, das ist die externalId der Unterhaltung, und verwende message_id als externalId jeder Nachricht.
Nachrichten von Kunden sind incoming, Antworten von Agenten sind outgoing und private Kommentare sind note.
Verwende created_at als sentAt (die Zeiten sind in UTC) und attachment_url für attachments.
Importiere zuerst 5 Unterhaltungen, damit ich sie in Sonny prüfen kann, importiere dann den Rest in Stapeln zu 20 und zeig mir die Summen.

Was übernommen wird

Unterhaltungen
Betreff, Status, Tags und zuständige Person, als Chat- oder E-Mail-Unterhaltungen in deinem Kanal.
Nachrichten
Kundennachrichten, Antworten des Teams, interne Notizen und Chatbot-Antworten, jeweils mit ursprünglichem Datum und Uhrzeit.
Kontakte
Per E-Mail-Adresse abgeglichen und bei Bedarf neu angelegt. Kontakte, die du schon in Sonny hast, werden nie verändert.
Anhänge
Bilder, PDFs, Dokumente, Tabellen und ZIP-Dateien bis 25MB, über einen öffentlichen Link oder als Datei selbst gesendet.

Das Importformat

Deine KI sendet Unterhaltungen in dieser Form. Du musst sie nicht selbst schreiben, aber es hilft zu wissen, wofür jedes Feld da ist.

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
Die ID der Unterhaltung in deinem alten Tool. Pflichtfeld. Wird dieselbe ID erneut importiert, wird nur Neues hinzugefügt.
messages
Die Nachrichten der Unterhaltung. Jede braucht eine Richtung (incoming, outgoing oder note), einen Text und sentAt.
sentAt
Wann die Nachricht gesendet wurde, im Format ISO 8601 mit Zeitzone, zum Beispiel 2025-03-14T09:30:00Z.
author
Wer sie geschrieben hat. Die E-Mail-Adresse eines Teammitglieds verknüpft die Antwort in Sonny mit dieser Person, und der Typ bot kennzeichnet Chatbot-Antworten.
contact
Die E-Mail-Adresse und der Name des Kunden.
status
open, pending oder closed. Standard ist closed.
channel
chat oder email. Standard ist chat, wenn der Kanal eine Website hat.
attachments
Dateien, jeweils als öffentliche https-url oder mit fileName, contentType und dataBase64.
tags
Namen von Tags. Neue Tags werden für dich angelegt.
assigneeEmail
Das Teammitglied, dem die Unterhaltung zugewiesen wird.

Gut zu wissen

  • Du kannst es gefahrlos erneut ausführen. Bricht ein Import auf halbem Weg ab, führe ihn einfach noch einmal aus. Bereits übernommene Nachrichten werden übersprungen, fehlgeschlagene Anhänge erneut versucht.
  • Stapel. Jeder Aufruf nimmt bis zu 50 Unterhaltungen, 1.000 Nachrichten und 25 Anhänge entgegen. Größere Importe teilt deine KI für dich auf.
  • Keine E-Mail-Adresse? Die Unterhaltung wird trotzdem importiert, nur ohne Kontakt. Der Name des Kunden bleibt an seinen Nachrichten.
  • Teammitglieder. Eine Antwort wird mit einem Teammitglied verknüpft, wenn die E-Mail-Adresse des Autors zu jemandem in deinem Arbeitsbereich passt. Sonst behält sie den Namen aus deinem alten Tool.
  • Wer importieren darf. Inhaber, Admins und Agenten. API-Schlüssel brauchen Schreibzugriff auf Unterhaltungen, Nachrichten und Kontakte, für Dateien zusätzlich auf Anhänge.

Für Entwickler

Du nutzt keinen KI-Assistenten? Sende dasselbe JSON mit einem API-Schlüssel an POST /api/v1/conversations/import. Die API-Referenz enthält das vollständige Schema.

Verwandte Anleitungen