Skip to Content

Importa contatti

Importa contatti permette di caricare un CSV e decidere dove quei contatti devono essere usati.

I contatti possono essere associati a una campagna outbound del dialer oppure a un agente per il recupero del contatto nelle chiamate inbound.

Prepara prima il CSV

Per l'import minimo basta un CSV con una sola colonna: phone.

Seleziona l'uso corretto

Scegli l'uso in base a dove la lista deve essere disponibile.

Dopo aver selezionato Usage, RocketAiFlow mostra automaticamente la campagna per i contatti outbound oppure l'agente per i contatti inbound.

La gestione dei duplicati cambia in base all'uso. Per i contatti inbound, RocketAiFlow controlla il numero di telefono e non inserisce nel database contatti con lo stesso numero. Per i contatti di una campagna outbound, questo controllo di unicità non viene applicato: i duplicati vengono accettati.
  • Usa AI Dialer Flows quando i contatti devono essere collegati a una campagna outbound.
  • Usa Inbound Ai quando l'agente deve recuperare automaticamente i dati del contatto associato al numero che sta chiamando.

Seleziona la campagna o l'agente

Campagna outbound

Per l'outbound, seleziona la campagna che deve ricevere i contatti importati. Il contatto può fornire valori per greeting, variabili del prompt, contesto delle functions e review della chiamata.

I contatti importati nella campagna vengono consumati. Un contatto esce dalla lista attiva quando il customer risponde oppure quando tutti i tentativi previsti sono stati eseguiti e viene raggiunto il retry massimo. Quando la lista è esaurita, carica nuovi contatti oppure usa l'opzione ricarica contatti per renderli di nuovo disponibili.

Agente inbound

Per l'inbound, seleziona l'agente che deve usare i contatti importati tramite Contatti inbound.

Recupero contatto inbound: le variabili inbound funzionano solo quando l'agente può recuperare i dati contatto e Contatti inbound contiene un contatto con numero di telefono uguale al chiamante.
  1. Gli Agent settings permettono il recupero del contatto da Contatti inbound.
  2. Contatti inbound contiene una lista caricata con un contatto che corrisponde al numero chiamante.
  • Se una variabile del template non esiste sul contatto trovato, non viene renderizzata.
  • I valori custom devono essere salvati come key-value dentro data, così i template possono usare percorsi come {t.data.birthDate}.

Mappatura minima

Mappa almeno Phone. Tutti gli altri campi sono opzionali, ma i nomi colonna devono essere chiari e coerenti prima dell'upload.

Campi del contatto

FieldObbligatorioUso
phoneNumero di telefono di destinazione usato per la chiamata outbound.
contactIdNoIdentificatore esterno usato per collegare contatti e chiamate RocketAiFlow a CRM, database o sistemi sorgente.
nameNoNome del contatto, disponibile per personalizzazione e contesto.
surnameNoCognome del contatto, disponibile per personalizzazione e contesto.
dataNoOggetto JSON libero per campi custom. I valori qui salvati sono disponibili durante la chiamata e possono essere usati come contesto dell'agente.
priorityNoPriorità del contatto. Se omessa, RocketAiFlow carica il contatto con priorità 1. I contatti con priorità più alta vengono selezionati prima.
scheduledAtNoData e ora in cui il contatto diventa idoneo per essere chiamato.
Schermata Importa contatti con upload CSV e mappatura dei campi phone, contactId, name, surname, data, priority e scheduledAt.
Import CSV e mappatura campi

Controlla l'avanzamento import

Dopo l'avvio dell'import, rivedi i contatori per capire se il file è stato accettato correttamente.

  • Processed
  • Inserted
  • Failed
  • Skipped

File CSV caricati

La lista dei file CSV caricati mostra tutti gli import e le opzioni disponibili per ogni file. Usala per rivedere gli upload precedenti, controllare lo stato dell'import e accedere ad azioni come ricarica contatti quando una campagna deve rendere nuovamente disponibili i contatti.

Lista file CSV caricati in RocketAiFlow con stato import e opzioni disponibili. left side
Lista file CSV caricati in RocketAiFlow con stato import e opzioni disponibili. right side
Lista file CSV caricati

Problemi comuni di import

  • i valori phone sono mancanti o non validi
  • la colonna sbagliata è stata mappata su Phone

Checklist di validazione

  • il numero atteso di contatti è stato processato
  • le righe valide sono state inserite
  • le righe fallite sono comprese

Prossimi passi

Last updated on