Contatti

Memorizza e gestisci le persone identificate che chattano con il tuo agente. I contatti vengono creati automaticamente dalla verifica dell'identità, oppure aggiunti manualmente e tramite importazione CSV.

Reserved integration fields remain read-only: instagram_username, stripe_customer_id, and source.

Un contatto è una persona identificata che ha chattato con il tuo agente, a differenza di un visitatore anonimo. Ogni contatto è identificato da un ID esterno immutabile proveniente dal tuo sistema, quindi la stessa persona resta un unico contatto tra sessioni e dispositivi.

Trova i tuoi contatti nella scheda Contatti del tuo agente.

Cosa memorizza un contatto

Campo	Descrizione
ID esterno	L'id immutabile del tuo sistema (il `sub` del JWT). Univoco per agente.
Email	L'indirizzo email del contatto.
Nome	Il nome visualizzato del contatto.
Telefono	Il numero di telefono del contatto.
Attributi personalizzati	Qualsiasi dato aggiuntivo che colleghi (piano, azienda, ID Stripe, …).
Ultimo accesso	Aggiornato automaticamente ogni volta che il contatto chatta.

I dati dei contatti vengono memorizzati per la consultazione e la segmentazione. Per motivi di privacy, non vengono mai inseriti nelle risposte dell'agente — vedi Verifica dell'identità → Privacy.

Come vengono creati i contatti

Automaticamente, dalla verifica dell'identità (consigliato)

Quando attivi la verifica dell'identità, il tuo backend firma un JWT per ogni utente che ha effettuato l'accesso. La prima volta che un utente verificato chatta, Agentkit crea un contatto a partire dai claim del token e collega la conversazione a esso. Le chat successive aggiornano lo stesso contatto e ne aggiornano l'ultimo accesso. Non è necessaria alcuna chiamata API separata.

Manualmente

Clicca su Aggiungi contatto, poi inserisci un ID esterno (obbligatorio) più nome, email e telefono facoltativi. L'ID esterno deve essere univoco per l'agente.

Tramite importazione CSV

Usa Importa per creare o aggiornare contatti in blocco da un foglio di calcolo — vedi sotto.

Importare i contatti tramite CSV

Clicca su Importa e carica un file .csv. La prima riga deve essere una riga di intestazione. Colonne supportate:

Colonna	Obbligatoria	Note
`external_id`	Sì	Id univoco per contatto. Le righe che ne sono prive vengono ignorate.
`name`	No	Fino a 255 caratteri.
`email`	No	Fino a 320 caratteri.
`phone`	No	Fino a 50 caratteri.

external_id,name,email,phone
import-001,Alice Imported,[email protected],+1 555 000 0001
import-002,Bob Imported,[email protected],+1 555 000 0002

Usa il link Scarica modello CSV nella finestra di importazione per ottenere un file di partenza.

Limiti e comportamento:

Dimensione massima del file 5 MB; fino a 10.000 righe per importazione.
Se un external_id esiste già, la riga aggiorna quel contatto invece di crearne uno duplicato.
Dopo l'importazione vedrai quanti contatti sono stati elaborati e quanti sono stati ignorati.

Trovare i contatti

La tabella dei contatti supporta:

Ricerca su ID esterno, email, nome e telefono.
Paginazione per elenchi di contatti di grandi dimensioni.
Un interruttore Colonne per mostrare o nascondere le colonne.