Algemene instellingen
Webhooks
Automatisch een gebeurtenis in uw eigen systemen ontvangen zodra een Leexi-gesprek is getranscribeerd en geanalyseerd.
Definitie: Een webhook verwittigt uw systemen zonder dat u Leexi hoeft te bevragen. Zodra een gesprek is getranscribeerd en de AI-inzichten zijn gegenereerd, stuurt Leexi een verzoek naar de URL die u hebt geconfigureerd, met de inhoud van het gesprek.
Video van de functie
Er is momenteel geen video beschikbaar.
Voor wie is dit bedoeld?
- Voor technische teams die aan het einde van elk gesprek een automatische verwerking willen starten.
- Voor beheerders die een datawarehouse, een interne tool of een zelfgemaakte automatisering voeden.
Machtigingen en licenties
- Het bekijken van webhooks vereist de leesmachtiging voor webhooks, het aanmaken en wijzigen ervan de schrijfmachtiging.
- De verzonden gegevens volgen het formaat van de publieke API: de webhookreferentie beschrijft dit in detail.
Gebruikshandleiding
De pagina Webhooks openen
Ga naar Instellingen > Geavanceerd > Webhooks. De lijst toont voor elke webhook de naam, de toegangsregels, de URL, de beschrijving en de status.
Een webhook aanmaken
Klik op "Toevoegen" en vul een naam, de URL die de gebeurtenissen zal ontvangen en een beschrijving in. De URL moet bereikbaar zijn via internet en kan door slechts één webhook van uw bedrijf worden gebruikt.
De toegangsregels bepalen
Er zijn drie modi beschikbaar:
- Gekoppeld aan een gebruiker: de webhook ontvangt alleen gebeurtenissen voor gesprekken waartoe die gebruiker toegang heeft.
- Toegang tot alles: de webhook ontvangt de gebeurtenissen van alle gesprekken van het bedrijf.
- Aangepaste toegang: na het opslaan wordt u doorgestuurd naar de pagina Toegangsregels om het exacte bereik af te bakenen.
De ontvangen gebeurtenissen verwerken
Uw endpoint ontvangt een POST-verzoek met het type gebeurtenis en de gegevens van het gesprek. Antwoord met een succescode en verwerk de inhoud vervolgens aan uw kant.
Een webhook activeren of pauzeren
Met de schakelaar in de kolom "Actief" pauzeert u het verzenden van gebeurtenissen zonder de configuratie te verwijderen, bijvoorbeeld tijdens onderhoud aan uw kant.
Verder gaan
- Vandaag bestaat er slechts één type gebeurtenis,
call.processed, verzonden zodra de transcriptie en de AI-inzichten volledig zijn gegenereerd. - De inhoud van het verzoek bevat de naam van de gebeurtenis en de gegevens van het gesprek, in hetzelfde formaat als het gedetailleerde gesprek van de publieke API.
- Als uw endpoint niet antwoordt of een fout terugstuurt, probeert Leexi het tot tien keer opnieuw met een toenemende vertraging: 10 seconden, 1 minuut, 5, 15 en 30 minuten, 1 uur, 6 uur en daarna elke 24 uur.
- Na die tien pogingen wordt de webhook automatisch gedeactiveerd en ontvangen de beheerders van het bedrijf hierover een e-mail. Activeer hem opnieuw zodra uw endpoint weer werkt.
- API-sleutels dekken de omgekeerde behoefte: Leexi bevragen wanneer het u past in plaats van op een gebeurtenis te wachten.
Veelgestelde vragen
Elk succesantwoord volstaat. Elk foutantwoord, net als het uitblijven van een antwoord, leidt tot een nieuwe poging.
Omdat tien opeenvolgende verzendpogingen zijn mislukt. Controleer of uw URL bereikbaar is en correct antwoordt, en activeer de webhook daarna opnieuw.
Nee, beide werken onafhankelijk van elkaar. Een API-sleutel blijft nuttig als u na ontvangst van een gebeurtenis aanvullende gegevens wilt ophalen.
Ja, door aangepaste toegang en de bijbehorende toegangsregels te configureren.
Aandachtspunten
- Het verzoek is niet ondertekend: gebruik een URL die moeilijk te achterhalen is en bevraag de publieke API opnieuw als u de ontvangen gegevens moet valideren.
- Een traag of onbeschikbaar endpoint leidt uiteindelijk tot deactivering van de webhook: bevestig de ontvangst beter snel en verwerk de inhoud daarna.
- Gebeurtenissen worden niet opnieuw verzonden voor de periode waarin de webhook inactief was: gesprekken die in die tijd zijn verwerkt, moet u via de publieke API ophalen.
- De verzonden inhoud omvat de gegevens van het gesprek: zorg ervoor dat het ontvangende systeem het verwachte niveau van vertrouwelijkheid biedt.