Personyze Wiki Personyze Wiki docs
Nederlands
Open Personyze
Docs/ Automation & Webhooks/ Webhookactie
Automation & Webhooks

Webhookactie

POST een bericht met live bezoekersdata naar een willekeurige URL als een bezoeker bij je campagne past — instellen, het voorbeeld van het verzoek, en iets doen met het antwoord.

2 min read Updated 34 minutes ago

De actie Webhook POST een bericht naar een willekeurige URL als een bezoeker bij je campagne past — met waarden die live uit het profiel, de sessie of containers op de pagina komen. Gebruik het om een contact bij te werken in Salesforce of Zapier, een Slack-melding te plaatsen als een doelaccount binnenkomt, of een interne API aan te roepen.

Aangeroepen vanaf onze servers, niet vanuit de browser. Er valt geen CORS in te stellen en de bezoeker ziet de inloggegevens nooit — maar het endpoint moet vanaf het openbare internet bereikbaar zijn.

Instellen

  1. In de stap Content van de campagne: Actie toevoegen → Webhook.
  2. Snelle configuratie (optioneel) — druk op Slack, Discord, Microsoft Teams, Zapier, Make of n8n en de methode, het formaat en het berichtveld worden voor die dienst vooraf ingesteld. Je URL wordt door deze knoppen nooit gewijzigd.
  3. Eindpunt — methode en adres. POST heeft een body; velden gaan in de body, tenzij je ze naar de URL verplaatst.
  4. Authenticatie — klassieke HTTP-authenticatie als het endpoint die gebruikt; de meeste moderne API’s nemen in plaats daarvan een token in een header — voeg Authorization: Bearer … toe onder Headers.
  5. Velden — één sleutel + één waarde per rij. Een waarde is een vaste tekenreeks, of wordt van de bezoeker gelezen: profielveld, sessie-eigenschap of een paginacontainer. Zet een rij op URL om die als queryparameter te versturen.
  6. Body-formaatapplication/x-www-form-urlencoded (standaard), JSON, enz., met optionele compressie.
Editor van de webhookactie
Alles op één scherm — met onderaan een livevoorbeeld van het exacte verzoek. Klik om te vergroten.

Het voorbeeld van het verzoek

De editor toont het verzoek precies zoals het wordt verstuurd — en biedt Kopiëren als cURL, de snelste manier om je endpoint te testen en een verkeerde veldnaam te vinden voordat er iets wordt gepubliceerd. Waarden die van de bezoeker worden gelezen, verschijnen als ‹…› -placeholders; die worden per bezoeker ingevuld als de actie afgaat.

Iets doen met het antwoord

De meeste webhooks zijn afvuren-en-vergeten. Geeft het endpoint iets nuttigs terug — een score, een segment, een ID — zet dan Resultaat opslaan in gebruikersprofiel aan en kies het profielveld: de waarde uit het antwoord komt op het profiel van de bezoeker terecht, klaar om er later op te targeten. Draait één keer per bezoeker per keer dat de actie afgaat.

Wanneer en waar

Gaat af als de targeting van de campagne past; Inperken tot beperkt het tot specifieke paginagroepen. Gebruik voor het versturen van formulierinzendingen liever de eigen bestemmingen van het formulier onder Waar de data naartoe gaat.

Did this page answer your question?
Thank you — that goes to whoever maintains this page.