Wat is een Webhook?
De Webhooks-module maakt uitgebreide aanpassingen mogelijk door HTTP-verzoeken naar externe URL's toe te staan, waardoor verschillende acties worden geactiveerd op basis van de geretourneerde gegevens. Of het nu gaat om het openen van een slagboom voor specifieke oproepen, het versturen van e-mails voor klantcontacten, of integratie met CRM-systemen en marketingcampagnes, de mogelijkheden zijn enorm. Je kunt de URL en opties configureren om functionaliteiten zoals doorschakelen of database-opzoekingen aan te passen naar jouw behoeften.
We raden je aan om zeker ook Gespreksnotificaties te bekijken om de mogelijkheden van je telefoniedienst te maximaliseren.
Hoe maak je een Webhook aan?
- Ga naar Webhooks.
- Klik op Toevoegen.
- Geef een naam voor je Webhook.
- Je kunt eventueel extra informatie toevoegen in het veld beschrijving. Dit is niet verplicht voor de werking van de webhook.
- Kies onder Caller ID-doorgave welk nummer de ontvanger van de oproep als Caller ID zal zien:
- Nummer van de beller.
- Gebeld nummer.
- Onderdrukt (anoniem).
- Voer in het veld URL-sjabloon de URL in die geactiveerd moet worden bij een inkomende oproep. De helptekst in het formulier biedt meer details. Dit veld bepaalt hoe de URL die door de webhook aangeroepen wordt, geformatteerd moet zijn. Er kunnen vier variabelen gebruikt worden in het URL-sjabloon:
- {code}: De cijfercode die door de beller is ingevoerd (zie "IVR gebruiken" hieronder).
- {did}: Het gebelde nummer.
- {callerid}: De Caller ID van de beller.
- {callername}: De naam van de beller, indien beschikbaar.
Een eenvoudig voorbeeld van een URL-sjabloon zou kunnen zijn:
http://webrouting.bedrijfsnaam.com/test.py?code={code}&callerid={callerid}
IVR gebruiken (Interactive Voice Response)
Vink dit vakje aan als je wilt dat de beller een cijfercode invoert om verder te gaan. Na het selecteren van deze optie verschijnen er vijf extra velden:
- Time-out: Voer het aantal seconden in dat de beller heeft om de cijfercode in te voeren.
- Aantal pogingen: Voer het aantal keren in dat de beller kan proberen om de cijfercode correct in te voeren.
- Startbericht: Selecteer het geluid dat wordt afgespeeld wanneer de beller naar deze webhook wordt doorgestuurd.
- Foutmelding: Selecteer het geluid dat wordt afgespeeld als de beller een onjuiste cijfercode invoert.
- Time-outbericht: Selecteer het geluid dat wordt afgespeeld als de time-outperiode wordt overschreden.
- Klik op Opslaan.
Als alles correct is ingesteld, wordt er nu een verbinding tot stand gebracht tussen je telefonie-platform en je script, CRM-pakket, Zapier of ander programma. Je hoeft deze Webhook alleen nog te activeren in je belplan.
Webhooks instellen in het belplan
- Ga naar Belplannen.
- Klik op het telefoonnummer waar je de webhook wilt gebruiken.
- Klik op Belplan wijzigen.
- Klik op Stap toevoegen op de locatie waar je de webhook wilt invoegen.
- Je ziet twee substappen:
- HTTP- en IVR-succes: Deze substappen worden uitgevoerd als de webhook de juiste waarden retourneert (de URL is verbonden) en de beller eventueel een geldige IVR-optie heeft ingevoerd.
- HTTP- of IVR-fout: Deze substappen worden uitgevoerd als er een probleem is, zoals wanneer de beller een ongeldige keuze maakt of als de URL niet werkt, mogelijk door een serverprobleem.
Wat je in je Webhook kunt opnemen
Je kunt verschillende elementen in je webhook integreren, net zoals je dat in je belplan zou doen. Hieronder vind je enkele opties en hun toepassingen:
Variabele naam beller
De naam van de beller—de naam die de ontvanger op zijn scherm ziet—kan op drie manieren worden aangepast:
- Webhook: Stel de naam van de beller in op de waarde die door de webhook wordt geretourneerd.
- Voorvoegsel: Voer tekst in de routeringsstap in die als voorvoegsel aan de naam van de beller wordt toegevoegd.
- Vervangen: Voer tekst in de routeringsstap in die de naam van de beller volledig vervangt.
Let op: Variabele naam beller kan ook buiten de webhook gebruikt worden. In dat geval kunnen alleen de opties Voorvoegen en Vervangen worden gebruikt.
Variabele bestemming
Als de webhook een bestemming levert, kun je de oproep naar deze bestemming doorschakelen door "Variabele bestemming" te selecteren in de routeringsstap (onder het webhook-gedeelte).
Feedback die je aan het systeem kunt geven
Geef de volgende feedback om de status van de webhook-interactie aan te geven.
Status
- ACK: Invoer is correct.
- NAK: De invoer is niet geldig.
- ERR: Er is een fout opgetreden.
Bestemming
Wordt gebruikt om door te schakelen naar een andere bestemming.
Naam van de beller
Gebruik dit als je de naam van de beller of de status van het gesprek (zoals een IVR-keuze) op een VoIP-toestel wilt weergeven.
Interpretatie van feedback
status=ACK
Het verzoek werd succesvol ontvangen en verwerkt met geldige invoer.
status=ACK&destination=%2B32502102544
Het verzoek werd succesvol verwerkt en het gesprek zou doorgeschakeld moeten worden naar het bestemmingsnummer +32 50 210 2544.
status=ACK&destination=215
Het verzoek werd succesvol verwerkt en het gesprek zou doorgeschakeld moeten worden naar het bestemmingsnummer 215.
status=ACK&callername=VoIPGRID
Het verzoek werd succesvol verwerkt en de naam van de beller zou ingesteld moeten worden op "VoIPGRID."
Alternatieve toepassingen voor de Webhook verkennen
CRM-integratie
Wanneer er een gesprek binnenkomt, sturen we een signaal naar het CRM-systeem. Dit signaal bevat het nummer van de beller (indien bekend) en het nummer dat gebeld werd. Het CRM stuurt vervolgens de naam terug die weergegeven zou moeten worden, en wij tonen die naam op het scherm van de VoIP-telefoon.
Optioneel kan het CRM ook een klantprofiel openen op basis van het inkomende gesprek — maar die logica moet binnen het CRM zelf afgehandeld worden.
Doorschakelen op basis van een externe database
We kunnen inkomende gesprekken doorschakelen naar een telefoonnummer dat door een extern systeem wordt teruggegeven. Dit kan gebaseerd zijn op:
- Het nummer van de beller
- Het gebelde nummer
- Een ingevoerde PIN-code
Telefoongesprekken bijhouden in Google Analytics
Om telefoongesprekken bij te houden, heb je een blok nummers nodig. Wijs een uniek nummer toe aan elke campagne. Met een blok van 10 nummers kun je tot 10 campagnes tegelijkertijd volgen.
Wanneer een klant een van de nummers uit het blok belt, sturen we een URL met het gebelde nummer (dat de campagne vertegenwoordigt) en het nummer van de beller (indien beschikbaar). Let op: ons systeem verwerkt geen JavaScript of vergelijkbare scripts, dus er moet een stukje code uitgevoerd worden nadat de URL aangeroepen is om de conversie correct te meten.
Nadat de URL aangeroepen is, schakelen we het gesprek door naar het hoofdnummer van het bedrijf en wordt de campagne bijgehouden.
E-mail ontvangen voor gemiste oproepen
Wanneer een oproep gemist wordt, kan het handig zijn om het telefoonnummer van de beller te ontvangen in een e-mail, sms-bericht of via bijvoorbeeld Slack, met daarbij de datum, tijd en het gebelde nummer. Bekijk Webhooks-voorbeelden voor een gedetailleerd voorbeeld via een Zapier-verbinding met webhooks.
VIP-pincode
Je kunt een webhook gebruiken om een specifieke VIP-PIN-code toe te wijzen aan klanten, bijvoorbeeld voor een toegewijde supportlijn. Voor meer informatie over hoe je dit kunt instellen, bezoek je de pagina VIP-PIN-code.
Verbinding maken met meer dan 300 andere webapplicaties via Zapier
Je kunt je webhook naadloos verbinden met Zapier, vergelijkbaar met IFTTT (If This Then That). Zapier stelt je in staat om verschillende systemen te integreren, zodat een actie in een webservice acties in andere kan activeren en zo een kettingreactie creëert. Zapier ondersteunt integratie met diensten zoals Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox en vele anderen.
Veelgestelde vragen
Webhooks worden geactiveerd op een specifiek punt in het belplan en werken alleen voor inkomende gesprekken. Indien nodig kan voor elke webhook die ingesteld wordt een andere URL gebruikt worden. Een webhook wordt op één enkel moment aangeroepen.
Gespreksnotificaties werken voor zowel inkomende als uitgaande gesprekken. Voor meer details, bekijk:
Bij gespreksnotificaties kan de URL op vijf verschillende momenten in de levenscyclus van het gesprek aangeroepen worden.
- Voor webhooks gebruik je een GET-aanvraag.
- Voor gespreksnotificaties gebruik je een POST-aanvraag.