Gestione del pubblico

Un Pubblico è l'elenco delle persone che il tuo Finn chiamerà (campagne outbound) o che dovrà gestire (segmentazione inbound). Pensalo come una rubrica di contatti, ma con informazioni aggiuntive che aiutano il Finn a personalizzare ogni chiamata.

Prima di iniziare. I due modi per importare i contatti sono il caricamento CSV (il più rapido per elenchi una tantum) e la sincronizzazione CRM (ideale quando i contatti cambiano di continuo). La maggior parte degli utenti parte dal CSV per fare prove, poi passa alla sincronizzazione CRM quando è pronta per la produzione.

Le chiamate di test non richiedono un pubblico reale. Quando provi un Finn su te stesso, non devi configurare alcun pubblico: usa il pulsante "Test on Call" nella pagina del Finn. I pubblici servono per le campagne reali.

Dove trovarlo

Barra laterale → Pubblico.

La pagina Pubblico — tutti gli elenchi di contatti creati, con numero di righe e stato dell'importazione.

La pagina elenca tutti i pubblici creati, con numero di righe e data dell'ultimo aggiornamento. Aprine uno per visualizzare, modificare o esportare i contatti.

Importazione via CSV

Il modo più rapido per importare i contatti.

Intestazioni obbligatorie

Il CSV deve contenere queste colonne, con questi nomi esatti:

name, phone_number, country_code

• name — il nome visualizzato del contatto. Usato dal Finn ("Ciao, parlo con Alice?") e mostrato nelle analisi.
• phone_number — solo cifre locali. Nessun prefisso internazionale, nessuna formattazione.
• country_code — con il + iniziale. Esempi: +1 (USA/Canada), +44 (Regno Unito), +91 (India), +61 (Australia).

Intestazioni facoltative

Ogni colonna aggiuntiva diventa un campo personalizzato a cui il Finn può fare riferimento durante la chiamata. Usala per passare contesto.

name, phone_number, country_code, account_tier, last_order_date, account_manager
Alice Chen, 5551234567, +1, Enterprise, 2026-03-12, Sam Patel
Bob Singh, 9876543210, +91, SMB, 2026-01-05, Maya Lee

Nelle istruzioni o nel workflow del Finn, richiama i campi con la sintassi {{account_tier}}. Esempio:

Saluta il contatto per nome. Se {{account_tier}} è "Enterprise", ricorda che ha accesso al supporto prioritario.

Insidie di formattazione del CSV

• Codifica — salva in UTF-8. Excel a volte usa ISO-8859-1 come predefinito, il che rovina accenti e alfabeti non latini.
• Virgolette — racchiudi tra virgolette doppie i campi che contengono virgole: "Patel, Sam".
• Celle vuote — lasciale vuote, non scrivere null o n/a. La piattaforma li interpreta come stringhe letterali.
• Numeri duplicati — la piattaforma rimuove i duplicati in base a (country_code, phone_number). Vale la prima occorrenza.
• Intestazioni — devono trovarsi nella riga 1. Non aggiungere titoli o istruzioni sopra la riga di intestazione.

Convalida

Dopo il caricamento, la piattaforma convalida ogni riga e mostra:

• Valido — pronto per la chiamata.
• Numero non valido — impossibile interpretare il numero (formato errato, troppo corto, ecc.).
• Duplicato — il numero esiste già in questo pubblico.
• Bloccato — il numero è nell'elenco globale di esclusione dalle chiamate.

Puoi modificare le righe non valide direttamente prima di confermare l'importazione.

Integrazione CRM

Sincronizza i contatti direttamente dal tuo CRM. Nessuna esportazione CSV, nessun dato obsoleto.

CRM supportati

• HubSpot — elenchi, elenchi smart, proprietà dei contatti.
• Salesforce — elenchi, report, oggetti lead/contatto.
• Pipedrive — filtri, entità persona/trattativa.

Connessione

1. Impostazioni → Integrazioni → fai clic sul tuo CRM.
2. Autorizza tramite OAuth (verrai reindirizzato al tuo CRM e poi di nuovo qui).
3. Scegli quali liste/segmenti importare.
4. Imposta una pianificazione di sincronizzazione (ogni 15 min, ogni ora, ogni giorno) oppure sincronizza su richiesta.

Mappatura dei campi

Dopo l'autorizzazione, mappa i campi del tuo CRM sui campi Finn:

Le mappature vengono salvate per ogni connessione CRM. Puoi modificarle in seguito in Impostazioni → Integrazioni → [CRM] → Mappatura campi.

Sincronizzazione bidirezionale

Per impostazione predefinita la sincronizzazione è unidirezionale (CRM → Finn). Per riscrivere gli esiti delle chiamate nel tuo CRM, attiva Outcome Sync durante la configurazione della connessione. Ogni risultato di chiamata diventa una voce nel registro attività del CRM o un aggiornamento di proprietà.

Inserimento manuale

Per contatti occasionali (test, demo): Audience → [Audience] → Aggiungi contatto. Inserisci nome, prefisso internazionale, telefono ed eventuali campi personalizzati.

Segmentazione

All'interno di un'audience puoi creare segmenti, ovvero sottoinsiemi filtrati in base a qualsiasi campo personalizzato.

Esempio: in un'audience da 50.000 righe con tag account_tier, crea un segmento Enterprise che filtra account_tier = "Enterprise". Puoi poi distribuire un Finn diverso solo su quel segmento.

Le definizioni dei segmenti sono dinamiche: quando i contatti sottostanti cambiano, il segmento si aggiorna automaticamente.

Liste di esclusione

Escludi a livello globale i numeri che non devono mai essere chiamati:

• Impostazioni → Conformità → Lista Do Not Call — incolla o carica i numeri.
• I numeri presenti in questa lista vengono esclusi silenziosamente da ogni deployment, indipendentemente dall'audience a cui appartengono.

Usala per disiscrizioni, reclami, numeri segnalati dalle autorità e numeri interni che non vuoi chiamare per errore.

Esportazione

Audience → Esporta → CSV. Include tutti i campi personalizzati e il timestamp di importazione originale.

Limiti di dimensione dell'audience

Hai raggiunto un limite? Vedi Fatturazione e piani →.

Schemi comuni

• Lista fredda — singola audience importata da CSV, distribuita una volta, archiviata.
• Pipeline attiva sincronizzata con il CRM — audience con sincronizzazione automatica di "lead nella fase X." Il deployment viene eseguito di continuo, acquisendo i nuovi lead man mano che arrivano.
• Segmentazione per tier — un'unica audience di grandi dimensioni, più segmenti, Finn diversi per ogni segmento.
• Audience di test — un'audience di 5 righe con il tuo numero e quelli dei colleghi. Usala per ogni prova a vuoto di deployment.

Avanti

• Campagne e deployment → — punta un Finn su un'audience.
• Integrazioni → — riferimento completo per CRM, calendario e webhook.