Wat is een Webhook?
De Webhooks-module maakt uitgebreide personalisatie mogelijk door HTTP-verzoeken naar externe URL's toe te staan, waardoor verschillende acties worden geactiveerd op basis van de teruggestuurde 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 kan de URL en opties configureren om functionaliteiten zoals doorschakelen of database-opzoekingen naar wens aan te passen.
We raden je aan zeker een kijkje te nemen bij Gespreksnotificaties om de mogelijkheden van je telefoniedienst maximaal te benutten.
Hoe maak je een Webhook aan?
- Ga naar Webhooks.
- Klik op Toevoegen.
- Geef een naam voor je Webhook.
- Optioneel kan je aanvullende informatie toevoegen in het veld beschrijving. Dit is niet noodzakelijk voor de werking van de webhook.
- Onder Caller ID-overdracht kies je welk nummer de gesprekspartner zal zien als Caller ID:
- Nummer van de beller.
- Gebeld nummer.
- Onderdrukt (anoniem).
- In het veld URL Template voer je de URL in die geactiveerd zou moeten worden bij een inkomende oproep. De helptekst in het formulier geeft meer details. Dit veld bepaalt hoe de URL die door de webhook aangeroepen moet worden, geformatteerd dient te zijn. Er kunnen vier variabelen gebruikt worden in het URL-template:
- {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-template 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 vijf aanvullende velden:
- Timeout: 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 mag proberen om de cijfercode correct in te voeren.
- Startbericht: Selecteer het Geluid dat afgespeeld moet worden wanneer de beller naar deze webhook wordt doorgestuurd.
- Foutmelding: Selecteer het Geluid dat afgespeeld moet worden als de beller een onjuiste cijfercode invoert.
- Timeout-bericht: Selecteer het Geluid dat afgespeeld moet worden als de timeout-periode wordt overschreden.
- Klik op Opslaan.
Als alles correct is ingesteld, wordt er nu een verbinding tot stand gebracht tussen je telefonieplatform en je script, CRM-pakket, Zapier of ander programma. Je hoeft deze Webhook enkel 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 geslaagd: Deze substappen worden uitgevoerd als de webhook de juiste waarden teruggeeft (de URL is verbonden) en de beller mogelijk een geldige IVR-optie heeft ingevoerd.
- HTTP of IVR mislukt: 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 kan opnemen
Je kan verschillende elementen in je webhook integreren, net zoals je dat zou doen in je belplan. Hieronder vind je enkele opties en hun toepassingen:
Variabele voor bellernaam
De naam van de beller—de naam die de ontvanger op zijn scherm ziet—kan op drie manieren worden aangepast:
- Webhook: Set the caller name to the value returned by the webhook.
- Prefix: Enter text in the routing step that will be prefixed to the caller's name.
- Replace: Enter text in the routing step that will replace the caller's name entirely.
Let op: Variabele bellernaam kan ook buiten de webhook gebruikt worden. In dat geval kunnen enkel de opties Voorvoegsel toevoegen en Vervangen gebruikt worden.
Variabele bestemming
Als de webhook een bestemming aanlevert, kan je de oproep naar deze bestemming doorschakelen door "Variabele bestemming" te selecteren in de routeringsstap (onder de webhook-sectie).
Feedback die je aan het systeem kan geven
Geef de volgende feedback om de status van de webhook-interactie aan te geven.
Status
- ACK: Input is good.
- NAK: Input is not valid.
- ERR: An error occured.
Destination
Used for forwarding to another destination.
Caller Name
Use this if you want to display the caller's name or the status of the call (such as IVR choice) on a VoIP device.
Feedback interpretation
status=ACK
The request was successfully received and processed with valid input.
status=ACK&destination=%2B31502102544
The request was successfully processed, and the call should be forwarded to the destination number +31 50 210 2544.
status=ACK&destination=215
The request was successfully processed, and the call should be forwarded to the destination number 215.
status=ACK&callername=VoIPGRID
The request was successfully processed, and the caller's name should be set to "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 gekend) en het nummer dat gebeld werd. Het CRM geeft vervolgens de naam terug die weergegeven zou moeten worden, en we tonen die naam op het scherm van de VoIP-telefoon.
Optioneel kan het CRM ook een klantenprofiel 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 pincode
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 in 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 gesprekken
Wanneer een gesprek gemist wordt, kan het handig zijn om het telefoonnummer van de beller te ontvangen via een e-mail, sms-bericht of bijvoorbeeld via Slack, met 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-pincode toe te wijzen aan klanten, bijvoorbeeld voor een speciale supportlijn. Voor details over hoe je dit instelt, kun je terecht op de pagina VIP-pincode.
Verbinding maken met 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 de ene webservice acties in andere kan triggeren, wat 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 moment in het belplan en werken alleen voor inkomende gesprekken. Indien nodig kan voor elke ingestelde webhook een andere URL gebruikt worden. Een webhook wordt op één enkel moment aangeroepen.
Gespreksnotificaties werken voor zowel inkomende als uitgaande gesprekken. Voor meer details kun je hier terecht:
Met gespreksnotificaties kan de URL op vijf verschillende momenten in de levenscyclus van een gesprek aangeroepen worden.
- Voor webhooks gebruik je een GET-verzoek.
- Voor gespreksnotificaties gebruik je een POST-verzoek.