Anruferkontext

Ohne Anruferkontext muss dein Agent jeden Anrufer nach Name, Kundennummer und Anliegen fragen. Mit Anruferkontext kann schon der erste Satz lauten:

„Guten Tag, Frau Weber. Schön, dass Sie anrufen — geht es wieder um den Vorgang bei der Acme GmbH?"

Die Anrufer-Suche schlägt die Telefonnummer des Anrufers nach, bevor die Begrüßung gesprochen wird, und stellt die gefundenen Werte als Variablen zur Verfügung.

9:36

Aktivieren

Unter Anweisungen → Anruferkontext schaltest du Anrufer-Suche aktivieren ein. Danach erscheinen zwei Reiter:

Der Rest des Agenten arbeitet identisch — die gefundenen Werte sind in beiden Fällen ganz normale {{variablen}}.

Wo die Werte landen

Ein Treffer wirkt an drei Stellen gleichzeitig:

1. Im Gesprächseinstieg — Platzhalter werden gefüllt, bevor der Anrufer das erste Wort hört.
2. Im System-Prompt — der Agent verhält sich von Anfang an anders, je nach Anrufer.
3. Im Gesprächsgedächtnis — auch ohne Platzhalter bekommt der Agent die Daten als stillen Hinweis und kann sie später natürlich einfließen lassen. Der Anrufer hört davon nichts.

Zeitverhalten und Ausfälle

CSV-Datei

Der schnelle Weg — kein Entwickler nötig.

telefon,vorname,nachname,firma,notiz
+49123456789,Max,Mustermann,Acme GmbH,Bestandskunde
+49987654321,Anna,Schmidt,Tech AG,Neuer Lead
0151 12345678,Thomas,Müller,StartUp Inc,Rückruf offen
004930123456,Sarah,Weber,,Letzte Woche angerufen

Rufnummern müssen nicht sauber sein

Beide Seiten werden vor dem Abgleich normalisiert. Diese Schreibweisen finden alle denselben Anrufer:

Passen mehrere Zeilen auf dieselbe Nummer, gewinnt die erste.

Die Datei liegt verschlüsselt und ist nur diesem Agenten zugeordnet. Über Datei ersetzen tauschst du sie aus — die neue gilt ab dem nächsten Anruf.

API-Abfrage

Für Live-Daten aus deinem CRM.

Beispiel-Endpunkt:

https://crm.example.com/api/v1/kunden?telefon={{fromNumber}}

Was dein System zurückgeben muss — gültiges JSON mit Status 2xx, innerhalb von 3 Sekunden:

{
  "data": {
    "id": "C-12345",
    "firstName": "Maria",
    "lastName": "Garcia",
    "isVip": true
  }
}

Antwort-Variablen zuordnen — mit Punkt-Notation:

Die Rufnummer kommt immer im E.164-Format an (+49…). Speichert deine Datenbank anders, rechne im Endpunkt um.

Variablen verwenden

Im Gesprächseinstieg

Guten Tag {{anruferName}}, schön dass Sie anrufen.
Geht es wieder um {{anruferFirma}}?

Im System-Prompt

# Anruferkontext
- Name: {{anruferName}}
- Firma: {{anruferFirma}}
- Notiz: {{anruferNotiz}}

Ist der Anrufer als VIP hinterlegt, behandle das Anliegen
vorrangig. Ist er nicht im System, frage höflich nach dem
Unternehmen.

Auch in Öffnungszeiten-Nachrichten und in der Verabschiedung funktionieren die Platzhalter.

Anrufer-Gedächtnis

Direkt darunter liegt eine verwandte, aber eigenständige Funktion: das Anrufer-Gedächtnis. Ruft dieselbe Nummer erneut an, kennt der Agent die Variablen aus früheren Gesprächen und muss nicht noch einmal dieselben Fragen stellen.

Wenn beides aktiv ist

Liefern Anrufer-Suche und Anrufer-Gedächtnis einen Wert für dieselbe Variable, gewinnt die Anrufer-Suche. Das ist Absicht: CSV oder API sind die aktuelle Quelle, während das Gedächtnis nur ergänzt, was die Suche nicht liefert. Eine Adresse, die sich seit dem letzten Anruf geändert hat, wird so nicht mit einem veralteten Wert überschrieben.

Anruferkontext und Variablenextraktion

Beides greift ineinander, arbeitet aber zu verschiedenen Zeitpunkten:

Systemvariablen

Immer verfügbar, unabhängig von der Anrufer-Suche:

Wenn etwas nicht klappt

Die Begrüßung bleibt unpersönlich

1. Ist Anrufer-Suche aktivieren an und der Agent gespeichert?
2. Stimmt die Schreibweise des Variablennamens exakt?
3. (API) Kam ein 2xx innerhalb von 3 Sekunden? Die Anrufdetails zeigen den Versuch.
4. (API) Ist der JSON-Pfad richtig? data.firstName — nicht $.data.firstName.
5. (CSV) Wurde die Nummer gefunden? Siehe unten.

Die CSV findet nie einen Treffer

Der Endpunkt bekommt nie eine Anfrage

Zum schnellen Gegentest hilft ein Request-Inspector wie webhook.site als temporärer Endpunkt — dort siehst du genau, was ScaleTalk schickt.