Webhooks

Webhook-Beispiele

Mit einem Webhook sendet Voys eine HTTP-Anfrage an eine URL Deiner Wahl, sobald jemand anruft. Was dann passiert, entscheidest Du: Dein Server verarbeitet die Anfrage und sendet etwas zurück – der Anruf läuft dann entsprechend weiter. Zum Beispiel: automatisches Routing basierend auf Deinen eigenen Daten, Anzeige des Anrufernamens auf dem Hörer oder einfach einen Ping an Zapier.

Schau Dir unbedingt die Anrufbenachrichtigungen an, um die Möglichkeiten Deines Telefondienstes voll auszuschöpfen.

Kurzversion: Anrufer ruft an → Voys sendet eine Anfrage an Deine URL → Dein Server antwortet mit einem Status (und optional zusätzlichen Daten) → Voys führt den Anruf entsprechend fort.

Felder im Formular

• Name — so findest Du ihn später in Deinem Anrufplan wieder
• Beschreibung — nur für Dich, hat keine weitere Funktion
• Caller ID-Durchleitung — welche Nummer der Empfänger sieht: Anrufernummer, angerufene Nummer oder unterdrückt
• URL-Vorlage — die URL, die aufgerufen wird, siehe unten für die Variablen
• Menü verwenden — aktivieren, wenn der Anrufer zuerst einen Code eingeben muss (IVR-Stil). Fügt 5 zusätzliche Felder hinzu: Timeout, Anzahl der Versuche, Startnachricht, Fehlermeldung, Timeout-Nachricht

Variablen für Deine URL-Vorlage

{code}        the entered code (only relevant if the menu is on)
{did}         the number that was dialed
{callerid}    the caller's number
{callername}  caller's name, if known

Beispiel:

http://webrouting.voys.nl/test.py?code={code}&callerid={callerid}

Voys füllt diese vier Variablen automatisch aus, bevor die Anfrage gesendet wird.

Einrichtung im Anrufplan

1. Gehe zu Anrufplan, wähle die Nummer
2. Klicke auf das Plus, füge einen Schritt hinzu
3. Wähle Webhook als Typ, wähle Deinen Webhook aus
4. Du bekommst automatisch zwei Pfade: HTTP und Menü erfolgreich und HTTP oder Menü fehlgeschlagen

In beiden Pfaden kannst Du Deine normalen Anrufplan-Schritte verwenden, plus zwei zusätzliche Funktionen: variabler Anrufername und variables Ziel (siehe unten).

Was Du zurücksendest

Dein Server antwortet im Format application/x-www-form-urlencoded. Erforderlich: status. Optional: destination und callername.

Status:

ACK   input/request is valid
NAK   input is invalid
ERR   something went wrong

Nur bestätigen:

status=ACK

Zu einer anderen Nummer weiterleiten:

status=ACK&destination=%2B31502102544
status=ACK&destination=215

(destination kann eine externe Nummer oder eine interne Nebenstelle sein)

Namen des Anrufers ändern:

status=ACK&callername=VoysPartners

Variabler Anrufername, drei Varianten

• Webhook — übernimmt den Namen aus der Antwort Deines Servers
• Voranstellen — fügt Deinen Text vor den bestehenden Namen ein
• Ersetzen — ersetzt den Namen komplett durch Deinen Text

(Voranstellen / Ersetzen funktionieren übrigens auch ohne Webhook.)

Variables Ziel

Gibt Dein Server ein destination zurück? Wähle „Variables Ziel" im Routing-Schritt und der Anruf wird automatisch dorthin geleitet.

Beispiele nach Anwendungsfall

1. CRM-Kopplung

Bei einem eingehenden Anruf sendet Voys callerid und did an Dein CRM. Du suchst den Kunden und gibst den Namen zurück, der auf dem Hörer angezeigt werden soll.

URL template:
https://crm.yourcompany.com/webhook?callerid={callerid}&did={did}

Response from your server:
status=ACK&callername=Marieke%20de%20Boer

2. Routing basierend auf einer externen Datenbank

Entscheide selbst, wohin ein Anruf gehen soll – basierend auf dem Anrufer, der angerufenen Nummer oder einem PIN-Code.

URL template:
https://routing.yourcompany.com/lookup?callerid={callerid}&did={did}

Response from your server:
status=ACK&destination=%2B31502102544

3. Anrufe in Google Analytics tracken

Jede Kampagne bekommt eine eigene Nummer aus einem Block. Voys ruft Deine URL mit der Kampagne (did) und dem Anrufer (callerid) auf; Du loggst die Conversion, dann leitet Voys den Anruf zur echten Firmennummer weiter. Hinweis: Der Anruf selbst führt kein JS aus, das Tracking muss also serverseitig erfolgen.

URL template:
https://analytics.yourcompany.com/call-tracking?campaign={did}&callerid={callerid}

Response from your server:
status=ACK&destination=020123456

4. E-Mail / Slack bei verpasstem Anruf

Meist über Zapier: Dein Webhook postet zu einem Zapier Catch Hook, der es an E-Mail, SMS oder Slack weiterleitet.

URL template (Zapier catch hook):
https://hooks.zapier.com/hooks/catch/123456/abcdef?callerid={callerid}&did={did}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "timestamp": "2026-08-18T09:41:02+02:00"
}

5. VIP-PIN-Code

Menü aktiviert, Anrufer gibt einen Code ein, Du prüfst, ob er gültig ist.

URL template:
https://vip.yourcompany.com/check?code={code}&callerid={callerid}

Valid code:
status=ACK&destination=210

Invalid code:
status=NAK

6. Über Zapier zu 300+ Apps

Gleiche Idee wie oben, aber als generischer Trigger. Du kannst alle vier Variablen weitergeben und Zapier entscheiden lassen, was damit passiert – ob Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox und so weiter.

URL template:
https://hooks.zapier.com/hooks/catch/123456/xyz789?callerid={callerid}&did={did}&callername={callername}

What Zapier receives:
{
  "callerid": "+31612345678",
  "did": "0502102544",
  "callername": "Voys Partners"
}

FAQ

Verwandte Seiten

Anrufbenachrichtigungen

E-Mail für verpasste Anrufe mit Zapier

n8n: Gesprächsaufnahmen, Transkripte und Zusammenfassungen protokollieren

Slack für verpasste Anrufe