**Per migrare le tue conversazioni e contatti da un'altra piattaforma a Papo (https://papo.global/), puoi esportare i dati dal vecchio sistema, importare i contatti in massa tramite file CSV e utilizzare l'API di Papo per ricreare lo storico delle conversazioni, garantendo che nessuna informazione vada persa nella transizione.**

La migrazione da una precedente piattaforma di assistenza a Papo comporta tre fasi principali: estrarre i dati dal sistema di origine, caricare i contatti nel CRM di Papo e, se necessario, trasferire lo storico delle interazioni utilizzando l'API. Papo offre strumenti che semplificano questo processo, evitando la digitazione manuale e preservando il contesto delle relazioni con i clienti.

## Riepilogo della migrazione

| Fase | Azione | Dove in Papo |
| :--- | :--- | :--- |
| 1. Esportare dal vecchio sistema | Generare file CSV con contatti e, se possibile, storico delle conversazioni. | — |
| 2. Preparare il CSV | Organizzare le colonne (nome, email, telefono, tag) e standardizzare i dati. | — |
| 3. Importare contatti in massa | Caricare il CSV e mappare i campi. | Modulo Contatti > Importa |
| 4. Migrare lo storico (opzionale) | Usare l'API per creare contatti e messaggi in modo programmatico. | API (chiave pubblica e segreta) |
| 5. Verificare la migrazione | Controllare che i contatti e le conversazioni appaiano correttamente. | Moduli Contatti e Conversazioni |

## Come funziona – passo dopo passo

### 1. Esporta i dati dal tuo sistema attuale

La maggior parte delle piattaforme CRM e di assistenza consente di esportare contatti e conversazioni in CSV o fornisce un'API per l'estrazione. Consulta la documentazione del tuo vecchio sistema per generare questi file. L'ideale è ottenere:

- Elenco dei contatti con nome, email, telefono ed etichette (tag).
- Se possibile, un file con lo storico dei messaggi (data, mittente, testo).

Se il sistema non offre l'esportazione delle conversazioni, puoi comunque migrare i contatti e iniziare le nuove interazioni su Papo con tutto il contesto disponibile nel CRM.

### 2. Prepara il file CSV per l'importazione dei contatti

La qualità dell'importazione dipende dall'organizzazione del file. Prima di caricare l'elenco, verifica:

- **Formato**: salva come `.csv` (valori separati da virgola).
- **Intestazioni**: la prima riga deve contenere i nomi delle colonne, come `nome`, `email`, `telefono`, `tag`.
- **Dati puliti**: rimuovi celle unite, righe vuote e formattazioni speciali. Standardizza i numeri di telefono con codice paese e prefisso (es.: 55119XXXXXXXX).

Esempio di struttura:

| nome | email | telefono | tag |
| :--- | :--- | :--- | :--- |
| Maria Silva | maria.silva@email.com | 5511987654321 | lead-caldo, evento-sp |
| João Costa | joao.costa@email.com | 5521912345678 | cliente-attivo |

Usa la colonna `tag` per segmentare i contatti già durante l'importazione, separando più etichette con una virgola.

### 3. Importa i contatti in massa su Papo

Con il CSV pronto, caricalo su Papo:

1. Accedi al modulo **Contatti** nel CRM.
2. Individua l'opzione **Importa contatti** (di solito vicino al pulsante per creare un nuovo contatto).
3. Carica il tuo file CSV.
4. Nella fase di mappatura, associa ogni colonna del tuo file al campo corrispondente in Papo (es.: colonna `nome` → campo Nome). Ciò include campi personalizzati, se presenti.
5. Rivedi la mappatura e avvia l'importazione.

La piattaforma elabora il file in background. Alla fine, i contatti appaiono nella tua base, pronti per essere inclusi in campagne, funnel o assistenza.

### 4. Trasferisci lo storico delle conversazioni con l'API di Papo (opzionale)

