Guida alla migrazione

Importa la cronologia delle conversazioni

Passi da un altro strumento di chat o helpdesk? Esporta la cronologia come CSV o in qualsiasi altro file, consegnala al tuo assistente AI e lui porta ogni conversazione in Sonny tramite il nostro server MCP. Funziona con qualsiasi strumento, perché la mappatura la fa la tua AI.

Non viene inviato nulla

Le conversazioni importate sono solo cronologia. Sonny non invia email o messaggi ai tuoi clienti, non avvisa il tuo team, non attiva webhook, non esegue risposte AI né regole della posta in arrivo e non invia sondaggi di soddisfazione per queste conversazioni. Arrivano chiuse e già lette, così la tua posta in arrivo resta tranquilla.

Prima di iniziare

Sonny collegato al tuo assistente AI
Aggiungi il server MCP di Sonny a Claude, Cursor o a un’altra app AI. La guida MCP richiede circa un minuto.
Un’esportazione dal tuo vecchio strumento
Un’esportazione in CSV, JSON o foglio di calcolo con le tue conversazioni e i tuoi messaggi. Se il vecchio strumento salva i file come link, mantieni quelle colonne: Sonny può scaricarli.
Un canale in cui importare
Le chat importate usano il sito web del canale e le email importate il suo indirizzo email. La tua AI può elencare i tuoi canali e chiederti quale usare.

Passo dopo passo

  1. 01

    Collega Sonny

    Collega il server MCP di Sonny al tuo assistente AI e accedi al tuo spazio di lavoro. Se ti sei collegato prima di oggi, ricollegati così la tua AI vede il nuovo strumento di importazione.

  2. 02

    Dagli la tua esportazione

    Allega il file o indica alla tua AI dove si trova, e dille in quale canale importare.

  3. 03

    Chiedigli di importare

    Usa il prompt qui sotto come punto di partenza. La tua AI legge il file, lo adatta al formato di Sonny e lo invia a lotti.

  4. 04

    Controlla i risultati

    La tua AI ti dice cosa è stato importato e quali problemi ci sono stati. Apri alcune conversazioni in Sonny per verificare che siano corrette, poi lascia che finisca il resto.

Prompt di esempio

Cambia i nomi delle colonne in modo che corrispondano al tuo file.

prompt
Importa le conversazioni di export.csv nel mio canale Sonny "Support" usando lo strumento import_conversations.
Ogni riga è un messaggio. Raggruppa le righe per ticket_id, che è l’externalId della conversazione, e usa message_id come externalId di ogni messaggio.
I messaggi dei clienti sono incoming, le risposte degli agenti sono outgoing e i commenti privati sono note.
Usa created_at come sentAt (gli orari sono in UTC) e attachment_url per attachments.
Importa prima 5 conversazioni così posso controllarle in Sonny, poi importa il resto a lotti di 20 e mostrami i totali.

Cosa viene importato

Conversazioni
Oggetto, stato, tag e assegnatario, come conversazioni chat o email sul tuo canale.
Messaggi
Messaggi dei clienti, risposte del team, note interne e risposte del chatbot, ciascuno con la data e l’ora originali.
Contatti
Abbinati tramite indirizzo email e creati se nuovi. I contatti che hai già in Sonny non vengono mai modificati.
Allegati
Immagini, PDF, documenti, fogli di calcolo e file ZIP fino a 25MB, da un link pubblico o inviati come file vero e proprio.

Il formato di importazione

La tua AI invia le conversazioni in questa forma. Non devi scriverla tu, ma è utile sapere a cosa serve ogni campo.

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
L’ID della conversazione nel tuo vecchio strumento. Obbligatorio. Importare di nuovo lo stesso ID aggiunge solo ciò che è nuovo.
messages
I messaggi della conversazione. Ognuno richiede una direzione (incoming, outgoing o note), un corpo e sentAt.
sentAt
Quando è stato inviato il messaggio, in ISO 8601 con fuso orario, ad esempio 2025-03-14T09:30:00Z.
author
Chi lo ha scritto. L’email di un collega collega la risposta a lui in Sonny, e il tipo bot indica le risposte del chatbot.
contact
L’indirizzo email e il nome del cliente.
status
open, pending o closed. Il valore predefinito è closed.
channel
chat o email. Il valore predefinito è chat quando il canale ha un sito web.
attachments
File, ciascuno come url https pubblico, oppure come fileName, contentType e dataBase64.
tags
Nomi dei tag. I nuovi tag vengono creati per te.
assigneeEmail
Il collega a cui assegnare la conversazione.

Da sapere

  • Puoi rieseguirla senza rischi. Se un’importazione si interrompe a metà, eseguila di nuovo. I messaggi già importati vengono saltati e gli allegati falliti vengono ritentati.
  • Lotti. Ogni chiamata accetta fino a 50 conversazioni, 1.000 messaggi e 25 allegati. La tua AI divide per te le importazioni più grandi.
  • Nessun indirizzo email? La conversazione viene importata comunque, solo senza contatto. Il nome del cliente resta sui suoi messaggi.
  • Colleghi. Una risposta viene collegata a un collega quando l’email dell’autore corrisponde a qualcuno nel tuo spazio di lavoro. Altrimenti mantiene il nome del vecchio strumento.
  • Chi può importare. Proprietari, amministratori e agenti. Le chiavi API richiedono accesso in scrittura a conversazioni, messaggi e contatti, più gli allegati per i file.

Per gli sviluppatori

Non usi un assistente AI? Invia lo stesso JSON a POST /api/v1/conversations/import con una chiave API. Il riferimento API contiene lo schema completo.

Guide correlate