Live-Daten während eines Anrufs abfragen

Mit dem Skill API Aufrufen kann Ihr Agent zu einem von drei Zeitpunkten im Anrufverlauf Informationen an ein externes System senden oder von dort abrufen: vor, während oder nach dem Anruf.

Dieser Artikel behandelt den Modus während des Anrufs. Dabei löst der Agent mitten im Gespräch eine API-Anfrage aus, je nachdem, was der Anrufer gesagt hat, wartet auf die Antwort und nutzt das Ergebnis ganz natürlich in seiner nächsten Antwort.

Für API-Aufrufe vor dem Anruf (zum Beispiel eine Anruferabfrage) oder nach dem Anruf (zum Beispiel CRM-Protokollierung) siehe API Aufrufen — vor und nach dem Anruf.

Wann Sie ihn nutzen

Nutzen Sie diesen Modus, wenn Ihr Agent:

• Live-Daten auf Grundlage dessen abfragen soll, was der Anrufer gerade gesagt hat (Bestellstatus, Kontostand, Verfügbarkeit)
• Angaben im Gespräch prüfen soll (Gültigkeit einer Mitgliedschaft, Buchungsnummer, ID-Abfrage)
• einen Wert berechnen oder abrufen soll, den er dem Anrufer vorliest (Angebot, Preisschätzung, Lieferzeit)
• eine Automatisierung in Make.com, n8n, Zapier oder einem eigenen Endpunkt auslösen soll, während der Anrufer noch in der Leitung ist

Sind die Daten schon vor dem Anruf verfügbar (oder müssen erst danach gesendet werden), nutzen Sie stattdessen Pre Call oder Post Call.

So funktioniert es

Wenn der Agent den richtigen Moment erkennt, anhand Ihrer Anweisungen im Hauptziel und der Beschreibung des Skills, sendet er eine HTTP-Anfrage an die von Ihnen angegebene URL, wartet auf die Antwort und nutzt das Ergebnis in seiner Antwort.

Sie legen fest:

• Den Endpunkt: URL und HTTP-Methode (GET oder POST)
• Parameter: was in der Anfrage gesendet wird
• Header: Authentifizierungstokens oder eigene Header, falls nötig
• Results: welche Felder der Antwort der Agent sehen und nutzen darf (nur in diesem Modus)

Einrichtung

1. Gehen Sie zu Agent → Fähigkeiten und fügen Sie einen Skill hinzu.
2. Wählen Sie API Aufrufen.
3. Konfigurieren Sie die Felder:
   • Ausführungsreihenfolge: während des Anrufs
   • Aktionsname: ein klarer Name in snake_case, etwa check_order_status. Im Hauptziel verwenden Sie ihn als {{aktionsname}}.
   • Beschreibung: ein kurzer Satz, was die Aktion tut. Der Agent liest ihn, um zu entscheiden, wann er sie nutzt.
   • API-Endpunkt: die vollständige URL Ihres Endpunkts
   • Methode: GET oder POST
   • Parameter (optional): Werte, die mit der Anfrage gesendet werden; siehe „Parameter" unten
   • Results (optional): welche Felder der Antwort der Agent sehen darf; siehe „Results und Path" unten
   • Header (optional): Autorisierungstokens oder eigene Header. Webhook-Endpunkte von Make.com, n8n oder Zapier brauchen meist keine Authentifizierung; lassen Sie das Feld dann leer.
4. Aktivieren Sie den Skill mit dem Schalter.
5. Klicken Sie auf Erstellen.

Parameter: statisch oder dynamisch

Jeder Parameter hat einen Namen und eine Beschreibung. Dieselbe Oberfläche deckt zwei unterschiedliche Fälle ab.

Statische Parameter

Der Agent sendet immer denselben Wert. Tragen Sie den Wert selbst in die Beschreibung ein.

Die Daten an Ihren Endpunkt enthalten dann immer "source": "voice_agent".

Dynamische Parameter

Der Agent soll einen Wert aus dem Gespräch erfassen und senden. Die Beschreibung sagt dem Agenten, worauf er achten soll; das Hauptziel sagt ihm, wann er die Aktion nutzt.

Auszug aus dem Hauptziel:

Möchte der Anrufer seinen Lieferstatus wissen, frage nach seiner Bestellnummer und rufe {{check_order_status}} auf. Nenne ihm dann Status und voraussichtliches Lieferdatum.

Results und Path

Der Bereich Results ist optional und bestimmt, wie der Agent Ihre API-Antwort liest.

• Leer lassen: Der Agent erhält die gesamte Antwort und kann jedes Feld im Hauptziel über seinen Namen verwenden, auch verschachtelte Felder. Einfach einzurichten, aber weniger Kontrolle.
• Result-Einträge hinzufügen: Nur die zugeordneten Felder sind für den Agenten sichtbar. Alles andere bleibt verborgen, praktisch, um Debug-Informationen, interne Kennzeichen oder sensible Daten aus dem Gespräch herauszuhalten.

Jeder Result-Eintrag hat drei Felder:

• Name: der Variablenname, den Sie im Hauptziel verwenden, etwa {{customer_name}}
• Path: die Position des Werts in der JSON-Antwort, mit Punktnotation für verschachtelte Felder
• Beschreibung: was das Feld bedeutet; hilft dem Agenten, es im Gespräch richtig einzusetzen

Beispiel

Gibt Ihr Endpunkt Folgendes zurück:

