Webhooks in Totara stellen je site in staat om automatisch updates naar externe systemen te sturen wanneer specifieke gebeurtenissen plaatsvinden, waardoor de efficiëntie wordt verbeterd en realtime integratie met diensten van derden wordt ingeschakeld. Deze functie is vooral nuttig om de behoefte aan constante API polling te verminderen, wat processen kan vertragen en onnodige belasting op je systemen kan veroorzaken.
Waarvoor worden webhooks gebruikt?
In plaats van herhaaldelijk de externe API van Totara te controleren om te zien of er iets is veranderd, waarschuwen webhooks andere systemen zodra er iets gebeurt. Dit maakt integraties soepeler en sneller.
Veelvoorkomende use cases zijn:
Een HR-platform op de hoogte brengen wanneer een cursist de inwerkcursus voltooit.
Het activeren van een e-mail met een certificaat wanneer een gebruiker een cursus voltooit.
Het pushen van updates naar een CRM zoals Salesforce wanneer een gebruiker zich aanmeldt voor een training.
Notificaties naar Slack sturen wanneer een nieuwe cursus wordt gepubliceerd.
Integreren met een business intelligence tool zoals Power BI in real time.
Toegangsrechten
Er zijn twee rechten beschikbaar in Totara om de toegang tot webhooks te controleren:
Bekijk webhooks
Webhooks beheren
Webhooks openen
Webhooks zijn voorgeïnstalleerd vanaf Totara 19.1, maar ze zijn standaard uitgeschakeld. Om webhooks in te schakelen:
Ga naar Snelmenu Configure>er functies.
Schakel het selectievakje in voor Webhooks inschakelen.
Webhook maken
1. Ga naar Snelmenu > Ontwikkeling > API > Webhooks
2. Klik op de knop Maken om een nieuwe webhook toe te voegen.
3. Vul de volgende velden in op het formulier Create Webhook:
Veld | Moeten toegevoegde onderdelen eerst door een trainer goedgekeurd worden voor ze gezien kunnen worden door cursisten | Omschrijving |
Naam | Ja | Een beschrijvende naam voor de webhook (bijv. Power BI, Mailchimp). |
Endpoint | Ja | Het HTTPS-adres waarnaar Totara gegevens zal sturen. |
Uitvoeringen | Nee | Selecteer de gebeurtenissen waarop de webhook moet reageren. Je kunt er één of meerdere kiezen. |
Verzendtijdstip | Ja | Of de uitvoering moet worden verzonden zodra deze plaatsvindt, of |
4. Klik op Opslaan. Je wordt doorverwezen naar de webhook lijstpagina waar je nieuwe webhook nu wordt weergegeven.
Webhooks bewerken
Om een webhook te bewerken, kun je vanaf de webhook lijstpagina ofwel:
Klik op de drie puntjes (
) voor de webhook die je wil bewerken en kies Bewerken in het menu.
Of open de webhook door op de naam van de webhook te klikken en klik op de Bewerken-knop.
Maak vervolgens vanuit het Webhook-formulier met de huidige webhook-instellingen je wijzigingen en klik op Indienen om te bevestigen en je wijzigingen op te slaan, of Annuleren om terug te keren naar de webhook-pagina en eventuele wijzigingen te annuleren.
Webhooks uitschakelen
Webhooks kunnen worden uitgeschakeld door hun status te wijzigen naar uitgeschakeld. Voor uitgeschakelde webhooks worden geen verzoeken naar hen verzonden, noch worden er webhook-ladingen in de wachtrij geplaatst.
Webhooks verwijderen
Om een webhook te verwijderen, van de webhook lijstpagina:
Klik op de drie puntjes (
) voor de webhook die je wil verwijderen en kies Verwijderen in het menuBevestig de verwijdering in het dialoogvenster dat verschijnt.
Als je op Verwijderen klikt, wordt de webhook permanent verwijderd. Klik op Annuleren om terug te keren zonder te verwijderen.
Webhook-ladingen
Wanneer een webhook wordt geactiveerd, stuurt Totara een HTTP POST-verzoek naar het geconfigureerde eindpunt. De tekst van het bericht bevat de volgende standaardvelden:
Veld | Omschrijving |
tijd_aangemaakt | De tijd dat de gebeurtenis is geactiveerd in Totara - dit blijft hetzelfde, ongeacht of het POST de eerste verzending is of een nieuwe poging. |
uitvoering | De gebeurtenisnaam die de gebeurtenis heeft geactiveerd. Nuttig bij het monitoren van een webhook die geabonneerd is op meerdere uitvoeringstypes. |
poging | Aantal pogingen om HTTP-bericht te verzenden. Bij de eerste poging wordt dit ingesteld op 1 en verhoogd voor elke nieuwe poging. |
webhook_id | De webhook, die is ingeschreven op de uitvoering, is nuttig bij het monitoren van een webhook-eindpunt waarvoor meerdere webhooks zijn geregistreerd. |
hoofdtekst | Details met betrekking tot de specifieke gebeurtenis die is geactiveerd - dit varieert afhankelijk van de gebeurtenis die is geactiveerd. |
Reageren op Webhooks
Totara acht de webhook succesvol wanneer het ontvangende systeem antwoordt met een HTTP-responsstatuscode in het bereik van 200. Als Totara een antwoord in het bereik van 400 ontvangt, zal het de webhook als fout geconfigureerd beschouwen en het laadvermogen van het verzoek verplaatsen naar de wachtrij met lege letters. Alles buiten dit bereik (bijv. 500) zal ervoor zorgen dat de webhook op een later tijdstip opnieuw wordt geprobeerd.
Inschrijven voor uitvoering
Webhooks kunnen inschrijven op een van de beschikbare uitvoeringen in Totara. Deze omvatten het maken van gebruikers, cursusvoltooiingen, badge-awards en meer. Op het moment van schrijven zijn er meer dan 900 gebeurtenissen die kunnen worden gebruikt om webhooks te activeren.
Webhooks stellen Totara in staat om naadloos te werken met het bredere digitale ecosysteem van je organisatie. Eenmaal ingesteld, maken ze realtime automatisering tussen Totara en andere platforms mogelijk, waardoor tijd wordt bespaard en de nauwkeurigheid van gegevens wordt verbeterd.
Join the Totara Community for more resources to help you get the most out of Totara.
© Copyright 2026 Totara Learning Solutions. All rights reserved.