> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/epic-ai-platform/epic-ai-platform/ai-agent/inbox/kontakte.md). # Kontakte ### Wo finde ich die Kontakte? Navigiere über die linke Seitenleiste zu *Inbox → Kontakte*. Dort werden alle vorhandenen Kontakte in einer Tabelle aufgelistet. Die Tabelle zeigt folgende Spalten: *Name*, *E-Mail*, *Telefonnummer*, *Adresse* und *Erstellt am*. Über die Suchleiste oben suchst du gezielt nach einem bestimmten Kontakt. {% hint style="info" %} Kontaktdaten lassen sich auch direkt aus der Inbox heraus pflegen. Öffnest du eine Konversation, werden auf der rechten Seite die Kontaktdaten des jeweiligen Gesprächspartners angezeigt. Dort kannst du Daten einsehen, bearbeiten und den Kontakt mit einer Organisation verknüpfen. {% endhint %} *** ### Erklärung – Was genau sind Kontakte? Ein Kontakt ist ein Datensatz, der eine einzelne Person repräsentiert, die mit deinem space.vars.TERM\_AI\_AGENT kommuniziert hat. Kontakte werden automatisch angelegt, sobald eine erste Konversation startet. Dabei werden bekannte Datenfelder vorausgefüllt – die Informationen sind jedoch zunächst oft unvollständig und sollten manuell ergänzt werden. Kontaktiert eine Person deinen space.vars.TERM\_AI\_AGENT über mehrere Kanäle (z. B. Chat und Telefon), werden die Konversationen einem gemeinsamen Kontakt zugeordnet, sofern es einen gemeinsamen Nenner wie E-Mail-Adresse oder Telefonnummer gibt. #### Kontaktdaten Für jeden Kontakt stehen folgende Datenfelder zur Verfügung: * **Name:** Der Name der Person. * **Telefonnummer:** Die Telefonnummer des Kontakts. * **E-Mail-Adresse:** Die E-Mail-Adresse des Kontakts. * **Sprache:** Die Sprache des Kontakts (z. B. `DE`). * **Hausnummer:** Hausnummer der Adresse. * **Straße:** Straßenname der Adresse. * **Postleitzahl:** PLZ der Adresse. * **Stadt/Ort:** Stadt oder Ort der Adresse. * **Land:** Land der Adresse. #### Organisationen Im Bereich *Organisationen* eines Kontakts siehst du, welchen Organisationen dieser Kontakt zugeordnet ist. Besteht noch keine Verknüpfung, wird der Hinweis *Der Kontakt ist mit keiner Organisation verknüpft* angezeigt. Über den Button *Organisation verknüpfen* ordnest du den Kontakt einer bestehenden Organisation zu. #### Konversationen Im Bereich *Konversationen* werden alle Konversationen aufgelistet, die dieser Kontakt bisher geführt hat. Du siehst das Datum, die Konversations-ID sowie eine Vorschau auf die letzte Nachricht. Mit einem Klick auf einen Eintrag öffnest du die jeweilige Konversation und siehst den Verlauf. Über den Button *Mehr laden* lädst du ältere Konversationen nach. *** ### Verwendung – Wofür werden Kontakte verwendet? * **Wichtige Informationen speichern:** Kontakte bündeln alle relevanten Informationen zu einer Person an einem zentralen Ort. So kannst du bei eingehenden Anfragen schnell auf Name, Telefonnummer, E-Mail-Adresse oder Spracheinstellung zugreifen. * **Interaktionshistorie nachverfolgen:** Über den Bereich *Konversationen* in der Kontaktansicht siehst du chronologisch alle bisherigen Chats und Telefonate, die ein Kontakt mit deinem space.vars.TERM\_AI\_AGENT geführt hat. Das hilft dir, den Kontext früherer Gespräche schnell nachzuvollziehen. * **Schnellzugriff auf Konversationen:** Du kannst jede Konversation direkt aus dem Kontaktprofil heraus öffnen und musst nicht in der Inbox nach einzelnen Gesprächen suchen. * **Organisatorische Zuordnung:** Kontakte lassen sich mit Organisationen verknüpfen. So wird auf einen Blick sichtbar, welche Personen zu welchem Unternehmen gehören. Die Verknüpfung ist in beide Richtungen nutzbar – vom Kontakt zur Organisation und umgekehrt. * **Kontaktdaten direkt in der Inbox pflegen:** Öffnest du in der Inbox eine Konversation, werden rechts die Kontaktdaten des Gesprächspartners angezeigt. Dort kannst du Daten bearbeiten, Tags vergeben, Organisationen verknüpfen und Notizen hinterlegen – ohne den Bereich *Kontakte* separat aufzurufen. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Automatische Erstellung Ein Kontakt wird automatisch angelegt, sobald die erste Konversation mit einer neuen Person startet. Dabei werden bekannte Datenfelder (z. B. die Telefonnummer bei einem Anruf) vorausgefüllt. Die restlichen Felder sind zunächst leer und können manuell ergänzt werden. #### Kontakt manuell erstellen {% stepper %} {% step %} Navigiere über die linke Seitenleiste zu *Kontakte*. {% endstep %} {% step %} Klicke unten rechts auf den Button *Kontakt erstellen*. {% endstep %} {% step %} Fülle den Name aus und wähle die Sprache. {% endstep %} {% step %} Speichere den Kontakt. {% endstep %} {% endstepper %} #### Kontakt bearbeiten Es gibt zwei Wege, einen Kontakt zu bearbeiten: * **Über die Kontaktansicht:** Navigiere zu *Kontakte*, wähle den gewünschten Kontakt aus der Liste und klicke in der Detailansicht auf das jeweilige Feld (z. B. *Telefonnummer hinzufügen*), um den Wert einzugeben oder zu ändern. * **Direkt aus der Inbox:** Öffne eine Konversation – die Kontaktdaten erscheinen rechts. Klicke auf *Kontakt öffnen* für die vollständige Detailansicht oder bearbeite die sichtbaren Felder direkt. #### Organisation verknüpfen {% stepper %} {% step %} Öffne den gewünschten Kontakt in der Detailansicht. {% endstep %} {% step %} Scrolle zum Bereich *Organisationen*. {% endstep %} {% step %} Klicke auf *Organisation verknüpfen*. {% endstep %} {% step %} Suche nach der gewünschten Organisation und wähle sie aus. {% endstep %} {% endstepper %} #### Kontakt löschen Kontakte kannst du über die Tabellenansicht mit einem Klick auf das Mülltonnen-Symbol löschen. Die Kontaktkarte wird unwiderruflich gelöscht – die zugehörigen Konversationen bleiben jedoch erhalten. *** ### Beispiel: Kontakt nach einem Erstgespräch vervollständigen **Szenario:** Ein Kunde ruft zum ersten Mal an. Der space.vars.TERM\_AI\_AGENT erfasst automatisch die Telefonnummer. Nach dem Gespräch möchtest du die restlichen Kontaktdaten ergänzen. {% stepper %} {% step %} Navigiere zu *Kontakte* und suche in der Liste nach der Telefonnummer des Anrufers (z. B. „+4946193069108“). {% endstep %} {% step %} Klicke auf den Kontakt, um die Detailansicht zu öffnen. {% endstep %} {% step %} Ergänze die fehlenden Daten – z. B. Name, E-Mail-Adresse und Adresse (Straße, Hausnummer, PLZ, Stadt/Ort, Land). {% endstep %} {% step %} Scrolle zum Bereich *Organisationen*, klicke auf *Organisation verknüpfen* und wähle die passende Organisation aus. {% endstep %} {% endstepper %} Ab sofort ist der Kontakt vollständig gepflegt und der Organisation zugeordnet. Bei zukünftigen Anrufen wird er automatisch erkannt. *** ### Best Practices * **Hybride Datenpflege:** Nutze einen zweistufigen Prozess, um eine persönliche Kundenansprache sicherzustellen: * **Automatisierte Erfassung durch den** space.vars.TERM\_AI\_AGENT**:** Beim Erstkontakt erfragt der space.vars.TERM\_AI\_AGENT fehlende Stammdaten wie Name, E-Mail-Adresse oder Sprache. Diese werden automatisch hinterlegt, sofern die Felder einen validen Wert besitzen. * **Manuelles Überschreiben nach dem Gespräch:** Ist das Gespräch abgeschlossen, kannst du die erfassten Daten über die Kontaktbearbeitung final prüfen und bei Bedarf korrigieren. So ist beim nächsten Kontakt sofort eine persönliche Anrede möglich. * **Kontaktdaten zeitnah pflegen:** Ergänze fehlende Daten möglichst direkt nach dem ersten Gespräch. Je vollständiger die Daten, desto besser funktioniert die automatische Zuordnung bei zukünftigen Kontaktaufnahmen über verschiedene Kanäle. * **Organisationszuordnung nutzen:** Verknüpfe Kontakte frühzeitig mit der zugehörigen Organisation. So hast du jederzeit einen vollständigen Überblick über alle Ansprechpartner eines Unternehmens und deren gesamte Kommunikationshistorie.