Een webhook is een bericht dat we via POST naar het adres van uw app sturen wanneer er iets in uw bedrijf gebeurt, zodat de andere app niet steeds hoeft te vragen.
-
Stap 1: Een endpoint toevoegen
Klik in Administratie → Instellingen → API & webhooks, onder Webhooks, op Endpoint toevoegen.
-
Stap 2: Het adres invullen
Vul de Endpoint-URL in (dit moet een openbaar https://-adres zijn) en eventueel een Omschrijving.
-
Stap 3: De gebeurtenissen kiezen
Vink onder Gebeurtenissen de gebeurtenissen aan die u nodig hebt, of Alle gebeurtenissen, ook later toegevoegde.
-
Stap 4: Het ondertekeningsgeheim kopiëren
Na het opslaan wordt het Ondertekeningsgeheim één keer getoond. Kopieer het naar de ontvangende app zodat die kan controleren of elk bericht echt van ons komt.
-
Stap 5: Testen
Klik op Testgebeurtenis verzenden en controleer het Afleverlogboek.
Beschikbare gebeurtenissen
- Contacten: een contact is aangemaakt of bijgewerkt.
- Facturen: uitgegeven, volledig betaald, ingetrokken. Offertes: geaccepteerd.
- Betalingen: een betaling of ontvangst is geboekt.
- Inkoopfacturen: ontvangen (geboekt), volledig betaald. Uitgaven: een uitgave is geregistreerd.
- Voorraad: een artikel is gedaald tot of onder het bestelniveau.
- Verlof: er is een verlofaanvraag aangemaakt.
Aflevering en nieuwe pogingen
- Uw app moet binnen 10 seconden antwoorden met een 2xx-status. Alles anders telt als mislukt.
- Mislukte afleveringen worden automatisch opnieuw geprobeerd, tot zes pogingen verspreid over enkele uren, met telkens langere wachttijden.
- Open een endpoint met Beheren om het Afleverlogboek te zien: elke gebeurtenis met de Payload, het Antwoord van uw server en een status Geleverd, Mislukt of In afwachting. Klik op Opnieuw verzenden om er een opnieuw te sturen.
- Vink Gebeurtenissen naar dit endpoint verzenden uit om het te pauzeren, of klik op Verwijderen om het te verwijderen. Een endpoint dat lange tijd blijft mislukken, wordt automatisch uitgeschakeld.
De handtekening verifiëren
Elke aflevering heeft de header X-Webhook-Signature: t=<timestamp>,v1=<signature>. Bereken HMAC-SHA256 van “<timestamp>.<raw body>” met uw ondertekeningsgeheim en vergelijk het met v1; weiger tijdstempels ouder dan 5 minuten. X-Webhook-Id blijft bij nieuwe pogingen hetzelfde, dus gebruik het om dubbele berichten te negeren.
Gerelateerde handleidingen
Vraag over het product
Vraag wat de software kan, hoe een taak werkt, of welke landen en talen worden ondersteund. Antwoorden komen uit deze handleidingen.
Bezig met nadenken…
De AI-assistent is op dit moment niet beschikbaar. Doorzoek de handleidingen of neem contact op met ons team. Contact met support
AI kan fouten maken. Controleer de gelinkte handleidingen.
Nog hulp nodig?
Ons supportteam leest elk bericht en antwoordt in begrijpelijke taal.
Contact met support