Documentation Index
Fetch the complete documentation index at: https://docs.fonio.ai/llms.txt
Use this file to discover all available pages before exploring further.
Übersicht
Der Webhook während des Anrufs wird mitten im Gespräch ausgelöst – basierend auf einer Bedingung, die du selbst definierst. Fragt ein Anrufer nach einer bestimmten Information, z.B. dem Status einer Bestellung, holt der Assistent diese Information in Echtzeit über eine externe API ab und gibt die Antwort direkt im Gespräch zurück.
Typischer Anwendungsfall: Ein Anrufer fragt nach dem Status seiner Lieferung. Der Assistent fragt die Bestellnummer ab, ruft das externe System ab und liest das Ergebnis vor.
Wie es funktioniert
- Anrufer stellt eine Frage, die der definierten Bedingung entspricht
- fonio sendet POST-Request an die Webhook-URL
- Assistent gibt eine Wartemeldung aus (bis zu 5 Sekunden)
- Externes System (z.B. n8n) sucht die Daten heraus
- Daten werden an den Assistenten zurückgegeben
- Assistent beantwortet die Frage des Anrufers
Konfiguration in fonio
- Navigiere zu deinem Assistenten → Webhooks
- Aktiviere den Webhook während des Anrufs
- Wähle als Methode POST
- Füge die Webhook-URL deines Automatisierungstools (z.B. n8n) ein
- Füge eine Beschreibung und Bedingung hinzu, die definiert, wann der Webhook ausgelöst wird
- Definiere eine Wartemeldung, die der Assistent während der Verarbeitung ausspricht
- Konfiguriere die dynamischen Parameter, die mit dem Request mitgesendet werden
Beschreibung & Bedingung
Beschreibe klar, wann der Webhook ausgelöst werden soll. Beispiel:
“Gib Bestellinformationen zurück, wenn der Anrufer den Status seiner Bestellung erfahren möchte.”
Je konkreter die Bedingung, desto zuverlässiger löst der Assistent den Webhook zum richtigen Zeitpunkt aus.
Wartemeldung
Da der API-Request bis zu 5 Sekunden dauern kann, kannst du eine Meldung konfigurieren, die der Assistent in dieser Zeit ausspricht. Beispiel:
“Einen Moment, ich suche die Informationen zu Ihrer Bestellung heraus.”
Dynamische Parameter
Dynamische Parameter legen fest, welche Information aus dem Gespräch extrahiert und mit dem Webhook-Request mitgesendet wird. Im Unterschied zur Inbound Webhook – die nur from_number und to_number übergibt – kann der During-Call Webhook spezifische Werte aus dem Gespräch herausziehen (z.B. eine Bestellnummer).
Dynamische Parameter einrichten:
Nutze den integrierten Parameter-Builder in fonio. Du kannst:
- Beschreiben, was extrahiert werden soll (in natürlicher Sprache)
- Einen Screenshot deiner API-Struktur hochladen
- Beispielwerte manuell eintragen
fonio stellt außerdem einen Generator (verknüpft mit ChatGPT) zur Verfügung, der dir beim Aufbau des richtigen JSON-Schemas hilft.
Beispiel für einen dynamischen Parameter:
| Parameter | Beschreibung | Beispielwert |
|---|
order_number | Bestellnummer, die der Anrufer nennt | BP20260016 |
Tipp: Teile dem Assistenten immer mit, in welchem Format der gesuchte Wert vorliegt. Füge z.B. folgendes in den Prompt ein: „Die Bestellnummer hat immer das Format BP20260001.” Das verbessert die Erkennungsgenauigkeit erheblich – ohne diesen Hinweis kann es passieren, dass der Assistent den Wert falsch aufnimmt oder falsch formatiert.
Beispiel-Workflow mit n8n und Google Sheets
Ziel
Wenn ein Anrufer seine Bestellnummer nennt, wird diese in einer Google-Sheets-Auftragsliste nachgeschlagen und die Bestelldetails an den Assistenten zurückgegeben.
Schritt 1 – Webhook-Node in n8n anlegen
Erstelle in n8n einen neuen Workflow mit einem Webhook-Node als Startpunkt. Die generierte Webhook-URL kopierst du in das During-Call-Webhook-Feld in fonio.
Schritt 2 – Google Sheets abfragen
Füge einen Google Sheets Node mit folgender Konfiguration hinzu:
| Einstellung | Wert |
|---|
| Operation | Get Row |
| Dokument | Deine Auftragsliste (z.B. Auftragsliste) |
| Sheet | Gewünschtes Sheet |
| Filter-Spalte | Auftragsnummer |
| Filter-Wert | {{ $json.order_number }} |
order_number aus dem fonio-Webhook mit einem Eintrag in der Spalte Auftragsnummer übereinstimmt, gibt Google Sheets alle Felder dieser Zeile zurück.
Beispielstruktur der Google Sheets Auftragsliste:
| Auftragsnummer | Kunde | Produkt | Liefertermin | Status |
|---|
| BP20260016 | Muster GmbH | Kabelbinder, Marker, Post-its | 15. April 2026 | In Zustellung |
Schritt 3 – Daten an fonio zurückgeben
n8n sendet die Antwort automatisch zurück an fonio. Der Assistent erhält alle Felder der gefundenen Zeile als Variablen und kann dem Anrufer direkt antworten.
Assistent konfigurieren
Verhaltensregel im System-Prompt
Definiere, wann der Webhook ausgelöst werden soll, und welche Information vorher abgefragt werden muss:
Wenn jemand den Status seiner Bestellung wissen möchte, frage zuerst nach der Bestellnummer.
Die Bestellnummer hat immer das Format BP20260001.
Das Format der gesuchten Information anzugeben ist entscheidend. Ohne diesen Hinweis kann der Assistent den Wert aus dem gesprochenen Gespräch möglicherweise nicht zuverlässig erfassen.
Beispiel-Gesprächsverlauf
Anrufer: "Hallo, ich habe vor einiger Zeit bestellt, aber noch nichts erhalten.
Können Sie mir sagen, was der Status ist?"
Assistent: "Natürlich! Können Sie mir bitte Ihre Bestellnummer nennen?"
Anrufer: "Ja, die ist BP20260016."
Assistent: "Einen Moment, ich suche die Informationen zu Ihrer Bestellung heraus."
[Webhook wird ausgelöst, n8n fragt Google Sheets ab]
Assistent: "Ihre Bestellung BP20260016 befindet sich aktuell in Zustellung.
Der geplante Liefertermin ist der 15. April 2026.
Die Bestellung enthält Kabelbinder, Marker und Post-its.
Kann ich Ihnen sonst noch weiterhelfen?"
Fehlerbehebung
Falls der Webhook nicht ausgelöst wird oder falsche Daten zurückgibt, hilft ein Blick in die Executions in n8n:
- Wurde der Webhook überhaupt getriggert?
- Welche
order_number wurde übermittelt – wurde sie korrekt erkannt?
- Hat Google Sheets einen Treffer zurückgegeben?
- Welche Felder wurden an fonio zurückgesendet?
Jeder Anruf erzeugt einen eigenen Execution-Eintrag mit allen Zwischenschritten und übertragenen Werten – das erleichtert die Diagnose erheblich.
Weitere Webhook-Typen
fonio unterstützt insgesamt drei Webhook-Typen:
| Webhook | Zeitpunkt | Typischer Use Case |
|---|
| Inbound Webhook | Vor dem Anruf | Kundendaten nachschlagen, personalisierte Begrüßung |
| During-Call Webhook | Während des Anrufs | Echtzeit-Daten abrufen oder übergeben |
| Post-Call Webhook | Nach dem Anruf | Gesprächsergebnis speichern, Follow-up-Aktionen auslösen |
