Zum Hauptinhalt springen
Integrationstests prüfen, ob die Verbindungen deines Agents zu externen Systemen korrekt funktionieren. Dazu gehören Wissensdatenbanken, Anrufweiterleitungen, Kalenderbuchungen, benutzerdefinierte Aktionen und Webhooks.

Diese Seite nutzen, nachdem die Kernfunktionalität funktioniert

Sobald der Agent ein einfaches Gespräch führen kann, prüfe mit dieser Seite, ob auch die umgebenden Geschäftssysteme Ende-zu-Ende funktionieren. Einige Abschnitte dieser Seite solltest du am besten der Person übergeben, die das verbundene System verantwortet. Du kannst die Checkliste trotzdem nutzen, um das kundenseitige Erlebnis zu bestätigen und technische Checks bei Bedarf weiterzugeben.

Wissensdatenbank-Integration

Nachdem du eine Wissensdatenbank erzeugt und zugewiesen hast, prüfe, ob sie im Gespräch funktioniert.
1

Verarbeitungsstatus prüfen

Öffne deine Wissensdatenbank und bestätige, dass alle Einträge grün sind und als einsatzbereit gelten. Einträge, die noch verarbeitet werden oder Fehler zeigen, stehen deinem Agenten noch nicht zur Verfügung.
2

Abrufgenauigkeit testen

Stelle im Testmodus Chat oder Webanruf Fragen, die durch deine Wissensdatenbank beantwortet werden sollten.Öffne nach jeder Antwort die Gesprächsdetails und klicke auf das Symbol für die Wissensabfrage neben der Nachricht des Agents, um zu prüfen:
  • Dass der richtige Wissensauszug abgerufen wurde
  • Dass das Top-Ergebnis klar zur Frage der anrufenden Person passt
  • Dass der Agent die abgerufenen Inhalte korrekt in seiner Antwort verwendet hat
3

Abruflücken testen

Stelle Fragen, die deiner Wissensdatenbank nahe kommen, aber nicht exakt darin stehen. Prüfe:
  • Die Wissenssuche findet trotzdem relevante Inhalte bei paraphrasierten Fragen
  • Der Agent halluziniert keine Antworten für Themen, die nicht in der Wissensdatenbank stehen
4

Nach Änderungen erneut testen

Bearbeite den Wissenseintrag, warte bis er wieder grün ist, und teste dieselben Fragen erneut, um zu bestätigen, dass die aktualisierten Inhalte ausgeliefert werden.
Wenn die Abrufgenauigkeit niedrig ist, sieh dir Kontext vs. RAG an, um die beiden Abrufmodi und ihre Einsatzbereiche zu verstehen.

Anrufweiterleitungen

Teste jedes Weiterleitungsziel, das in deinem Agenten konfiguriert ist.
1

Jede Weiterleitung auslösen

Sage für jede Regel etwas, das sie aktivieren sollte. Prüfe:
  • Der Transfer startet zur richtigen Nummer oder zum richtigen SIP-Ziel
  • Der Agent kündigt die Weiterleitung dem Anrufer an
  • Das Gespräch verbindet sich tatsächlich mit dem Ziel
2

Weiterleitungsfehler testen

Wenn möglich, teste, was passiert, wenn das Weiterleitungsziel nicht erreichbar ist (besetzt, keine Antwort). Prüfe:
  • Der Agent behandelt den Fehler sauber
  • Der Anrufer erhält eine hilfreiche Nachricht
  • Der Agent bietet Alternativen an (Rückruf, Mailbox, erneut versuchen)
3

Gesprächsprotokoll prüfen

Öffne nach dem Test die Gesprächsdetails und prüfe, ob der Tool-Call für die Weiterleitung in der Timeline mit dem richtigen Ziel erscheint.
Siehe Transfer-Tools als Referenz für die Konfiguration.

Kalenderbuchungen

Wenn dein Agent das Buchungstool nutzt:
1

Termin buchen

Gehe den kompletten Buchungsfluss durch: gib Datum, Uhrzeit, Name und Kontaktdaten an.Prüfen:
  • Die Buchung erscheint im verbundenen Kalender (Cal.com oder ein anderer Anbieter)
  • Alle Details sind korrekt (Datum, Uhrzeit, Teilnehmende)
  • Der Agent bestätigt die Buchung dem Anrufer
2

Nicht verfügbare Slots testen

Versuche, eine Zeit zu buchen, die bereits belegt ist oder außerhalb der verfügbaren Zeiten liegt.Prüfen:
  • Der Agent kommuniziert die Nichtverfügbarkeit
  • Der Agent schlägt Alternativzeiten vor
  • Es werden keine doppelten oder Phantom-Buchungen erstellt
3

Buchung mit fehlenden Angaben testen

Gib unvollständige Informationen an, z. B. ein Datum, aber keine Uhrzeit oder keinen Namen.Prüfen:
  • Der Agent fragt nach den fehlenden Pflichtfeldern
  • Der Agent erstellt keine unvollständigen Buchungen
