Contacten

Bewaar en beheer de geïdentificeerde personen die met je agent chatten. Contacten worden automatisch aangemaakt via identiteitsverificatie, of handmatig toegevoegd en via CSV-import.

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

Een contact is een geïdentificeerde persoon die met je agent heeft gechat — in tegenstelling tot een anonieme bezoeker. Elk contact wordt uniek geïdentificeerd via een onveranderlijk extern ID afkomstig uit je eigen systeem, zodat dezelfde persoon over sessies en apparaten heen één en hetzelfde contact blijft.

Je vindt je contacten onder het tabblad Contacten van je agent.

Wat een contact bevat

Veld	Omschrijving
Extern ID	Het onveranderlijke ID uit je systeem (de JWT `sub`). Uniek per agent.
E-mail	Het e-mailadres van het contact.
Naam	De weergavenaam van het contact.
Telefoon	Het telefoonnummer van het contact.
Aangepaste attributen	Extra gegevens die je toevoegt (abonnement, bedrijf, Stripe-ID's, …).
Laatst gezien	Wordt automatisch bijgewerkt telkens wanneer het contact chat.

Contactgegevens worden opgeslagen zodat je ze kunt bekijken en segmenteren. Om privacyredenen worden ze nooit verwerkt in de antwoorden van de agent — zie Identiteitsverificatie → Privacy.

Hoe contacten worden aangemaakt

Automatisch, via identiteitsverificatie (aanbevolen)

Wanneer je identiteitsverificatie inschakelt, ondertekent je backend een JWT voor elke ingelogde gebruiker. De eerste keer dat een geverifieerde gebruiker chat, maakt Agentkit op basis van de claims uit het token een contact aan en koppelt het gesprek eraan. Bij latere chats wordt hetzelfde contact bijgewerkt en de laatst gezien-waarde ververst. Er is geen aparte API-aanroep nodig.

Handmatig

Klik op Contact toevoegen, voer daarna een extern ID in (verplicht), eventueel aangevuld met naam, e-mail en telefoon. Het externe ID moet uniek zijn voor de agent.

Via CSV-import

Gebruik Importeren om in bulk contacten aan te maken of bij te werken vanuit een spreadsheet — zie hieronder.

Contacten importeren via CSV

Klik op Importeren en upload een .csv-bestand. De eerste rij moet een kopregel zijn. Ondersteunde kolommen:

Kolom	Verplicht	Opmerkingen
`external_id`	Ja	Unieke ID per contact. Rijen zonder dit veld worden overgeslagen.
`name`	Nee	Tot 255 tekens.
`email`	Nee	Tot 320 tekens.
`phone`	Nee	Tot 50 tekens.

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

Gebruik de link CSV-sjabloon downloaden in het importvenster om een startbestand te krijgen.

Limieten en gedrag:

Maximale bestandsgrootte 5 MB; tot 10.000 rijen per import.
Als een external_id al bestaat, werkt de rij dat contact bij in plaats van een duplicaat aan te maken.
Na de import zie je hoeveel contacten zijn verwerkt en hoeveel er zijn overgeslagen.

Contacten zoeken

De contactentabel ondersteunt:

Zoeken op extern ID, e-mail, naam en telefoon.
Paginering voor grote contactenlijsten.
Een schakelaar Kolommen om kolommen te tonen of te verbergen.