Wat is een Webhook?
De Webhooks-module maakt uitgebreide maatwerk mogelijk door HTTP-verzoeken naar externe URL's toe te staan, waarmee verschillende acties worden geactiveerd op basis van de teruggestuurde data. Of het nu gaat om het openen van een slagboom voor specifieke gesprekken, het versturen van e-mails voor klantcontacten, of integratie met CRM-systemen en marketingcampagnes: de mogelijkheden zijn eindeloos. Configureer de URL en opties om functionaliteiten zoals doorschakelen of database lookups helemaal naar je eigen hand te zetten.
Vergeet niet om Gespreksnotificaties te bekijken om het maximale uit je telefoniedienst te halen.
Hoe maak je een Webhook aan?
- Ga naar Webhooks.
- Klik op Toevoegen.
- Geef een naam voor je Webhook.
- Je kunt optioneel extra informatie toevoegen in het veld beschrijving. Dit is niet nodig om de webhook te laten werken.
- Kies bij Caller ID-weergave welk nummer de ontvanger van het gesprek ziet als beller:
- Nummer van de beller.
- Gebeld nummer.
- Onderdrukt (anoniem).
- Vul in het veld URL Template de URL in die moet worden geactiveerd bij een inkomende oproep. De helptekst in het formulier geeft meer details. Dit veld bepaalt hoe de URL die door de webhook wordt aangeroepen moet worden opgemaakt. Je kunt vier variabelen gebruiken in het URL-template:
- {code}: De cijfercode die de beller invoert (zie "IVR gebruiken" hieronder).
- {did}: Het gebelde nummer.
- {callerid}: De Caller ID van de beller.
- {callername}: De naam van de beller, als deze beschikbaar is.
Een eenvoudig voorbeeld van een URL-template kan zijn:
http://webrouting.bedrijfsnaam.com/test.py?code={code}&callerid={callerid}
IVR gebruiken (Interactive Voice Response)
Vink dit aan als je wilt dat de beller een cijfercode invoert om door te gaan. Na het selecteren van deze optie verschijnen er vijf extra velden:
- Timeout: Vul het aantal seconden in dat de beller heeft om de cijfercode in te voeren.
- Aantal pogingen: Vul het aantal keren in dat de beller kan proberen de juiste cijfercode in te voeren.
- Startbericht: Selecteer het Geluid dat wordt afgespeeld wanneer de beller naar deze webhook wordt doorverbonden.
- Foutmelding: Selecteer het Geluid dat wordt afgespeeld als de beller een verkeerde cijfercode invoert.
- Timeout-bericht: Selecteer het Geluid dat wordt afgespeeld als de timeout-periode wordt overschreden.
- Klik op Opslaan.
Als alles goed is ingesteld, is er nu een verbinding tussen je telefoonplatform en je script, CRM-pakket, Zapier of ander programma. Je hoeft deze Webhook alleen nog maar 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 plek 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 eventueel 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, bijvoorbeeld 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 staan een paar opties en hun gebruik:
Variabele naam beller
De naam van de beller—de naam die de ontvanger op het 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 naam beller kan ook buiten de webhook worden gebruikt. In dat geval kun je alleen de opties Voorvoegsel en Vervangen gebruiken.
Variabele bestemming
Als de webhook een bestemming aanlevert, kun je het gesprek naar deze bestemming doorschakelen door "Variabele bestemming" te selecteren in de routeringsstap (onder de webhook-sectie).
Feedback die je aan het systeem kunt 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
CRM-integratie
Bij een inkomend gesprek sturen we een signaal naar het CRM-systeem. Dit signaal bevat het nummer van de beller (als deze bekend is) en het gekozen nummer. Het CRM stuurt de naam terug die getoond moet 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 in 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 op basis van:
- Het nummer van de beller
- Het gekozen nummer
- Een ingevoerde pincode
Telefoongesprekken bijhouden in Google Analytics
Om telefoongesprekken bij te houden heb je een reeks nummers nodig. Wijs een uniek nummer toe aan elke campagne. Met een reeks van 10 nummers kun je tot 10 campagnes tegelijk bijhouden.
Wanneer een klant een van de nummers uit de reeks belt, sturen we een URL met het gekozen nummer (die de campagne vertegenwoordigt) en het nummer van de beller (als beschikbaar). Let op: ons systeem verwerkt geen JavaScript of vergelijkbare scripts, dus er moet een stukje code uitgevoerd worden nadat de URL is aangeroepen om de conversie goed te meten.
Nadat de URL is aangeroepen, schakelen we het gesprek door naar het hoofdnummer van het bedrijf en wordt de campagne bijgehouden.
E-mail ontvangen bij gemiste oproepen
Bij een gemiste oproep kan het handig zijn om het telefoonnummer van de beller te ontvangen via bijvoorbeeld een e-mail, sms of Slack, inclusief datum, tijd en gebeld nummer. Zie Webhooks voorbeelden voor een uitgebreid voorbeeld via een Zapier-verbinding met webhooks.
VIP-pincode
Je kunt een webhook gebruiken om klanten een specifieke VIP-pincode toe te wijzen, bijvoorbeeld voor een speciale supportlijn. Voor meer informatie hierover, ga naar de VIP-pincode pagina.
Verbinden 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 één webservice acties in andere kan triggeren, waardoor een kettingreactie ontstaat. Zapier ondersteunt integratie met diensten zoals Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox en vele anderen.
Veelgestelde vragen
Webhooks worden op een specifiek punt in het belplan geactiveerd en werken alleen voor inkomende gesprekken. Je kunt indien nodig voor elke ingestelde webhook een andere URL gebruiken. Een webhook wordt op één moment aangeroepen.
Gespreksnotificaties werken voor zowel inkomende als uitgaande gesprekken. Meer informatie vind je hier:
Met gespreksnotificaties kan de URL op vijf verschillende momenten in de levenscyclus van een gesprek worden aangeroepen.
- Voor webhooks gebruik je een GET-verzoek.
- Voor gespreksnotificaties gebruik je een POST-verzoek.