Met Standaardwebhooks kan Enquete automatisch enquêtegerelateerde informatie naar een andere applicatie verzenden wanneer een geselecteerde gebeurtenis plaatsvindt.
Wanneer een respondent bijvoorbeeld een enquête indient of voltooit, kan Enquete de gebeurtenisgegevens rechtstreeks verzenden naar uw CRM-systeem, rapportageplatform, interne database, supportapplicatie, marketingplatform of een andere externe dienst.
Hierdoor kan uw organisatie workflows automatiseren en enquêtegegevens tussen systemen verplaatsen zonder reacties steeds opnieuw te exporteren of informatie handmatig over te dragen.
In deze handleiding wordt uitgelegd hoe u Standaardwebhooks via de Enquete-interface kunt aanmaken, configureren, testen, controleren en beheren.
Belangrijk:
Standaardwebhooks zijn bedoeld voor organisaties die toegang hebben tot een ontwikkelaar of technisch team. Uw ontvangende applicatie moet een openbaar toegankelijk HTTPS-endpoint beschikbaar stellen dat HTTP POST-verzoeken kan ontvangen.
Raadpleeg voor de volledige technische referentie, waaronder ondersteunde payloads, webhookheaders, handtekeningverificatie, gebeurtenisschema’s en implementatiedetails, de officiële Enquete-webhookdocumentatie.
Een Standaardwebhook is een geautomatiseerde verbinding tussen Enquete en een externe applicatie.
Wanneer een gebeurtenis plaatsvindt in een geselecteerde enquête, verzendt Enquete een HTTP POST-verzoek naar de endpoint-URL die in het webhookabonnement is geconfigureerd.
Afhankelijk van de workflow van uw organisatie kan een webhook worden gebruikt om:
Elke Standaardwebhook is gekoppeld aan een specifieke enquête en een specifiek gebeurtenistype. Hierdoor bepaalt u welke activiteiten een levering activeren en waar de informatie naartoe wordt verzonden.
Controleer voordat u een Standaardwebhook instelt of uw technische team het volgende heeft voorbereid:
Het ontvangende endpoint moet snel reageren nadat een verzoek is geaccepteerd. Langdurige bewerkingen moeten normaal gesproken naar een wachtrij of achtergrondverwerkingssysteem worden doorgestuurd nadat het endpoint een succesvolle respons heeft geretourneerd.
Ontwikkelaars moeten de officiële Webhookdocumentatie raadplegen voordat zij het ontvangende endpoint implementeren.
Selecteer vanuit uw Enquete-dashboard bovenaan in het menu Integraties.
Open Standaardwebhooks vanuit de beschikbare integratieopties.
Het overzicht van Standaardwebhooks toont alle webhookabonnementen die in uw account beschikbaar zijn.
Vanaf deze pagina kunt u:
Klik in het overzicht van Standaardwebhooks op Webhook toevoegen.
Er wordt een configuratieformulier geopend.
Voer het HTTPS-endpoint in waarnaar Enquete de webhookleveringen moet verzenden.
Bijvoorbeeld:
https://example.com/api/enquete/webhookHet endpoint moet openbaar toegankelijk zijn en HTTP POST-verzoeken kunnen accepteren.
Localhost-adressen, privé-ontwikkel-URL’s en pagina’s waarvoor interactief moet worden ingelogd, kunnen geen webhookleveringen van Enquete ontvangen.
Voer een beschrijving in die duidelijk het doel van de webhook uitlegt.
Bijvoorbeeld:
Voltooide klanttevredenheidsreacties naar ons CRM-systeem verzendenEen duidelijke beschrijving maakt het eenvoudiger om de webhook later terug te vinden, vooral wanneer uw organisatie meerdere abonnementen beheert.
Selecteer de enquête waarvan de gebeurtenissen de webhook moeten activeren.
Een Standaardwebhookabonnement is aan één enquête gekoppeld. Wanneer u gebeurtenissen van meerdere enquêtes wilt verzenden, moet u voor elke enquête een afzonderlijk webhookabonnement aanmaken.
Selecteer de gebeurtenis die de webhooklevering moet activeren.
Gebeurtenissen die beschikbaar kunnen zijn in de interface voor Standaardwebhooks zijn onder andere:
De beschikbare gebeurtenissen kunnen afhankelijk zijn van de huidige Enquete-configuratie en de functies die voor uw account zijn ingeschakeld.
Kies of de webhook onmiddellijk actief moet zijn.
Wanneer een webhook actief is, verzendt Enquete een levering wanneer de geselecteerde gebeurtenis plaatsvindt.
Wanneer de webhook inactief is, blijft de configuratie beschikbaar, maar worden leveringen van livegebeurtenissen gepauzeerd.
U kunt een webhook inactief laten terwijl uw technische team het ontvangende endpoint voorbereidt of test.
Klik op Opslaan om het webhookabonnement aan te maken.
De nieuwe webhook verschijnt in het overzicht van Standaardwebhooks en kan onmiddellijk worden getest.
Elke Standaardwebhook heeft een geheim. De ontvangende applicatie gebruikt dit geheim om te verifiëren dat een binnenkomend verzoek daadwerkelijk van Enquete afkomstig is.
Het webhookgeheim moet op dezelfde manier worden behandeld als een wachtwoord of persoonlijke API-referentie.
Zoek de webhook in het overzicht en klik op het oogpictogram.
Het geheim wordt tijdelijk weergegeven.
Klik op het klembordpictogram om het geheim te kopiëren.
Om veiligheidsredenen wordt het geheim na ongeveer tien seconden automatisch weer verborgen.
Geef het geheim door aan de ontwikkelaar die verantwoordelijk is voor het ontvangende endpoint en sla het op een beveiligde locatie aan de serverzijde op, zoals:
Sla het geheim niet op in frontend-JavaScript, openbare repositories, screenshots, gedeelde documenten of supportberichten die toegankelijk zijn voor onbevoegde gebruikers.
U moet elke webhook testen voordat u deze in een liveworkflow gebruikt.
Met een testlevering controleert u of het endpoint bereikbaar is en of de ontvangende server een passende respons retourneert.
Zoek het webhookabonnement in het overzicht van Standaardwebhooks.
Klik op het bliksempictogram in de rij van de webhook.
Enquete verzendt een testverzoek naar het geconfigureerde endpoint.
In een melding op de pagina wordt de HTTP-status weergegeven die door het endpoint is geretourneerd.
Een succesvolle levering retourneert normaal gesproken een statuscode binnen het bereik van 200 tot en met 299, zoals:
Wanneer de test mislukt, opent u de leveringslogboeken om de responsstatus, responsbody, foutinformatie en duur van het verzoek te controleren.
U kunt een bestaande webhook bijwerken wanneer het endpoint, de enquête, het gebeurtenistype, de beschrijving of de activeringsstatus verandert.
Zoek de webhook en selecteer de actie Bewerken.
U kunt instellingen bijwerken, zoals:
Sla de webhook op nadat u de wijzigingen heeft aangebracht.
De bijgewerkte configuratie wordt voor toekomstige leveringen gebruikt.
Verzend altijd opnieuw een testlevering nadat u de endpoint-URL, enquête of het gebeurtenistype heeft gewijzigd.
De leveringslogboeken tonen de verzoeken die Enquete naar uw endpoint heeft verzonden en de responsen die door de ontvangende server zijn geretourneerd.
Gebruik deze logboeken om de werking van uw integratie te controleren en mislukte leveringen te onderzoeken.
Zoek het webhookabonnement en klik naast de verwijderknop op het pictogram Logboeken bekijken.
U kunt leveringen filteren op:
Vouw een leveringsitem uit om de beschikbare diagnostische informatie te bekijken.
Het leveringsrecord kan de volgende informatie bevatten:
Leveringslogboeken zijn vooral nuttig na:
Elk webhookverzoek bevat headers waarmee de ontvangende applicatie de levering kan identificeren, verifiëren en volgen.
| Header | Beschrijving |
|---|---|
| X-Enquete-Signature | Bevat de handtekening waarmee wordt geverifieerd dat het verzoek van Enquete afkomstig is. |
| X-Enquete-Event | Identificeert het gebeurtenistype dat de levering heeft geactiveerd. |
| X-Enquete-Delivery | Bevat een unieke leverings-ID die wordt gebruikt voor tracking en het voorkomen van dubbele verwerking. |
Uw technische team moet de handtekeningheader gebruiken om binnenkomende verzoeken te authenticeren en de leveringsheader gebruiken om te voorkomen dat dezelfde gebeurtenis meer dan één keer wordt verwerkt.
Raadpleeg voor de exacte indeling van de handtekening, het payloadschema en implementatievoorbeelden de officiële Webhookdocumentatie.
Een webhooklevering kan meer dan één keer worden geprobeerd wanneer het eerste verzoek mislukt, een time-out veroorzaakt of geen succesvolle respons retourneert.
Dit betekent dat de ontvangende applicatie een levering die al is verwerkt moet kunnen herkennen en veilig moet kunnen negeren.
Elk verzoek bevat een unieke waarde in de header X-Enquete-Delivery.
Uw technische team moet deze waarde als idempotentiesleutel gebruiken.
Een gebruikelijk proces voor het voorkomen van dubbele verwerking is:
Verwerkte leverings-ID’s moeten worden bewaard gedurende een periode die past bij het integratie- en retrybeleid van uw organisatie.
Deactiveer een webhook wanneer u leveringen tijdelijk wilt stoppen zonder de configuratie te verwijderen.
U kunt een webhook deactiveren wanneer:
Wanneer de webhook opnieuw wordt geactiveerd, kunnen toekomstige overeenkomende gebeurtenissen worden geleverd.
Gebeurtenissen die plaatsvinden terwijl de webhook inactief is, worden mogelijk niet automatisch op een later moment geleverd.
Verwijder een webhook wanneer het abonnement niet langer nodig is.
Zoek de webhook en klik op de actie Verwijderen.
Bevestig dat u het webhookabonnement permanent wilt verwijderen.
Na de verwijdering verzendt Enquete geen nieuwe leveringen meer voor deze webhook.
Historische leveringsrecords kunnen voor audit-, probleemoplossings- of operationele doeleinden in backendrecords beschikbaar blijven.
Belangrijk: Wanneer u de webhook alleen tijdelijk wilt pauzeren, moet u deze deactiveren in plaats van verwijderen.
Controleer het volgende:
Langdurige taken moeten in een wachtrij worden geplaatst voor achtergrondverwerking, in plaats van volledig te worden uitgevoerd voordat de server zijn respons retourneert.
Vraag uw technische team om het volgende te controleren:
Handtekeningverificatie is een technische implementatietaak. Raadpleeg de officiële Webhookdocumentatie voor de actuele verificatie-instructies.
Controleer het volgende:
Een 401- of 403-respons betekent normaal gesproken dat de ontvangende server het verzoek heeft geweigerd vanwege een authenticatie- of autorisatieregel.
Controleer of:
Een 404-respons betekent meestal dat de endpoint-URL niet overeenkomt met een beschikbare route op de ontvangende server.
Controleer de volledige URL en bevestig dat de route bestaat en HTTP POST-verzoeken accepteert.
Een 500-respons geeft aan dat er binnen de ontvangende applicatie een fout is opgetreden.
Uw technische team moet de serverlogboeken van de ontvangende applicatie bekijken, samen met de leveringspayload en leverings-ID die in Enquete worden weergegeven.
Webhookverzoeken kunnen na fouten of time-outs opnieuw worden geprobeerd.
Uw technische team moet de waarde X-Enquete-Delivery gebruiken om leveringen te identificeren die al zijn verwerkt.
Controleer voordat u een Standaardwebhook in een liveworkflow gebruikt of u het volgende heeft voltooid:
Nadat de webhook live is gegaan, moet u mislukte leveringen en de prestaties van het endpoint regelmatig controleren om er zeker van te zijn dat de integratie correct blijft werken.
Raadpleeg voor payloadvelden, gebeurtenisschema’s, voorbeelden voor handtekeningverificatie en andere ontwikkelaarsspecifieke instructies altijd de officiële Enquete-webhookdocumentatie.