Incoming Webhook

Name: bhomy
Price: 89 EUR
Availability: InStock
Author: bhomy

Beim Klingeln Daten aus deinem CRM oder System laden und als Variablen in Begrüßung und Prompt nutzen. Anfrage, Antwort, Fallback-Werte und Statistik.

Verfügbar in: ProIndividuellZuletzt geprüft am 25. Oktober 2026

Mit dem Incoming Webhook weiß dein Agent schon beim Klingeln, wer anruft. bhomy schickt die Nummer des Anrufers an deine URL, dein System antwortet mit Daten wie Name, Kundennummer oder letztem Auftrag, und der Agent nutzt sie als Variablen. So begrüßt er Stammkunden mit Namen oder kennt den Stand einer Bestellung.

So funktioniert es

Ein Anruf geht ein.
bhomy schickt eine Anfrage mit den Daten des Anrufs an deine URL.
Dein System sucht den Anrufer und antwortet mit einem JSON-Objekt.
Jedes Feld der Antwort steht als Variable bereit, etwa {{name}}.
Der Agent begrüßt den Anrufer, mit den Werten aus deiner Antwort.

Der Webhook läuft bei eingehenden Anrufen. Bei ausgehenden Anrufen übergibst du die Daten direkt im context der Outbound-API.

Einrichten

Öffne deinen Agenten und bleib im Reiter Persönlichkeit.
Öffne den Abschnitt Incoming Webhook und schalte Webhook aktiviert ein.
Wähle die Methode: POST oder GET.
Trag die Webhook URL ein, etwa die Produktions-URL eines n8n-Webhooks.
Setze das Timeout (ms). Empfohlen sind 3.000 bis 5.000 Millisekunden.
Optional: Trag HTTP Headers ein, etwa Authorization mit einem geheimen Token.
Optional: Lege ein Request Body Template fest. Leer gelassen, sendet bhomy alle verfügbaren Variablen.
Hinterlege Fallback-Werte für den Fall, dass dein System nicht antwortet.
Prüfe alles mit Webhook testen › Test senden und speichere.

Die Anfrage

Ohne eigenes Template schickt bhomy diese Felder. Bei POST als JSON im Body, bei GET als Query-Parameter:

Feld	Inhalt
`callId`	eindeutige ID des Anrufs
`fromNumber`	Nummer des Anrufers im Format E.164
`toNumber`	angerufene Nummer im Format E.164
`roomName`	interne Kennung der Gesprächssitzung
`participantIdentity`	interne Kennung des Anrufers in der Sitzung
`assistantId`	ID deines Agenten
`assistantName`	Name deines Agenten

{
  "callId": "call_8f2a1c",
  "fromNumber": "+491701234567",
  "toNumber": "+494012345678",
  "roomName": "call-8f2a1c",
  "participantIdentity": "sip_+491701234567",
  "assistantId": "6a90…",
  "assistantName": "Empfang Praxis Sommer"
}

Mit einem eigenen Request Body Template bestimmst du den Aufbau selbst und setzt die Felder als Platzhalter ein, etwa:

{ "phone": "{{fromNumber}}", "line": "{{toNumber}}", "source": "bhomy" }

Die Antwort

Antworte mit Status 200 und einem flachen JSON-Objekt. Jedes Feld wird zur Variable:

{
  "name": "Anna Berger",
  "kundennummer": "K-10442",
  "letzter_termin": "12. Oktober",
  "offene_rechnung": "nein"
}

Im Prompt und in der Begrüßung nutzt du die Werte mit doppelten geschweiften Klammern:

Begrüßung: Guten Tag {{name}}, schön, dass Sie anrufen. Wie kann ich helfen?

Zeitverhalten und Fallback-Werte

Die Begrüßung wartet, bis dein Webhook geantwortet hat. Antwortet dein System nicht mit 200 oder nicht innerhalb des Timeouts, versucht bhomy es noch 2-mal mit kurzer Pause. Bleibt es dabei, beginnt das Gespräch mit den Fallback-Werten. Jeder Fallback-Wert gilt auch dann, wenn deine Antwort ein Feld nicht enthält.

Variable	Fallback	Begrüßung ohne Antwort
`name`	`liebe Kundin, lieber Kunde`	„Guten Tag liebe Kundin, lieber Kunde …“

Das Dashboard listet unter Fehlende Fallback-Werte jede Variable, die in Prompt oder Begrüßung vorkommt und keinen Fallback hat. Ohne Fallback und ohne Antwort entfernt bhomy den Platzhalter.

Sicherheit

Punkt	Empfehlung
Anmeldung	Prüfe in deinem System einen geheimen Header, etwa `Authorization: Bearer …`. Feste IP-Adressen gibt es nicht, der Agent ruft aus der Cloud auf
Verschlüsselung	Nutze eine HTTPS-Adresse
Datensparsamkeit	Antworte nur mit Feldern, die der Agent im Gespräch braucht. Alles in der Antwort kann er dem Anrufer sagen

Statistik und letzte Aufrufe

Unter Webhook Statistiken siehst du für die letzten 24 Stunden die Zahl der Aufrufe, die Erfolgsquote, die durchschnittliche Antwortzeit und die Fehler. Letzte Webhook-Aufrufe zeigt jeden Aufruf einzeln. Die Statistik füllt sich ab dem ersten echten Anruf. Bei vielen Fehlern hilft Probleme mit Webhooks.

War diese Seite hilfreich?