Documentazione

Migrare a Respondo

Arrivi da un altro helpdesk? Porta la tua knowledge base, la cronologia delle conversazioni, le risposte salvate e le impostazioni del workspace in un unico passaggio guidato — un import una tantum, senza connessione permanente al tuo vecchio strumento.

Panoramica#

La procedura guidata di migrazione si collega al tuo helpdesk attuale con una credenziale API in sola lettura, ti mostra esattamente cosa ha trovato, ti fa scegliere cosa portare, e poi importa tutto in background mentre continui a lavorare. Al termine, i tuoi articoli alimentano l'agente IA, le tue conversazioni passate stanno nell'Inbox con la cronologia completa e le tue risposte salvate sono pronte all'uso.

Import una tantum

I dati vengono copiati una volta sola. Respondo non sincronizza nulla verso il tuo vecchio helpdesk e non mantiene una connessione live.

Scegli tu cosa si sposta

Ogni categoria — articoli, conversazioni, risposte salvate, impostazioni — può essere attivata o disattivata. Gli articoli si possono persino selezionare uno per uno.

Progresso onesto

Una schermata di avanzamento live mostra conteggi reali per categoria — importati, aggiornati, saltati, falliti — e puoi annullare in qualsiasi momento.

La credenziale che fornisci viene usata solo per leggere i dati. Collegare un helpdesk per la migrazione non crea un canale, non installa un webhook e non cambia nulla nel tuo vecchio workspace.

Sorgenti supportate#

Respondo può importare da tre helpdesk. Ognuno chiama le cose in modo un po' diverso — la procedura guidata usa ovunque la terminologia del vendor:

SorgenteKnowledge baseRisposte riutilizzabili
ZendeskArticoli dell'Help CenterMacro
IntercomArticoliRisposte salvate (non disponibili — vedi le limitazioni più sotto)
FreshdeskSolutionsCanned responses
Il tuo vecchio helpdesk è una sorgente di migrazione, non un canale. Dopo l'import, le conversazioni vivono nei loro canali reali (email, widget di chat) e il tuo vecchio strumento non gioca più alcun ruolo. Per continuare a ricevere nuovi messaggi, collega i tuoi canali in Respondo — la migrazione non lo fa per te.

Cosa viene importato#

L'import gira in quattro categorie indipendenti. Scegli quali includere nel passo Scegli della procedura guidata:

CategoriaCosa diventa in Respondo
Articoli della knowledge baseGli articoli pubblicati diventano una fonte di conoscenza per l'agente IA che selezioni — l'agente può rispondere subito a partire da essi. Puoi importare tutto o selezionare singoli articoli, con un filtro per lingua per gli help center multilingue.
Conversazioni passateTicket e conversazioni arrivano nell'Inbox come conversazioni risolte con la cronologia completa dei messaggi e i contatti. Da esse vengono anche estratte coppie domanda-risposta di alta qualità come dati di addestramento, così l'agente impara come risponde davvero il tuo team.
Macro / risposte salvate / canned responsesLe tue risposte riutilizzabili diventano risposte salvate (Impostazioni → Macro) che i membri del team possono inserire in qualsiasi conversazione.
Impostazioni del workspaceFuso orario, orari di lavoro (festività incluse) e il nome della tua azienda. Nulla viene applicato alla cieca — la procedura guidata mostra un confronto fianco a fianco di ogni impostazione, e vengono scritte solo le modifiche che accetti.

Le conversazioni importate non attivano alcuna automazione: nessuna risposta del bot, nessuna escalation, nessuna notifica. Arrivano in silenzio come cronologia. Poiché nel tuo vecchio helpdesk le ha risolte un umano, vengono archiviate come Risolte dal team e non come Risolte dall'IA.

Le credenziali che ti servono#

Ogni provider richiede una credenziale API in sola lettura. Il passo Collega della procedura guidata ti dice esattamente dove crearla:

