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.

<aside> <img src="notion://custom_emoji/07b2df3c-633e-4ee0-816f-6107921e0ea9/3b840e6d-8f97-8098-87bd-007abda27eb4" alt="notion://custom_emoji/07b2df3c-633e-4ee0-816f-6107921e0ea9/3b840e6d-8f97-8098-87bd-007abda27eb4" width="40px" /> Check zeker Gespreksnotificaties om het maximale uit je telefoondienst te halen.

</aside>

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

1. Ga naar Belplan, kies het nummer