Gebruik je een koppeling met de API van Moneybird? Dan kan je als ontwikkelaar webhooks gebruiken om automatisch meldingen te ontvangen wanneer er iets verandert in een administratie.
Normaal gesproken moet een API-koppeling regelmatig bij Moneybird controleren of er nieuwe gegevens zijn. Met een webhook werkt dit anders: zodra er iets wijzigt, stuurt Moneybird automatisch een bericht naar een server die de ontwikkelaar heeft ingesteld.
Zo kan een koppeling direct reageren op bijvoorbeeld:
Nieuwe of aangepaste facturen
Wijzigingen in contacten
Andere gebeurtenissen in de administratie
Dit maakt koppelingen sneller en efficiënter, omdat de nieuwste gegevens automatisch worden doorgegeven.
Het probleem met onbereikbare webhooks
In de praktijk zien we dat veel ingestelde webhooks na verloop van tijd niet meer bereikbaar zijn. Bijvoorbeeld omdat:
De server van de ontwikkelaar niet meer bestaat
De URL is veranderd
De koppeling niet meer actief wordt onderhouden
Moneybird blijft in zo’n situatie proberen om updates te versturen. Als de server niet reageert, komen deze meldingen nooit aan. Dat zorgt voor onnodige belasting van ons platform. We proberen namelijk telkens een koppeling te informeren die niet meer werkt. Dit kan uiteindelijk ook vertraging veroorzaken voor andere gebruikers.
Om te voorkomen dat andere gebruikers hier problemen door ervaren schakelt Moneybird webhooks automatisch uit wanneer ze langere tijd niet bereikbaar zijn.
Een webhook wordt automatisch uitgeschakeld wanneer: Moneybird 6 uur lang geen succesvolle verbinding kan maken met de webhookserver.
Wanneer dit gebeurt:
Ontvangt de koppeling geen nieuwe updates meer
Worden er geen gebeurtenis geregistreerd in de administratie
Je kunt in de gebeurtenissenlijst zien dat de webhook is uitgeschakeld
Webhook opnieuw inschakelen
Is het probleem met de koppeling opgelost? Dan kan de webhook eenvoudig weer worden ingeschakeld.
Dat kan op twee manieren:
1. Via de API
De ontwikkelaar kan zien dat de webhook is uitgeschakeld.
Daarna kan deze via de API opnieuw worden geactiveerd.
2. Via de browser
Ga naar de lijst met webhooks in de administratie.
Daar kun je de webhook weer inschakelen zodra de koppeling weer werkt.