> ## Documentation Index
> Fetch the complete documentation index at: https://docs.feleo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kundendaten und Legitimation

> Kundensystem anbinden oder Kunden einlesen, festlegen, wann eine Person als bestätigt gilt, und was Agenten ändern dürfen.

Agenten finden Kunden und Verträge, bestätigen, dass die Person die richtige ist, lesen ihre Daten und schlagen Änderungen vor, zum Beispiel eine neue Adresse. Das richtest du unter Einstellungen → Integrationen → **„Kunden- & Vertragssuche“** in vier Abschnitten ein. Ändern darf es nur der Inhaber.

## Datenquelle

* **Testkunden:** erfundene Kunden mit Verträgen zum Ausprobieren. Nichts verlässt Feleo.
* **Import aus Datei:** für Systeme ohne Schnittstelle. Feleo hält eine Kopie und liest sie neu ein, von Hand oder täglich aus einem Link.
* **Live über API:** Feleo fragt dein System bei jedem Fall ab und behält den Stand am Fall.

Eine neue Quelle gilt erst, wenn du sie links mit **„Jetzt aktivieren“** einschaltest. Bis dahin arbeiten die Agenten mit der bisherigen Quelle weiter. „Zurück zu den Testkunden“ schaltet jederzeit zurück.

## Verbindung (Live über API)

* **Adresse deines Systems** und **Anmeldung:** API-Schlüssel im Header, Bearer-Token, Benutzer und Passwort, OAuth (Client Credentials) oder keine. Schlüssel und Secrets speichert Feleo verschlüsselt und zeigt sie nie wieder an.
* **Abfragen:** „Suchen“ (Pflicht), „Lesen“ mit Verträgen und optional „Ändern“. Im Pfad stehen Platzhalter: `{suche}` oder ein Feld zum Finden wie `{email}` oder `{kundennummer}`. `{id}` kommt aus dem Suchtreffer.
* Liefert die Suche schon alle Daten, setzt du den Haken **„Die Suche liefert schon alle Daten“**, dann entfällt „Lesen“.
* **Eigener Code statt Abfragen:** für Sonderfälle, mehrere Aufrufe hintereinander oder umgerechnete Werte. JavaScript mit den Funktionen `suchen`, `lesen` und optional `aendern`. `fetch` erreicht nur die eingetragene Adresse und liefert die Antwort direkt, ohne `await`.

## Datei (Import)

CSV oder Excel, eine Zeile je Vertrag, die erste Zeile mit Spaltennamen. Kunden fasst Feleo über die Kundennummer zusammen. Beim nächsten Einlesen wählst du **„Ersetzen“** oder **„Ergänzen“**. Für **„Täglich aus einem Link“** braucht es einen frei abrufbaren HTTPS-Link. Feleo liest dann jeden Morgen neu ein. Importierte Daten kann Feleo nicht ändern.

## Felder

Eine Liste steuert alles. Jedes Feld ordnest du einmal zu, bei Live mit einem Klick in der Antwort deines Systems, beim Import einer Spalte. Danach hat es vier Haken:

* **Finden:** danach sucht Feleo in jeder Nachricht. Nummern erkennt Feleo am Format (`#` steht für eine Ziffer, zum Beispiel `K-####`). Das Format schlägt Feleo aus echten Nummern vor. Absenderadresse und Anrufernummer gelten automatisch. Namen und Adressen sucht der Agent.
* **Nachweis:** zählt für die Bestätigung.
* **Am Fall:** sieht dein Team im Fall, die KI erst nach der Bestätigung.
* **Änderbar:** dürfen Agenten ändern. Bei Live geht das erst mit der Abfrage „Ändern“.

Eigene Felder wie Zählernummer oder Abschlag legst du mit **„Eigenes Feld hinzufügen“** an, für den Kunden oder für den Vertrag. Mit **„Im System öffnen“** erscheint am Fall ein Link in dein System.

Vor dem Aktivieren fragst du unter „Felder“ einen echten Kunden ab. Gelesen wird nur, nichts geändert. Feleo ordnet die Felder danach nach Namen zu, den Rest klickst du an.

## Bestätigung

Ein Kunde gilt als bestätigt, wenn **mindestens so viele Nachweise stimmen**, wie du einstellst. Am Telefon und im Chat kannst du **strenger** sein. Einzelne Nachweise stellst du auf **„muss immer stimmen“**.

* Absenderadresse und Anrufernummer zählen automatisch, wenn sie zum Kunden passen.
* Alles andere muss in der Nachricht stehen, sonst fragt der Agent nach.

Feleo vergleicht selbst und tolerant: Datumsformate, Leerzeichen, Groß- und Kleinschreibung. Die KI sieht gespeicherte Vergleichswerte nie. Reichen die Nachweise schon in der ersten Nachricht, ist der Kunde ohne Rückfrage bestätigt und wird am Kontakt verknüpft.

Mit **„An Fall testen“** prüfst du die Regel an einem echten Fall, zum Beispiel `#1031`. Feleo zeigt, worüber es den Kunden gefunden hat und welche Nachweise gestimmt haben. Es wird nichts verändert.

## Änderungen

* **Beantragen:** Dein Team übernimmt die Änderung im Fall per Klick, erst dann schreibt Feleo in dein System.
* **Direkt übernehmen:** nur bei Agenten auf der Stufe „Automatisch“. Alle anderen beantragen. Im Chat bestätigt die Person die Änderung selbst.

Bei Live geht eine übernommene Änderung danach an dein System. Im Fall steht „freigegeben, wird übertragen“, danach „übernommen“ oder „Übertragung fehlgeschlagen“. Ist unklar, ob sie angekommen ist, wiederholt Feleo sie nicht. Dann steht dort „Übertragung unklar“, und du siehst in deinem System nach.

## Automatisch verarbeiten

Unter **„Automatisch verarbeiten nur, wenn“** legst du fest, wann Fälle auf Stufe 2 oder 3 laufen dürfen: Kunde bestätigt, aktiver Vertrag, Kontaktweg hinterlegt. Alle anderen Fälle bleiben beim Team.

## Grenzen

* nur öffentliche HTTPS-Adressen, Antworten als JSON bis 256 KB, Zeitlimit 15 Sekunden
* eigener Code: höchstens 10 Aufrufe je Lauf, 25 Sekunden
* Import: bis 20.000 Kunden, Dateien bis 20 MB beim täglichen Einlesen
* Telefon: Kundensuche und Bestätigung im Gespräch folgen später


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.