Stel uitgaande testimonialwebhooks in
Verbind een ontvangend eindpunt en krijg inzicht in de huidige test- en ophaalleveringsformaten.
Bijgewerkt
Het huidige Socialjuice-dashboard met voorbeeldgegevens. De labels volgen de taal van je dashboard.
Op deze pagina
Bereid een ontvangend eindpunt voor
Webhooks sturen informatie over nieuwe testimonials van ondersteunde creatieroutes naar een andere service. Je hebt een abonnement met webhooks nodig, toestemming om de werkruimte te bewerken en een openbaar bereikbare HTTPS-ontvanger. Localhost, lokale hostnamen en particuliere netwerkadressen worden niet ondersteund door de dashboard-URL-validatie.
Voor Zapier of Make maakt u eerst een ontvangende webhooktrigger en kopieert u de bijbehorende HTTPS-URL. Sluit geen klantgerichte automatisering aan voordat u de echte payload en authenticatieheaders hebt gecontroleerd die deze zal ontvangen.
Bewaar en test de verbinding
- Open Webhooks in de zijbalk. Het opent Werkruimte-instellingen → Geavanceerd.
- Voer de Webhook-URL in en kies Webhook-instellingen opslaan. Bewaar het gegenereerde ondertekeningsgeheim veilig op uw ontvangende server. Plaats het nooit in browsercode, schermafbeeldingen of openbare logbestanden.
- Kies Testgebeurtenis verzenden. Het dashboard verzendt een ondertekende webhook.test-gebeurtenis. Controleer of de ontvanger een 2xx-antwoord retourneert.
- Inspecteer het verzoek voordat u velden toewijst. Een succesvolle dashboardtest verifieert dat ondertekende testverzoek; Leveringen in afhaalformulieren gebruiken momenteel een ander formaat, dat hieronder wordt beschreven.
Begrijp de twee huidige bezorgformaten
Dashboardtestgebeurtenissen gebruiken een door HMAC ondertekende envelop met id-, type-, aangemaakt- en gegevensvelden. Headers omvatten Socialjuice-Event, Socialjuice-Delivery, Socialjuice-Timestamp en Socialjuice-Signature. Een ondertekende creatiegebeurtenis gebruikt testimonial.created; de dashboardtest gebruikt webhook.test.
De huidige verzamelservice verzendt het geconfigureerde geheim in X-Webhook-Secret via HTTPS. De HMAC-kopteksten of de ondertekende envelop worden er niet bijgevoegd. Verzamelpayloads kunnen testimonialvelden rechtstreeks of binnen een testimonialobject bevatten, afhankelijk van het verzamelpad. Inspecteer een feitelijk verzoek voordat u naam, e-mailadres, uuid en testimonialinhoud in kaart brengt. Ga er niet van uit dat de payload van de dashboardtest overeenkomt met een echte verzameling.
Authenticeer en verwerk beide formaten
Voor ondertekende verzoeken verifieert u HMAC SHA-256 via <timestamp>.<raw_request_body>, vergelijkt u de samenvatting in constante tijd en wijst u verouderde tijdstempels af. Voor incassoverzoeken vergelijkt u X-Webhook-Secret met het geconfigureerde geheim op uw server. Weiger een verzoek dat niet voldoet aan de verificatie die vereist is voor het formaat ervan.
Het gedeeld-geheim-formaat biedt geen bescherming tegen het opnieuw afspelen van ondertekende gebeurtenissen met tijdstempel en leverings-ID. Ontdubbel ophaalverzoeken met de testimonial uuid in de context van de juiste werkruimte indien beschikbaar. Voor ondertekende evenementen gebruikt u Socialjuice-Delivery of de envelop-ID. Geef alleen de klantvelden door die uw downstream-workflow nodig heeft.
Leveringslimieten en probleemoplossing
Retourneer onmiddellijk een 2xx-antwoord. De ondertekende dashboardafzender doet in totaal maximaal drie pogingen, met een time-out van 10 seconden per poging. De huidige afzender van de verzameling doet één verzoek zonder die nieuwe pogingslus. Ga er niet vanuit dat de nieuwe pogingen van de ondertekende afzender van toepassing zijn op leveringen op afhaalformulieren.
Als de ontvangende tool de vereiste header niet kan valideren, zet dan een verificatiestap op uw eigen server voordat u gevoelige acties activeert. Een webhook duidt op creatie, niet op een nieuwe toestemming om te publiceren. Controleer de publieke zichtbaarheid en toestemming afzonderlijk.
Draai of schakel de verbinding uit
Als het geheim bekend wordt, gebruik dan Geheim draaien en update alle ontvangers onmiddellijk. Hierdoor wordt het geheim gewijzigd dat door beide bezorgformaten wordt gebruikt. Om de bezorging uit te schakelen, wist u de webhook-URL en slaat u deze op. Houd het oude geheim uit openbare logs en screenshots.