Siehe Kalenderbuchung für die Einrichtung.

Benutzerdefinierte API-Aktionen

Für jede konfigurierte benutzerdefinierte API-Aktion:
1

Aktion auslösen

Sage etwas, das den API-Call auslösen sollte. Prüfe:
  • Das verbundene System erhält die Anfrage
  • Die richtigen Parameter werden gesendet
  • Der Agent kommuniziert die Antwort an den Anrufer
2

Mit ungültigen Eingaben testen

Gib Eingaben an, die die API zu einem Fehler oder einer unerwarteten Antwort führen.Prüfen:
  • Der Agent behandelt Fehler ohne Absturz
  • Der Agent kommuniziert eine hilfreiche Nachricht statt roher Fehlerinformationen
  • Das Gespräch läuft normal weiter
3

API-Timeout testen

Wenn das verbundene System langsam antwortet, prüfe:
  • Der Agent wartet angemessen (nutzt Denk-Sounds oder Füllphrasen)
  • Ein Timeout wird sauber behandelt, wenn das System nicht antwortet
4

In den Gesprächsdetails prüfen

Kontrolliere in der Timeline die Tool-Call-Ereignisse. Prüfe:
  • Die richtige API wurde aufgerufen
  • Die Parameter stimmen mit den im Gespräch gesammelten Daten überein
  • Die Antwortdaten wurden korrekt verwendet

Webhooks

Wenn dein Team Webhooks konfiguriert hat (unter Developers → Webhooks), um Ereignisbenachrichtigungen zu erhalten:
  1. Schließe einen Testanruf ab, der Webhook-Ereignisse auslösen sollte
  2. Prüfe das empfangende System auf eingehende Ereignisse
  3. Verifiziere, dass das Ereignis die Gesprächsdaten enthält, die dein Workflow erwartet
  4. Wenn dein Team den Empfangs-Endpunkt verantwortet, teste die Fehlerbehandlung und bestätige, dass Ereignisse erneut versucht werden

Einen lokalen Webhook-Endpunkt testen

Wenn dein Webhook-Consumer auf deinem eigenen Rechner läuft, mache ihn vor dem Testen vorübergehend mit einem HTTPS-Tunnel erreichbar. Das übernimmt in der Regel eine Entwicklerin, ein Entwickler oder eine technische zuständige Person. Empfohlener Ablauf:
  1. Starte deinen lokalen Webhook-Server.
  2. Mache ihn über einen Tunnel wie ngrok, Cloudflare Tunnel oder ein vergleichbares HTTPS-Forwarding-Tool erreichbar.
  3. Füge die temporäre HTTPS-URL in Developers → Webhooks ein.
  4. Führe ein Testgespräch durch, um Ereignisse zu erzeugen.
  5. Prüfe deine lokalen Logs mit unverändertem Raw-Body und Webhook-Headern, damit die Signaturprüfung funktioniert.
Lass den Empfangs-Endpunkt Ereignisse schnell bestätigen und erledige längere Nacharbeiten erst danach. Das entspricht dem Lieferverhalten, das in Webhook Events beschrieben ist.

Post-Call-Automation

Teste, ob Post-Call-Automationen korrekt ausgelöst werden:
  1. Schließe einen Testanruf ab
  2. Prüfe, ob die konfigurierten Automationen gelaufen sind:
    • E-Mail-Zusammenfassungen wurden versendet
    • Team-Benachrichtigungen wurden erstellt
    • Follow-up-Tasks wurden erstellt, wenn aktiviert
  3. Verifiziere, dass der Inhalt korrekt ist (Zielergebnisse, Analyse, Gesprächszusammenfassung)

Ende-zu-Ende-Testablauf

Für einen umfassenden Integrationstest gehe in einem einzigen Anruf diese komplette Abfolge durch:
1

Anruf starten

Starte über Agent testen mit Chat, Webanruf oder Telefonanruf. Prüfe Begrüßung und Vorstellung.
2

Frage zur Wissensdatenbank stellen

Bestätige, dass Abruf und Antwort korrekt sind.
3

Tool-Aktion auslösen

Buche einen Termin, prüfe eine Bestellung oder löse eine benutzerdefinierte API-Aktion aus.
4

Transfer anfordern

Prüfe, ob der Transfer korrekt verbunden wird.
5

Gespräch prüfen

Öffne die Gesprächsdetails und prüfe:
  • Die Timeline zeigt alle Ereignisse in Reihenfolge
  • Ziele wurden korrekt bewertet
  • Die Post-Call-Analyse lief
  • Webhooks wurden ausgelöst, falls konfiguriert

Nächste Schritte

Testszenarien

Folge allgemeinen Testskripten zur Agentenvalidierung

Edge Cases

Teste Unterbrechungen, Stille und Fehlerbehandlung

Benutzerdefinierte API-Aktionen

Konfiguriere und debugge externe API-Integrationen

Debugging

Analysiere Probleme, die beim Testen gefunden wurden