Contacts

Stockez et gérez les personnes identifiées qui discutent avec votre agent. Les contacts sont créés automatiquement lors de la vérification d’identité, ou ajoutés manuellement et via l’import CSV.

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

Un Contact est une personne identifiée qui a discuté avec votre agent — par opposition à un visiteur anonyme. Chaque Contact est identifié par un ID externe immuable qui provient de votre propre système, de sorte que la même personne reste un seul et même Contact d’une session et d’un appareil à l’autre.

Retrouvez vos contacts dans l’onglet Contacts de votre agent.

Ce qu’un Contact stocke

Champ	Description
ID externe	L’identifiant immuable provenant de votre système (le `sub` du JWT). Unique par agent.
E-mail	L’adresse e-mail du contact.
Nom	Le nom d’affichage du contact.
Téléphone	Le numéro de téléphone du contact.
Attributs personnalisés	Toute donnée supplémentaire que vous associez (forfait, entreprise, identifiants Stripe, …).
Dernière activité	Mis à jour automatiquement à chaque échange du contact.

Les données de contact sont stockées pour que vous puissiez les consulter et les segmenter. Pour des raisons de confidentialité, elles ne sont jamais injectées dans les réponses de l’agent — voir Vérification d’identité → Confidentialité.

Comment les Contacts sont créés

Automatiquement, via la vérification d’identité (recommandé)

Lorsque vous activez la vérification d’identité, votre backend signe un JWT pour chaque utilisateur connecté. La première fois qu’un utilisateur vérifié discute, Agentkit crée un Contact à partir des informations (claims) du token et y associe la conversation. Les discussions suivantes mettent à jour ce même Contact et actualisent sa Dernière activité. Aucun appel API distinct n’est nécessaire.

Manuellement

Cliquez sur Ajouter un contact, puis saisissez un ID externe (obligatoire), ainsi qu’un nom, un e-mail et un téléphone facultatifs. L’ID externe doit être unique pour l’agent.

Par import CSV

Utilisez Importer pour créer ou mettre à jour des contacts en masse à partir d’une feuille de calcul — voir ci-dessous.

Importer des contacts via CSV

Cliquez sur Importer et importez un fichier .csv. La première ligne doit être une ligne d’en-tête. Colonnes prises en charge :

Colonne	Obligatoire	Remarques
`external_id`	Oui	Identifiant unique par contact. Les lignes qui en sont dépourvues sont ignorées.
`name`	Non	255 caractères maximum.
`email`	Non	320 caractères maximum.
`phone`	Non	50 caractères maximum.

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

Utilisez le lien Télécharger le modèle dans la boîte de dialogue d’import pour obtenir un fichier de départ.

Limites et comportement :

Taille de fichier maximale : 5 Mo ; jusqu’à 10 000 lignes par import.
Si un external_id existe déjà, la ligne met à jour ce contact au lieu d’en créer un doublon.
Après l’import, vous verrez combien de contacts ont été traités et combien ont été ignorés.

Rechercher des contacts

Le tableau des contacts prend en charge :

La recherche sur l’ID externe, l’e-mail, le nom et le téléphone.
La pagination pour les longues listes de contacts.
Un bouton Colonnes pour afficher ou masquer des colonnes.