SorgenteInserisciDove ottenerla
ZendeskSottodominio, email dell'admin e un token APIIn Zendesk: Admin → Apps and integrations → APIs → Zendesk API
IntercomAccess token e la tua regione dati (US, EU o Australia)Nell'Intercom Developer Hub: crea un'app interna in Your apps, poi copia il suo Access Token da Authentication
FreshdeskDominio e una chiave APIIn Freshdesk: Profile settings → View API key (la chiave di un admin importa di più)
Collegare una sorgente, avviare un import e annullarlo richiedono il permesso manage channels — di default Owner e Admin, o qualsiasi ruolo personalizzato con il permesso Canali abilitato. I membri del team che non lo hanno possono comunque aprire la procedura guidata e osservare l'avanzamento di una migrazione in corso.

Eseguire la procedura guidata#

Apri l'hub di migrazione su /migrate, oppure raggiungilo da Conoscenza → Aggiungi fonte → Passa da un helpdesk. Scegli la tua sorgente e la procedura guidata ti accompagna in quattro passi:

PassoCosa succede
1. CollegaInserisci la credenziale in sola lettura. Respondo la verifica e legge il tuo workspace per contare cosa è disponibile da importare.
2. ScegliAttiva le categorie che vuoi, scegli l'agente IA che deve ricevere la conoscenza e, se vuoi, seleziona singoli articoli.
3. AnteprimaRivedi il confronto delle impostazioni del workspace — ogni modifica proposta è mostrata rispetto al tuo valore attuale, e le accetti singolarmente.
4. EseguiL'import gira come job in background con avanzamento live per categoria. Puoi lasciare la pagina e tornare — l'hub mostra la migrazione in corso sulla card del suo provider.

Può girare una sola migrazione alla volta per workspace. Puoi annullare un import in corso dalla schermata di avanzamento, e puoi rieseguire un import in seguito — gli elementi già importati vengono riconosciuti e aggiornati o saltati invece di essere duplicati.

Le conversazioni importate sono native#

Ogni conversazione importata viene assegnata al canale reale usato dal cliente — un ticket arrivato via email diventa una conversazione email nativa, una chat dal messenger di un sito diventa una conversazione widget nativa. Non esiste un canale "migrato" separato né un comportamento speciale da migrazione: le conversazioni importate si filtrano, si cercano, si assegnano e ricevono risposta esattamente come le conversazioni nate in Respondo.

Quando il canale originale non può essere determinato, Respondo colloca la conversazione dove puoi davvero continuarla: se il contatto ha un indirizzo email utilizzabile, diventa una conversazione email; altrimenti diventa una conversazione widget, che non richiede alcun indirizzo per restare leggibile.

Puoi migrare prima e collegare i canali dopo. Le conversazioni importate sono leggibili subito; se il loro canale (per esempio, l'email) non è ancora collegato, il composer ti chiede semplicemente di collegarlo prima di poter rispondere — e una volta fatto, le conversazioni importate diventano automaticamente rispondibili.

Limitazioni#

Cosa può essere importato è delimitato da ciò che l'API pubblica di ciascun vendor espone. La procedura guidata è onesta al riguardo — una categoria che una sorgente non può servire viene mostrata come non disponibile con la ragione, invece di importare silenziosamente il nulla:

  • Le risposte salvate di Intercom non possono essere migrate — l'API pubblica di Intercom non le espone.
  • Le impostazioni di Intercom trasferiscono solo il fuso orario del workspace; l'API non espone gli orari di lavoro.
  • Le conversazioni Intercom molto lunghe (più di circa 500 parti) vengono importate troncate — l'API restituisce al massimo 500 parti per conversazione.
  • Zendesk e Freshdesk supportano tutte e quattro le categorie: conversazioni, knowledge base, risposte riutilizzabili e impostazioni.

Se un'esecuzione termina con alcune categorie fallite, il suo stato viene riportato come parziale e la schermata di avanzamento mostra quale categoria è fallita e perché. Puoi correggere la causa (per esempio, un token API scaduto) ed eseguire di nuovo l'import.