Hoe gebruik je Webhooks | MoreApp

Webhooks zijn real-time berichten die naar jouw URL worden gestuurd. Deze berichten worden geactiveerd als reactie op een specifieke gebeurtenis.

Om een Webhook te maken, hoef je alleen maar een URL te configureren en te beginnen met het "luisteren" naar gebeurtenissen. Volg deze stappen en probeer het uit!

Nog geen MoreApp account? Meld je hier aan.

Deze feature is beschikbaar in het Branch, Tree en Forest abonnement. Bekijk onze Prijzenpagina.

1. Wat is een Webhook?

Webhooks zijn real-time berichten die naar jouw URL worden gestuurd. Deze berichten worden geactiveerd als reactie op een specifieke gebeurtenis. Naar aanleiding van een gebeurtenis, ook wel trigger genoemd, stuurt een Webhook een payload naar de vooraf ingestelde URL (Webhook endpoint). Naar aanleiding hiervan wordt een specifieke actie uitgevoerd. Hiermee kun je MoreApp met elke andere software integreren.

2. Verschil tussen API en Webhooks

API en Webhooks zijn beide methodes van communicatie tussen software. 

Webhooks zijn real-time en gebaseerd op gebeurtenissen op onze server. API kan daarentegen per direct data van onze server opvragen via een API call.

 

Een combinatie van deze twee methodes kan erg handig zijn. Maak bijvoorbeeld gebruik van een Webhook om een process in gang te zetten en haal de gewenste documenten van onze server via een API call.

Als je meer informatie over de configuratie van Webhooks en API wilt, bekijk dan onze Developer Docs.

3. Wanneer gebruik je een Webhook

Wij raden het gebruik van Webhooks aan wanneer:

  • Je jouw systeem wilt informeren over specifieke gebeurtenissen binnen MoreApp. Dit kunnen gebeurtenissen zijn zoals het ontvangen van nieuwe registraties, integraties in de pipeline of taken die zijn voldaan.

  • Je met andere software wilt integreren om processen te automatiseren.

  • Je jouw database wilt updaten op basis van een trigger uit MoreApp. Zo houd je jouw data gesynchroniseerd.

4. Configureer jouw Webhook

Als je via het gebruikersbeheer Rechten hebt om Webhooks te beheren ga je naar de Instellingen pagina van het Platform en open je de Webhooks tab. Klik op Voeg toe om een nieuwe Webhook aan te maken.


Let op: Je kunt maximaal 100 Webhooks per account aanmaken. 

 

Geef jouw Webhook een Naam en voeg een URL van de endpoint toe waar je wilt dat MoreApp de data naartoe stuurt. Je dient deze URL op te geven via een andere software, zoals ZapierMake of een andere automatiseringstool.


Let op: In het geval dat je meerdere Webhooks hebt, is er een mogelijkheid om deze te triggeren vanuit hetzelfde event in je account. Je kunt de URL’s combineren tot een enkele URL. Lees hier hoe je meerdere Zaps triggert met Webhooks.


Nadat je de juiste URL hebt toegevoegd, dien je het 
Event type te selecteren dat door MoreApp wordt gebruikt als trigger.


Kies bijvoorbeeld submission.created om aan te geven dat de Webhook moet worden geactiveerd wanneer er een registratie is.


Dit zijn de momenteel beschikbare soorten evenementen en de uitleg daarvan:

 

Event Type Explanation
submission.created Een eindgebruiker heeft een registratie verstuurd

submission.deleted

Er is een registratie verwijderd
sumbission.pipeline.created Begonnen met het verwerken van de registratie
submission.pipeline.blocked De verwerking van de registratie is mislukt vanwege een fout; het wordt niet automatisch opnieuw geprobeerd
submission.pipeline.failed De verwerking van de registratie is mislukt vanwege een fout; het wordt automatisch opnieuw geprobeerd
submission.pipeline.succeeded De verwerking van de registratie is geslaagd
submission.pipeline.mail.sent Door de verwerking van de registratie is een e-mail verzonden
submission.task.created Er is een taak aangemaakt
submission.task.fulfilled Een eindgebruiker heeft een taak voldaan

submission.export.scheduled

Er is een export ingepland

submission.export.started

Er is een export begonnen

submission.export.finished

Er is een export afgerond (al dan wel succesvol of mislukt)

datasource.import.failed

De Automatische Databron import is mislukt


Wanneer je klaar bent klik je op Opslaan.


Let op

  • Elke API die niet is gedocumenteerd in onze API documentatie kan op elk moment worden gewijzigd.

  • De datumweergave vanuit Webhooks is als volgt JJJJ-MM-DD.

  • Elke URL accepteert een HTTP post request met een JSON body, je krijgt dan een HTTP 200 OK status code terug. 

  • Zorg ervoor dat minimaal 1 op de 50 verzoeken succesvol terugkomt. MoreApp schakelt een klant automatisch uit zodra 50 opeenvolgende storingen zijn opgetreden. 

  • Webhooks kunnen geen data versturen van gebeurtenissen uit het verleden.

 

Wil je meteen op de hoogte zijn van de nieuwste tutorials? Ga naar YouTube en klik op Abonneren!