Webhooks

Met webhooks stuurt Voxbi een melding naar je eigen systemen op het moment dat er iets gebeurt in een gesprek. Zodra een gesprek start, eindigt, gemist wordt of een andere gebeurtenis optreedt die voor jou relevant is, stuurt Voxbi een HTTP-verzoek naar een URL die jij opgeeft. Je systeem ontvangt die data en kan er direct op reageren: het gesprek vastleggen, een record bijwerken, een melding sturen of een workflow starten die jij hebt gebouwd. De logica zit in jouw systeem; Voxbi levert het signaal.

Dit is het patroon voor het koppelen van Voxbi aan zakelijke tools en processen waarvoor geen kant-en-klare integratie bestaat. Heb je een interne applicatie, een eigen CRM, een ticketingsysteem of een automatiseringsplatform dat op de hoogte moet blijven van gespreksactiviteit? Met een webhook krijg je de data in realtime, zonder dat je voortdurend hoeft te pollen. Samen met de Voxbi API, waarmee je gesprekshistorie kunt opvragen, gespreksopnames kunt beheren, sms kunt versturen en telefonie programmatisch kunt aansturen, vormen webhooks het complete plaatje: de API haal je zelf op, de webhook pusht gebeurtenissen naar jou zodra ze plaatsvinden.

Wanneer je webhooks gebruikt

• Een intern helpdesksysteem dat automatisch een ticket aanmaakt wanneer een supportgesprek buiten kantooruren gemist wordt, zodat geen enkel gesprek onbeantwoord blijft ook als de wachtrij onbeheerd is.

• Een business analytics- of rapportagetool die nauwkeurige, realtime gespreksdata nodig heeft die rechtstreeks wordt ingevoerd zonder handmatige exports of periodiek ophalen uit de gesprekshistorie.

• Een automatiseringsplatform waarbij een inkomend gesprek van een bekend klantnummer een zoekopdracht activeert en klantcontext naar de medewerker pusht nog voordat die de telefoon opneemt.

Hoe webhooks werken in Voxbi

1. Bereid een endpoint voor in je systeem. Je systeem heeft een URL nodig die een HTTP POST-verzoek kan ontvangen en de JSON-payload verwerkt die Voxbi verstuurt. Het endpoint moet bereikbaar zijn vanaf internet en een geschikte statuscode terugsturen zodat Voxbi weet dat de levering geslaagd is.

2. Configureer de webhook in Voxbi. Ga in Voxbi Cockpit naar de webhook- of automatiseringsinstellingen en voeg je endpoint-URL toe. Selecteer de gespreksgebeurtenissen waarop je wilt intekenen, zoals gesprek gestart, gesprek beëindigd of gesprek gemist.

3. Ontvang de gebeurtenis en handel ernaar. Zodra de geabonneerde gebeurtenis plaatsvindt, stuurt Voxbi de gespreksdata naar je endpoint. Je systeem verwerkt de payload en voert de logica uit die jij hebt gedefinieerd: schrijven naar een database, een melding verzenden, een record aanmaken of een vervolgproces starten.

4. Combineer met de API voor tweerichtingsworkflows. Webhooks leveren gebeurtenissen vanuit Voxbi aan jou. Met de Voxbi API ga je de andere kant op: gesprekshistorie ophalen, opnames raadplegen, sms versturen en telefonie programmatisch aansturen. Samen geven de twee je volledige tweerichtingsautomatisering tussen Voxbi en je eigen stack. De API-documentatie vind je op docs.voxbi.com.

Veelgestelde vragen

Wat is het verschil tussen een webhook en de Voxbi API?

Een webhook is gebeurtenisgestuurd: Voxbi stuurt data naar je endpoint zodra er iets gebeurt, zonder dat jij daarom hoeft te vragen. De API is verzoekgestuurd: jouw systeem roept een Voxbi-endpoint aan wanneer het informatie nodig heeft. De meeste integratiepatronen gebruiken beide: webhooks voor realtime triggers, de API voor het ophalen van data op aanvraag.

Heb ik een ontwikkelaar nodig om webhooks te gebruiken?

Het opzetten van een webhook-endpoint vereist enige technische kennis, omdat je systeem HTTP-verzoeken moet kunnen ontvangen en verwerken. Gebruik je een automatiseringsplatform dat webhooks ondersteunt als inkomende trigger? Dan kan dat platform het endpoint voor zijn rekening nemen, waardoor je minder eigen code nodig hebt.

Welke data zit er in een webhook-payload van Voxbi?

Webhook-payloads bevatten gespreksgebeurtenisdata. De exacte velden hangen af van het gebeurtenistype, maar bevatten doorgaans het nummer van de beller, de bestemming, de tijdstempel, de gespreksduur waar van toepassing en een gespreksidentificator. Raadpleeg de Voxbi API-documentatie op docs.voxbi.com voor de actuele payload-specificatie.

Kan ik webhooks gebruiken om gesprekken te routeren op basis van data in mijn eigen systeem?

Webhooks kunnen gespreksgebeurtenissen naar je systemen doorsturen. Hoe routeringsbeslissingen vervolgens terugkomen in Voxbi-gespreksstromen hangt af van je integratieontwerp. Wil je een routeringsworkflow opzetten die afhankelijk is van extern teruggegeven data in realtime? Neem dan contact op met het Voxbi-team via hello@voxbi.com om je situatie te bespreken voordat je begint met bouwen.