Probleme mit Webhooks
Der Incoming Webhook antwortet nicht, Werte fehlen im Gespräch, die Begrüßung verzögert sich oder die Statistik zeigt Fehler.
Der Incoming Webhook lädt beim Klingeln Daten aus deinem System, etwa den Namen des Anrufers aus deinem CRM. Die Antwort steht danach als Variablen in Begrüßung und Prompt bereit. Wie gut er läuft, zeigen die Webhook Statistiken der letzten 24 Stunden und die Letzten Webhook-Aufrufe im Reiter Persönlichkeit.
Der Webhook schlägt fehl
| Mögliche Ursache | Lösung |
|---|---|
| Dein Endpunkt antwortet nicht mit Status 200 | Nur eine Antwort mit 200 zählt als Erfolg. Prüfe das Log deines Systems |
| Die Antwort ist kein JSON-Objekt | Antworte mit einem Objekt, etwa {"name": "Max Muster"}. Eine Liste oder reiner Text wird nicht als Variablen übernommen |
| Header fehlen oder sind falsch | Prüfe unter HTTP Headers Name und Wert, etwa Authorization: Bearer … |
| Der Request Body Template ist kein gültiges JSON | Das Dashboard meldet Ungültiges JSON Format. Lass das Feld leer, dann sendet bhomy alle verfügbaren Variablen |
| Dein Endpunkt erlaubt nur bestimmte IP-Adressen | Der Agent ruft aus der Cloud ohne feste IP-Adresse auf. Sichere den Endpunkt mit einem Header statt mit einer IP-Freigabe |
So testest du es: Klicke auf Webhook testen › Test senden. bhomy schickt eine Anfrage mit Beispieldaten und zeigt die Antwort.
Die Begrüßung kommt verspätet
Die Begrüßung wartet, bis dein Webhook geantwortet hat, denn sie kann Werte daraus enthalten. Antwortet dein System nicht rechtzeitig, versucht bhomy es noch 2-mal. Erst danach beginnt das Gespräch mit den Fallback-Werten.
| Lösung | Wirkung |
|---|---|
| Timeout senken, empfohlen 3.000 bis 5.000 Millisekunden | Ein langsames System verzögert die Begrüßung weniger |
| Schnell antworten | Lies nur die Felder, die du brauchst, und nutze einen Index für die Suche nach der Rufnummer |
| Fallback-Werte hinterlegen | Das Gespräch klingt auch ohne Antwort natürlich |
Werte fehlen im Gespräch
| Mögliche Ursache | Lösung |
|---|---|
| Der Platzhalter heißt anders als das Feld in der Antwort | {{Vorname}} braucht in der Antwort genau "Vorname" |
| Der Wert steckt in einem verschachtelten Objekt | Antworte flach, etwa {"kunde_name": "…"} statt {"kunde": {"name": "…"}} |
| Der Webhook ist fehlgeschlagen, und es gibt keinen Fallback-Wert | Hinterlege unter Fallback-Werte einen Ersatz. Das Dashboard listet Variablen ohne Fallback unter Fehlende Fallback-Werte |
Die Statistik zeigt eine hohe Fehlerrate
Die Meldung Hohe Fehlerrate! erscheint, wenn viele Aufrufe der letzten 24 Stunden gescheitert sind. Öffne Letzte Webhook-Aufrufe: dort steht je Aufruf, ob er gelang und wie lange er dauerte. Häufen sich Zeitüberschreitungen, ist dein System zu langsam. Häufen sich Fehlercodes, prüfe Adresse und Header.
Der Webhook nach dem Anruf kommt nicht an
Das ist das Tool CRM Ticket unter Automation. Siehe Integrationen.
Weiterhilfe
Schick uns den Zeitpunkt des Anrufs, die Antwortzeit aus Letzte Webhook-Aufrufe und den Statuscode deines Systems, siehe Problem melden.
War diese Seite hilfreich?