Webhooks

Voorbeelden van webhooks

Met een webhook stuurt Voys een HTTP-verzoek naar jouw URL zodra iemand belt. Wat er daarna gebeurt, bepaal je zelf: jouw server verwerkt het verzoek en stuurt iets terug, waarna het gesprek verder gaat op basis daarvan. Denk aan: gesprekken automatisch routeren op basis van je eigen data, de naam van de beller opzoeken en tonen op de telefoon, of gewoon een ping naar Zapier sturen.

Check zeker

Gespreksnotificaties om het maximale uit je telefoondienst te halen.

Kort gezegd: beller belt → Voys stuurt een verzoek naar jouw URL → jouw server reageert met een status (en eventueel extra data) → Voys vervolgt het gesprek op basis daarvan.

Velden in het formulier

Naam — zo vind je hem terug in je belplan
Omschrijving — alleen voor jezelf, doet verder niks
Caller ID doorzetten — welk nummer de ontvanger ziet: nummer van beller, gebeld nummer, of onderdrukt
URL template — de URL die wordt aangeroepen, zie hieronder voor de variabelen
Menu gebruiken — zet aan als de beller eerst een code moet invoeren (IVR-stijl). Voegt 5 extra velden toe: timeout, aantal pogingen, startbericht, foutmelding, timeout-melding

Variabelen voor je URL template

{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

Voorbeeld:

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

Voys vult deze vier variabelen automatisch in voordat het verzoek wordt verstuurd.

Instellen in je belplan

Ga naar Belplan, kies het nummer
Klik op de plus, voeg een stap toe
Kies Webhook als type, selecteer je webhook
Je krijgt automatisch twee paden: HTTP en menu gelukt en HTTP of menu mislukt

In beide paden kun je je normale belplanstappen gebruiken, plus twee extra opties: variabele bellernaam en variabele bestemming (zie hieronder).

Wat je terugstuurt

Je server reageert in application/x-www-form-urlencoded formaat. Verplicht: status. Optioneel: destination en callername.

Status:

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

Alleen bevestigen:

status=ACK

Doorschakelen naar een ander nummer:

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

(destination kan een extern nummer of een intern toestel zijn)

Naam van beller aanpassen:

status=ACK&callername=VoysPartners

Variabele bellernaam, drie smaken

Webhook — neemt de naam uit de reactie van je server
Voeg toe — zet jouw tekst voor de bestaande naam
Vervang — vervangt de naam volledig door jouw tekst

(Voeg toe / Vervang werken trouwens ook zonder webhook.)

Variabele bestemming

Stuurt je server een destination terug? Selecteer "Variabele bestemming" in de routeringsstap en het gesprek gaat daar automatisch naartoe.

Voorbeelden per use case

1. CRM integratie

Bij een inkomende oproep stuurt Voys callerid en did naar je CRM. Je zoekt de klant op en stuurt de naam terug die op de telefoon moet verschijnen.

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

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

2. Routeren op basis van een externe database

Bepaal zelf waar een gesprek naartoe moet, op basis van de beller, het gebelde nummer of een pincode.

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

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

3. Gesprekken tracken in Google Analytics

Elke campagne krijgt een eigen nummer uit een blok. Voys roept jouw URL aan met de campagne (did) en de beller (callerid); jij logt de conversie, waarna Voys het gesprek doorstuurt naar het echte bedrijfsnummer. Let op: het gesprek zelf voert geen JS uit, dus de tracking moet server-side gebeuren.

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

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

4. E-mail / Slack bij gemiste oproep

Meestal via Zapier: je webhook post naar een Zapier catch hook, die het doorstuurt naar e-mail, SMS of Slack.

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-pincode

Menu aangezet, beller voert een code in, jij checkt of die geldig is.

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

Valid code:
status=ACK&destination=210

Invalid code:
status=NAK

6. Via Zapier naar 300+ apps

Zelfde idee als hierboven, maar als generieke trigger. Je kunt alle vier de variabelen doorgeven en Zapier laten bepalen wat ermee gebeurt, richting Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox, enzovoort.

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"
}