Webhooks

Webhook-Beispiele

Mit einem Webhook sendet Voys eine HTTP-Anfrage an eine von dir angegebene URL, sobald jemand anruft. Was dann passiert, liegt ganz bei dir: Dein Server verarbeitet die Anfrage und sendet etwas zurück, und das Gespräch wird basierend darauf fortgesetzt. Zum Beispiel: automatisches Weiterleiten von Anrufen basierend auf deinen eigenen Daten, das Nachschlagen des Anrufernamens und die Anzeige auf dem Telefon, oder einfach nur ein Signal an Zapier.

Sieh dir unbedingt Anrufbenachrichtigungen an, um die Möglichkeiten deines Telefondienstes voll auszuschöpfen.

Kurzfassung: Anrufer ruft an → Voys sendet eine Anfrage an deine URL → dein Server antwortet mit einem Status (und optional zusätzlichen Daten) → Voys setzt das Gespräch basierend darauf fort.

Felder im Formular

• Name — so findest du ihn in deinem Anrufplan wieder
• Beschreibung — nur für dich, hat keine Auswirkungen
• Caller ID-Durchstellung — welche Nummer der Empfänger sieht: Nummer des Anrufers, gewählte Nummer oder unterdrückt
• URL-Vorlage — die URL, die aufgerufen wird, siehe unten für die Variablen
• Menü verwenden — aktiviere dies, 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 in deinem Anrufplan

1. Gehe zu Anrufplan, wähle die Nummer aus
2. Klicke auf das Plus, füge einen Schritt hinzu
3. Wähle Webhook als Typ, wähle deinen Webhook aus
4. Du erhältst 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

Einfach 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 Durchwahl sein)

Den Namen des Anrufers ändern:

status=ACK&callername=VoysPartners

Variabler Anrufername, drei Varianten

• Webhook — nimmt den Namen aus der Antwort deines Servers
• Voranstellen — fügt deinen Text vor den bestehenden Namen hinzu
• Ersetzen — ersetzt den Namen vollständig durch deinen Text

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

Variables Ziel

Gibt dein Server eine destination zurück? Wähle „Variables Ziel" im Weiterleitungsschritt aus, und das Gespräch 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 heraus und gibst den Namen zurück, der auf dem Telefon 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. Weiterleitung basierend auf einer externen Datenbank

Entscheide selbst, wohin ein Anruf geleitet werden soll, basierend auf dem Anrufer, der gewählten 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 verfolgen

Jede Kampagne erhält eine eigene Nummer aus einem Block. Voys ruft deine URL mit der Kampagne (did) und dem Anrufer (callerid) auf; du protokollierst die Conversion, dann leitet Voys den Anruf zur echten Firmennummer weiter. Hinweis: Das Gespräch selbst führt kein JS aus, daher muss das Tracking 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 einem verpassten Anruf

Üblicherweise über Zapier: Dein Webhook sendet an einen Zapier-Catch-Hook, der ihn 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 über 300 Apps

Gleiche Idee wie oben, aber als generischer Trigger. Du kannst alle vier Variablen übergeben und Zapier entscheiden lassen, was damit zu tun ist – an 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 Zapie

n8n: Gesprächsaufnahmen, Transkripte und Zusammenfassungen protokollieren

Slack für verpasste Anrufe