Webhook

Een webhook is een HTTP-callback die automatisch data stuurt van de ene applicatie naar de andere wanneer een specifieke gebeurtenis plaatsvindt. In tegenstelling tot [API's](/glossary/api) waarbij je om updates moet vragen (polling), pushen webhooks data in realtime zodra gebeurtenissen zich voordoen. De ontvangende applicatie luistert op een gespecificeerd URL-eindpunt en verwerkt de binnenkomende data onmiddellijk bij aankomst. Webhooks volgen een publisher-subscriber model: de bronapplicatie stuurt een HTTP POST-verzoek naar een vooraf geregistreerde URL wanneer een triggergebeurtenis plaatsvindt, en de subscriber verwerkt de payload zonder deze ooit te hoeven opvragen.

Webhooks elimineren de noodzaak voor handmatige dataoverdrachten of constant pollen tussen systemen. Voor digitale uitgevers betekent dit dat verzamelde leads, verkooptransacties en kijkeractiviteit automatisch en in realtime naar CRM's, e-mailplatforms of interne databases kunnen stromen op het moment dat ze plaatsvinden. Dit vermindert vertragingen van minuten of uren naar milliseconden, elimineert handmatig export-importwerk en zorgt ervoor dat je bedrijfssystemen altijd actuele data hebben. Zonder webhooks moeten teams dashboards handmatig controleren of geplande batchprocessen bouwen die achterlopen op realtime-gebeurtenissen.

FlipLink's functie [automatisering en integraties](/features/automation-and-integrations) ondersteunt webhooks die worden geactiveerd bij belangrijke gebeurtenissen. Je kunt webhook-eindpunten configureren om data te ontvangen wanneer een nieuwe lead wordt verzameld, een document wordt bekeken of een verkoop wordt voltooid via Stripe. Elke webhook stuurt een gestructureerde JSON-payload met de gebeurtenisdetails naar je opgegeven URL. Hiermee kun je FlipLink verbinden met vrijwel elk systeem, inclusief tools zoals Zapier, Make of aangepaste backends. In combinatie met de [Google Sheets-integratie](/features/automation-and-integrations) geven webhooks uitgevers een flexibele manier om hun volledige publicatieworkflow te automatiseren zonder code te schrijven.

Wanneer een triggergebeurtenis plaatsvindt, stuurt FlipLink een HTTP POST-verzoek naar je geregistreerde eindpunt-URL. De verzoekbody bevat een JSON-payload met de volgende structuur: - **Gebeurtenistype** — een string die het gebeurtenistype identificeert (bijv. `lead.captured`, `document.viewed`, `sale.completed`) - **Tijdstempel** — datum en tijd van de gebeurtenis in ISO 8601-formaat - **Payloaddata** — de gebeurtenisspecifieke velden zoals contactnaam, e-mail, documenttitel of transactiebedrag Je eindpunt moet een HTTP 200-statuscode retourneren om ontvangst te bevestigen. Als het eindpunt een fout retourneert of een timeout optreedt, herhaalt FlipLink de bezorging om ervoor te zorgen dat geen gebeurtenissen verloren gaan. Alle webhook-payloads worden via [HTTPS](/glossary/https) verzonden, dus data is versleuteld tijdens transport. Voor ontwikkelaars die aangepaste integraties bouwen, maakt de consistente JSON-structuur het eenvoudig om gebeurtenissen te parsen en naar de juiste handler in je applicatie te routeren.

1. **Bereid je eindpunt voor.** Stel een HTTPS-URL in op je server, Zapier, Make of elke dienst die POST-verzoeken kan ontvangen. Het eindpunt moet publiek toegankelijk zijn en een 200-respons retourneren. 2. **Navigeer naar integraties.** Ga in je FlipLink-dashboard naar de instellingen voor [automatisering en integraties](/features/automation-and-integrations) van je publicatie. 3. **Voeg de webhook-URL toe.** Plak de URL van je eindpunt in het webhook-configuratieveld. 4. **Selecteer triggergebeurtenissen.** Kies welke gebeurtenissen de webhook moeten activeren — leadverzameling, documentweergave, verkoopvoltooiing of andere afhankelijk van je workflowbehoeften. 5. **Stuur een testgebeurtenis.** Gebruik de testfunctie om een voorbeeldpayload naar je eindpunt te sturen. Controleer of je systeem de data correct ontvangt en verwerkt. 6. **Ga live.** Sla je configuratie op. Vanaf dit punt activeert elke overeenkomende gebeurtenis in je [flipbook](/glossary/flipbook) een realtime POST naar je eindpunt. 7. **Monitor de bezorging.** Controleer periodiek de logs van je eindpunt om te bevestigen dat webhooks aankomen. Als je hiaten opmerkt, controleer dan of je eindpunt 200-responses retourneert en of je server geen firewallregels heeft die FlipLink-verzoeken blokkeren.

| Aspect | Webhook | API Polling | |--------|---------|-------------| | **Datalevering** | Automatische push wanneer gebeurtenissen plaatsvinden | Pull volgens een gedefinieerd schema | | **Latentie** | Vrijwel direct (milliseconden) | Afhankelijk van pollinginterval (seconden tot minuten) | | **Serverbelasting** | Minimaal — verzoeken alleen bij gebeurtenissen | Hoger — verzoeken bij elk interval, ook als er niets is veranderd | | **Implementatie** | URL registreren en binnenkomende POST-verzoeken afhandelen | Geplande taak bouwen die het API-eindpunt herhaaldelijk aanroept | | **Ideaal voor** | Realtime meldingen, CRM-synchronisatie, directe alerts | Batchverwerking, periodieke rapporten, datasnapshots | | **Risico** | Eindpunt-downtime kan gebeurtenissen missen zonder retry-logica | Geen gemiste gebeurtenissen als polling bijblijft, maar vertraagd bewustzijn | Voor de meeste FlipLink-uitgevers zijn webhooks de betere keuze voor leadverzamelings- en verkoopgebeurtenissen waar snelheid telt. API-polling werkt beter voor periodieke analytics-exports of dashboards die op vaste intervallen vernieuwen. Veel teams gebruiken beide: webhooks voor realtime leadroutering en de [REST API](/glossary/rest-api) voor nachtelijke analytics-extracties.