{
  "customer": {
    "name": "Ferguson",
    "member_tier": "Gold"
  },
  "internal": {
    "secret_code": "XYZ-9921"
  },
  "debug_info": "ignore me"
}

Und Sie konfigurieren:

Dann kann der Agent {{customer_name}}, {{member_tier}} und {{secret_code}} im Prompt verwenden. Das Feld debug_info bleibt vollständig verborgen, da es nicht zugeordnet wurde.

Punktnotation

• Für Felder auf oberster Ebene verwenden Sie direkt den Feldnamen: status
• Für verschachtelte Felder die Punktnotation: customer.membership.tier
• Jeder Result-Eintrag ordnet genau einen Wert zu

Das Hauptziel schreiben

Da die Aktion während des Gesprächs läuft, müssen Sie dem Agenten klar sagen, wann er sie auslöst und wie er die Antwort nutzt. Eine gute Anweisung enthält:

1. Den Auslöser: was der Anrufer sagen oder wollen muss
2. Den Aktionsnamen: welche Aktion aufgerufen wird
3. Was mit dem Ergebnis passiert: welche Felder vorgelesen werden und was gesagt wird

Beispiel:

Fragt der Anrufer nach seiner Lieferung, frage nach seiner Bestellnummer und rufe dann {{check_order_status}} auf. Nenne ihm den Paketstatus mit {{status}} und die voraussichtliche Ankunft mit {{estimated_delivery_date}}.

Beispiel: Sendungsverfolgung

Szenario: Der Anrufer fragt: „Wo ist mein Paket?"

Konfiguration:

• Ausführungsreihenfolge: während des Anrufs
• Aktionsname: check_order_status
• Beschreibung: Sendungsinformationen zu einer Bestellung abrufen
• API-Endpunkt: https://api.shippingcompany.com/tracking
• Methode: GET
• Parameter: order_number (Beschreibung: „die Bestellnummer, die der Anrufer nennt")
• Results:

Auszug aus dem Hauptziel:

Fragt der Anrufer nach seinem Paket oder seiner Lieferung, frage nach seiner Bestellnummer und rufe check_order_status auf. Beantworte die Frage klar mit {{status}} und {{estimated_delivery_date}}.

So verläuft das Gespräch:

Anrufer: „Wo ist mein Paket?"

Agent: „Gern, können Sie mir Ihre Bestellnummer nennen?"

Anrufer: „Die ist 4471."

(Der Agent ruft die API in Echtzeit auf.)

Agent: „Ihr Paket ist unterwegs und sollte am 24. Oktober ankommen."

Weitere Anwendungsbeispiele

Mitgliedschaft prüfen:

Nennt der Anrufer seine Mitgliedsnummer, rufe check_membership_status auf, um zu prüfen, ob sein Konto aktiv ist. Teile es ihm mit {{membership_status}} mit.

Preisabfrage:

Fragt der Anrufer nach einem Angebot, frage nach Produkt und Menge und rufe dann get_price_estimate auf. Lies ihm {{estimated_price}} vor.

Verfügbarkeit live:

Fragt der Anrufer, ob ein Produkt vorrätig ist, frage nach dem Produktnamen und rufe check_stock auf. Nenne ihm {{stock_status}} und, falls verfügbar, {{quantity_available}}.

Gut zu wissen

Leere Results bedeuten: Der Agent sieht alles

Fügen Sie keine Result-Einträge hinzu, liest der Agent die gesamte Antwort. Um bestimmte Felder zu verbergen, müssen Sie Results ausdrücklich einrichten und nur das zuordnen, was sichtbar sein soll.

Keine eingebaute Fehlerbehandlung

Wenn Ihr Endpunkt nicht antwortet, einen Fehler zurückgibt oder leere Felder sendet, hat der Skill keine eingebaute Alternative. Der Agent hat dann einfach keine Daten und verstummt womöglich, bittet um Wiederholung oder erfindet in manchen Fällen etwas.

Ergänzen Sie Ihr Hauptziel immer um ausdrückliche Anweisungen für diesen Fall:

Nenne dem Anrufer seinen Bestellstatus mit {{status}}. Hast du diese Information nicht, entschuldige dich und biete an, per E-Mail nachzufassen.

Ausweichanweisungen sollten konkret sein. Vage Anweisungen führen zu vagen Erfindungen.

Wartezeit wirkt sich auf das Gespräch aus

Der Agent muss auf die Antwort Ihres Endpunkts warten, bevor er weitermacht. Langsame Endpunkte erzeugen unangenehme Pausen. Streben Sie Antwortzeiten unter einer Sekunde an und nutzen Sie den Modus Pre Call, wenn die Daten schon zu Beginn des Gesprächs gebraucht werden.

Authentifizierung

Braucht Ihr Endpunkt eine Authentifizierung, tragen Sie die Zugangsdaten im Feld Header ein (zum Beispiel Authorization: Bearer your-token-here). Viele Webhook-Dienste brauchen keine Header; lassen Sie das Feld dann leer.

Im Modus während des Anrufs erhält Ihr Agent Live-Zugriff auf Ihre Systeme: Er kann Informationen abrufen, Angaben prüfen oder Aktionen in Echtzeit ausführen, ohne dass das Gespräch an Natürlichkeit verliert. Entscheidend ist, genau festzulegen, welche Felder der Agent sehen darf (Path), und ihm klare Anweisungen für Erfolg und Fehlerfall zu geben (Hauptziel).