Migrasiegids

Voer jou gesprekgeskiedenis in

Skakel jy oor van ’n ander klets- of hulpdeskhulpmiddel? Voer jou geskiedenis uit as ’n CSV of enige ander lêer, gee dit vir jou KI-assistent, en dit bring elke gesprek deur ons MCP-bediener na Sonny. Dit werk met enige hulpmiddel, want jou KI doen die vertaling van die velde.

Niks word gestuur nie

Ingevoerde gesprekke is geskiedenis. Sonny stuur nie e-pos of boodskappe aan jou kliënte nie, lig nie jou span in nie, aktiveer nie webhooks nie, laat nie KI-antwoorde of inkassiereëls loop nie en stuur nie tevredenheidsopnames daarvoor nie. Hulle kom gesluit en reeds gelees aan, so jou inkassie bly rustig.

Voordat jy begin

Sonny gekoppel aan jou KI-assistent
Voeg Sonny se MCP-bediener by Claude, Cursor of ’n ander KI-toepassing. Die MCP-gids neem ongeveer ’n minuut.
’n Uitvoer uit jou ou hulpmiddel
’n CSV-, JSON- of sigbladuitvoer van jou gesprekke en boodskappe. As jou ou hulpmiddel lêers as skakels stoor, hou daardie kolomme: Sonny kan dit aflaai.
’n Kanaal om in te voer
Ingevoerde kletse gebruik die kanaal se webwerf en ingevoerde e-posse gebruik sy e-posadres. Jou KI kan jou kanale lys en vra watter een om te gebruik.

Stap vir stap

  1. 01

    Koppel Sonny

    Koppel Sonny se MCP-bediener aan jou KI-assistent en meld by jou werkspasie aan. As jy voor vandag gekoppel het, koppel weer sodat jou KI die nuwe invoerhulpmiddel sien.

  2. 02

    Gee dit jou uitvoer

    Heg die lêer aan of wys jou KI waar dit is, en sê vir dit in watter kanaal om in te voer.

  3. 03

    Vra dit om in te voer

    Gebruik die opdrag hieronder as beginpunt. Jou KI lees die lêer, kaart dit na Sonny se formaat en stuur dit in bondels.

  4. 04

    Kontroleer die resultate

    Jou KI rapporteer wat ingevoer is en enige probleme. Maak ’n paar gesprekke in Sonny oop om te kyk of dit reg lyk, en laat dit dan die res klaarmaak.

Voorbeeldopdrag

Verander die kolomname om by jou lêer te pas.

prompt
Voer die gesprekke in export.csv in my Sonny-kanaal "Support" in met die import_conversations-hulpmiddel.
Elke ry is een boodskap. Groepeer rye volgens ticket_id, wat die gesprek se externalId is, en gebruik message_id as elke boodskap se externalId.
Kliëntboodskappe is incoming, agentantwoorde is outgoing en private kommentaar is notes.
Gebruik created_at as sentAt (die tye is in UTC) en attachment_url vir attachments.
Voer eers 5 gesprekke in sodat ek dit in Sonny kan nagaan, voer dan die res in bondels van 20 in en wys my die totale.

Wat oorkom

Gesprekke
Onderwerp, status, etikette en toegewysde persoon, as klets- of e-posgesprekke op jou kanaal.
Boodskappe
Kliëntboodskappe, spanantwoorde, interne notas en kletsbot-antwoorde, elk met sy oorspronklike datum en tyd.
Kontakte
Gepas volgens e-posadres en nuut geskep indien nodig. Kontakte wat jy reeds in Sonny het, word nooit verander nie.
Aanhangsels
Beelde, PDF’s, dokumente, sigblaaie en ZIP-lêers tot 25MB, vanaf ’n openbare skakel of as die lêer self gestuur.

Die invoerformaat

Jou KI stuur gesprekke in hierdie vorm. Jy hoef dit nie self te skryf nie, maar dit help om te weet wat elke veld doen.

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 gesprek se ID in jou ou hulpmiddel. Vereis. As jy dieselfde ID weer invoer, word net die nuwe goed bygevoeg.
messages
Die gesprek se boodskappe. Elkeen het ’n rigting (incoming, outgoing of note), ’n teks en sentAt nodig.
sentAt
Wanneer die boodskap gestuur is, in ISO 8601 met ’n tydsone, byvoorbeeld 2025-03-14T09:30:00Z.
author
Wie dit geskryf het. ’n Spanmaat se e-pos koppel die antwoord aan hulle in Sonny, en type bot merk kletsbot-antwoorde.
contact
Die kliënt se e-posadres en naam.
status
open, pending of closed. Verstek is closed.
channel
chat of email. Verstek is chat wanneer die kanaal ’n webwerf het.
attachments
Lêers, elk as ’n openbare https url, of as fileName, contentType en dataBase64.
tags
Etiketname. Nuwe etikette word vir jou geskep.
assigneeEmail
Die spanmaat aan wie die gesprek toegewys word.

Goed om te weet

  • Veilig om weer te laat loop. As ’n invoer halfpad stop, laat dit weer loop. Boodskappe wat reeds oorgekom het, word oorgeslaan en mislukte aanhangsels word weer probeer.
  • Bondels. Elke oproep neem tot 50 gesprekke, 1 000 boodskappe en 25 aanhangsels. Jou KI verdeel groter invoere vir jou.
  • Geen e-posadres? Die gesprek word steeds ingevoer, net sonder ’n kontak. Die kliënt se naam bly op hul boodskappe.
  • Spanmaats. ’n Antwoord word aan ’n spanmaat gekoppel wanneer die skrywer se e-pos by iemand in jou werkspasie pas. Anders hou dit die naam uit jou ou hulpmiddel.
  • Wie kan invoer. Eienaars, admins en agente. API-sleutels het skryftoegang tot gesprekke, boodskappe en kontakte nodig, plus attachments vir lêers.

Vir ontwikkelaars

Gebruik jy nie ’n KI-assistent nie? Stuur dieselfde JSON na POST /api/v1/conversations/import met ’n API-sleutel. Die API-verwysing het die volle skema.

Verwante dokumentasie