Se hai bisogno di preservare lo storico completo delle interazioni, l'API di Papo permette di creare contatti e registrare messaggi in modo programmatico. Questo metodo è utile quando il vecchio sistema fornisce un estratto dettagliato delle conversazioni.

Per usare l'API:

- Genera le tue chiavi di accesso (pubblica e segreta) seguendo la guida [Come generare una chiave pubblica e una chiave segreta dell'API Papo](/hc/papo/articles/come-generare-chiave-pubblica-segreta-api-papo).
- Sviluppa uno script che legga i dati esportati dal sistema precedente e chiami gli endpoint appropriati per creare contatti (se non ancora importati) e inviare i messaggi storici.
- Consulta la documentazione ufficiale dell'API su [https://papo.global/docs](https://papo.global/docs) per conoscere gli endpoint, i parametri e i limiti esatti.

Questo approccio garantisce che il contesto di assistenza precedente sia disponibile nel CRM di Papo, consentendo al tuo team di riprendere conversazioni passate senza perdere informazioni.

### 5. Verifica la migrazione

Dopo l'importazione e, se applicabile, il caricamento tramite API, accedi ai moduli **Contatti** e **Conversazioni** per confermare che:

- Tutti i contatti appaiono con i campi compilati correttamente.
- Le etichette sono state applicate come da CSV.
- Lo storico dei messaggi (se migrato) è visibile nella timeline del contatto.

Se qualcosa non corrisponde, puoi correggere manualmente o ripetere l'importazione con le modifiche necessarie.

## A chi è utile questa migrazione

- Aziende che stanno cambiando piattaforma di assistenza e desiderano centralizzare tutto su Papo.
- Team che utilizzavano più strumenti (CRM, chat, email) e vogliono unificare contatti e storico in un unico posto.
- Operazioni che non possono perdere il contesto delle vecchie conversazioni quando adottano un nuovo sistema.
- Attività che necessitano di una transizione rapida, senza digitare i contatti uno per uno.

## Domande frequenti

### Devo esportare i contatti in un formato specifico?
Sì, il formato accettato è CSV con intestazioni. La maggior parte dei fogli di calcolo (Excel, Google Sheets) può salvare in questo formato.

### Posso importare campi personalizzati oltre a nome, email e telefono?
Sì. Durante la mappatura, puoi associare le colonne del CSV a campi personalizzati già esistenti nel tuo account Papo.

### L'importazione in massa ha un limite di contatti?
I limiti possono variare a seconda del piano. Per informazioni aggiornate, consulta il centro assistenza o il sito di Papo.

### Come faccio a migrare le conversazioni se non ho uno sviluppatore?
Puoi importare solo i contatti e iniziare a fornire assistenza su Papo dalla migrazione. Lo storico precedente rimane accessibile nel vecchio sistema, se necessario.

### L'API permette di ricreare conversazioni da qualsiasi canale?
L'API di Papo è documentata su [https://papo.global/docs](https://papo.global/docs). Lì trovi i canali supportati e le operazioni disponibili per registrare messaggi.

### Cosa succede se il mio CSV contiene errori?
La piattaforma può rifiutare righe con dati non validi. Consigliamo di convalidare il foglio di calcolo prima dell'importazione, rimuovendo duplicati e standardizzando i numeri di telefono.

## Leggi anche

- [Come generare una chiave pubblica e una chiave segreta dell'API Papo](/hc/papo/articles/come-generare-chiave-pubblica-segreta-api-papo)
- [Come configurare Papo in 5 passi per iniziare a fornire assistenza su WhatsApp](/hc/papo/articles/configurare-papo-5-passaggi-whatsapp)

---

**[Inizia la tua migrazione gratuitamente →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-migrare-conversazioni-contatti-altra-piattaforma-papo&utm_content=it)**

Crea il tuo account su Papo senza costi e centralizza contatti e conversazioni in un'unica piattaforma.