Wat is een Webhook?
De Webhooks-module maakt uitgebreide aanpassingen mogelijk door HTTP-verzoeken naar externe URL's te sturen, waarmee verschillende acties worden geactiveerd op basis van de ontvangen 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 enorm. Stel de URL en opties in om functionaliteiten zoals doorschakelen of database-lookups naar jouw wensen aan te passen.
Kijk zeker even naar Gespreksnotificaties om het maximale uit je telefoonservice te halen.
Hoe maak je een Webhook aan?
- Ga naar Webhooks.
- Klik op Toevoegen.
- Geef een naam voor je Webhook.
- Optioneel kun je extra informatie toevoegen in het veld beschrijving. Dit is niet nodig voor de werking van de webhook.
- Kies bij Caller ID-weergave welk nummer de ontvanger van het gesprek ziet als caller ID:
- 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 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-sjabloon:
- {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 beschikbaar.
Een simpel voorbeeld van een URL-sjabloon:
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 verder te gaan. Na het selecteren van deze optie verschijnen vijf extra velden:
- Timeout: Voer het aantal seconden in dat de beller heeft om de cijfercode in te voeren.
- Aantal pogingen: Voer in hoe vaak 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 doorverbonden.
- Foutmelding: Selecteer het Geluid dat wordt afgespeeld als de beller een onjuiste 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 link 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 succesvol: 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, bijvoorbeeld 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 in je belplan. Hieronder staan wat opties en hun toepassingen:
Variabele bellernaam
De bellernaam – de naam die de ontvanger op het scherm ziet – kun je op drie manieren aanpassen:
- Webhook: Stel de bellernaam in op de waarde die de webhook teruggeeft.
- Voorvoegsel: Voer tekst in de routeringsstap in die vóór de naam van de beller wordt geplaatst.
- Vervangen: Voer tekst in de routeringsstap in die de naam van de beller volledig vervangt.
Let op: Variabele bellernaam kun je ook buiten de webhook gebruiken. In dat geval zijn alleen de opties Voorvoegsel en Vervangen beschikbaar.
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 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 goed.
- NAK: Input is niet geldig.
- ERR: Er is een fout opgetreden.
Bestemming
Gebruik je voor doorschakelen naar een andere bestemming.
Naam beller
Gebruik dit als je de naam van de beller of de status van het gesprek (zoals een IVR-keuze) wilt tonen op een VoIP-toestel.
Feedback interpretatie
status=ACK
Het verzoek is succesvol ontvangen en verwerkt met geldige input.
status=ACK&destination=%2B31502102544
Het verzoek is succesvol verwerkt en het gesprek wordt doorgeschakeld naar nummer +31 50 210 2544.
status=ACK&destination=215
Het verzoek is succesvol verwerkt en het gesprek wordt doorgeschakeld naar nummer 215.
status=ACK&callername=VoIPGRID
Het verzoek is succesvol verwerkt en de naam van de beller wordt ingesteld op "VoIPGRID."
Alternatieve toepassingen voor de Webhook
CRM integratie
Bij een inkomend gesprek sturen we een puls naar het CRM-systeem. Deze puls bevat het nummer van de beller (als bekend) en het nummer dat gebeld is. Het CRM stuurt de naam terug die getoond moet worden, en die naam tonen we 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 geregeld 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 tracken in Google Analytics
Om telefoongesprekken te tracken heb je een blok nummers nodig. Wijs aan elke campagne een uniek nummer toe. Met een blok van 10 nummers kun je tot 10 campagnes tegelijk tracken.
Als een klant een van de nummers uit het blok belt, sturen we een URL met het gebelde nummer (dat staat voor de campagne) 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 de campagne wordt getrackt.
E-mail ontvangen bij gemiste oproepen
Bij een gemist gesprek kan het handig zijn om het nummer van de beller te ontvangen in een e-mail, sms of via bijvoorbeeld Slack, inclusief datum, tijd en gebeld nummer. Bekijk Webhooks voorbeelden voor een uitgebreid voorbeeld via een Zapier-koppeling met webhooks.
VIP-pincode
Je kunt een webhook gebruiken om specifieke VIP PIN-codes aan klanten toe te wijzen, bijvoorbeeld voor een speciale supportlijn. Bekijk de VIP PIN Code pagina voor meer informatie over de setup.
Koppelen met 300+ andere webapplicaties via Zapier
Je kunt je webhook naadloos koppelen aan Zapier, vergelijkbaar met IFTTT (If This Then That). Met Zapier kun je verschillende systemen integreren, zodat een actie in de ene webservice acties in andere kan triggeren, wat een kettingreactie creëert. Zapier ondersteunt integratie met services zoals Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox en veel anderen.
FAQ
Webhooks worden getriggerd op een specifiek punt in het belplan en werken alleen voor inkomende gesprekken. Als je wilt, kun je voor elke webhook die je instelt een andere URL gebruiken. Een webhook wordt aangeroepen op één specifiek moment.
Gespreksnotificaties werken voor zowel inkomende als uitgaande gesprekken. Voor meer details, kijk hier:
Bij 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.