Contatti e segmenti
Prerequisiti
- Permesso di amministrazione (sezione Campagne outbound: panoramica).
L'anagrafica contatti
La scheda Contatti raccoglie l'anagrafica dei destinatari delle campagne outbound: nome, telefono, email e altri attributi. Ogni contatto può essere assegnato a uno o più segmenti.
Il consenso per canale
Per ciascun canale (WhatsApp, SMS, Email) un contatto ha uno stato di consenso indipendente:
- Consenso (opt-in) — il contatto può ricevere campagne su quel canale;
- Revocato (opt-out) — il contatto è escluso dagli invii su quel canale;
- Non noto — nessuna preferenza espressa; il contatto non riceve campagne finché non esprime un consenso esplicito.
Solo i contatti con consenso attivo sul canale della campagna ricevono i messaggi: gli altri vengono conteggiati come "saltati" all'esecuzione (vedi Creare e lanciare una campagna).
Importare contatti da CSV
Il pulsante Importa CSV apre una finestra che permette di scaricare il modello CSV con la struttura corretta e di caricare il file compilato.
Struttura del file (la prima riga di intestazione viene ignorata):
firstName,lastName,phone,email,language
Mario,Rossi,+393331112233,[email protected],it
Luigi,Verdi,,[email protected],it
Regole di importazione:
- sono richieste almeno le colonne
firstName,lastName,phone,email; - per ogni riga deve essere presente almeno il telefono o l'email;
- il telefono, se presente, deve essere in formato internazionale (
+39…); - la colonna
languageè opzionale.
Al termine dell'importazione compare un riepilogo con il totale delle righe, i contatti importati e quelli saltati, con l'elenco degli eventuali errori riga per riga.
Creare e usare i segmenti
Un segmento è un gruppo nominato di contatti, destinatario di una campagna. Dalla scheda Segmenti si creano i gruppi; i contatti possono essere assegnati a un segmento singolarmente oppure in modo massivo, selezionando più righe dall'elenco contatti e usando l'azione "Assegna a segmento".
Sincronizzazione da CRM esterno
È disponibile un endpoint di sincronizzazione per collegare l'anagrafica contatti a un CRM esterno del cliente, con logica di upsert (aggiornamento se il contatto esiste già, creazione altrimenti). La configurazione è tecnica e non è richiesta per il normale utilizzo delle campagne dalla console.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il file CSV viene scartato | Colonne obbligatorie mancanti o formato non conforme | Scaricare nuovamente il modello e verificarne la struttura |
| Alcune righe vengono saltate durante l'import | Manca sia il telefono sia l'email nella riga, oppure il telefono non è in formato internazionale | Correggere la riga secondo le regole di importazione e ripetere il caricamento |
| Un contatto non riceve una campagna | Consenso "Revocato" o "Non noto" sul canale della campagna | Verificare e, se necessario, aggiornare il consenso del contatto |