Kontakte

Speichern und verwalten Sie die identifizierten Personen, die mit Ihrem Agenten chatten. Kontakte entstehen automatisch durch die Identitätsprüfung oder werden manuell beziehungsweise per CSV-Import hinzugefügt.

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

Ein Kontakt ist eine identifizierte Person, die mit Ihrem Agenten gechattet hat – im Unterschied zu einem anonymen Besucher. Jeder Kontakt wird über eine unveränderliche Externe ID aus Ihrem eigenen System eindeutig zugeordnet, sodass dieselbe Person über Sitzungen und Geräte hinweg ein einziger Kontakt bleibt.

Ihre Kontakte finden Sie im Tab Kontakte Ihres Agenten.

Was ein Kontakt speichert

Feld	Beschreibung
Externe ID	Die unveränderliche ID aus Ihrem System (der JWT `sub`). Eindeutig pro Agent.
E-Mail	Die E-Mail-Adresse des Kontakts.
Name	Der Anzeigename des Kontakts.
Telefon	Die Telefonnummer des Kontakts.
Benutzerdefinierte Attribute	Beliebige zusätzliche Daten, die Sie anhängen (Tarif, Unternehmen, Stripe-IDs, …).
Zuletzt gesehen	Wird automatisch aktualisiert, sobald der Kontakt chattet.

Kontaktdaten werden gespeichert, damit Sie sie einsehen und segmentieren können. Aus Datenschutzgründen fließen sie nie in die Antworten des Agenten ein – siehe Identitätsprüfung → Datenschutz.

Wie Kontakte entstehen

Automatisch, durch Identitätsprüfung (empfohlen)

Wenn Sie die Identitätsprüfung aktivieren, signiert Ihr Backend für jeden angemeldeten Nutzer ein JWT. Beim ersten Chat eines verifizierten Nutzers erstellt Agentkit aus den Claims des Tokens einen Kontakt und verknüpft die Unterhaltung damit. Spätere Chats aktualisieren denselben Kontakt und erneuern Zuletzt gesehen. Ein separater API-Aufruf ist nicht nötig.

Manuell

Klicken Sie auf Kontakt hinzufügen und geben Sie eine Externe ID (erforderlich) sowie optional Name, E-Mail und Telefon ein. Die Externe ID muss für den Agenten eindeutig sein.

Per CSV-Import

Nutzen Sie Importieren, um Kontakte über eine Tabelle massenhaft zu erstellen oder zu aktualisieren – siehe unten.

Kontakte per CSV importieren

Klicken Sie auf Importieren und laden Sie eine .csv-Datei hoch. Die erste Zeile muss eine Kopfzeile sein. Unterstützte Spalten:

Spalte	Erforderlich	Hinweise
`external_id`	Ja	Eindeutige ID pro Kontakt. Zeilen ohne diese ID werden übersprungen.
`name`	Nein	Bis zu 255 Zeichen.
`email`	Nein	Bis zu 320 Zeichen.
`phone`	Nein	Bis zu 50 Zeichen.

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

Nutzen Sie den Link CSV-Vorlage herunterladen im Import-Dialog, um eine Startdatei zu erhalten.

Limits und Verhalten:

Maximale Dateigröße 5 MB; bis zu 10.000 Zeilen pro Import.
Existiert eine external_id bereits, aktualisiert die Zeile diesen Kontakt, statt ein Duplikat zu erstellen.
Nach dem Import sehen Sie, wie viele Kontakte verarbeitet und wie viele übersprungen wurden.

Kontakte finden

Die Kontakttabelle unterstützt:

Suche über Externe ID, E-Mail, Name und Telefon.
Pagination für große Kontaktlisten.
Einen Umschalter Spalten, um Spalten ein- oder auszublenden.