Een webhook stuurt gegevens naar een URL die jij kiest, op het moment dat er iets gebeurt, bijvoorbeeld als iemand zich aanmeldt of een prijs wint. Je ontwikkelaar zet het systeem op dat de gegevens ontvangt. Webhooks zitten in het Basic-abonnement en hoger.
Een webhook toevoegen
Je kunt webhooks toevoegen aan een campagne, in de editor onder Koppelen > Webhooks, of voor je hele account onder Instellingen > Webhooks.
- Klik op Webhook toevoegen.
- Vul de Payload-URL in. Die moet HTTPS gebruiken.
- Kies het Type inhoud: application/json of application/x-www-form-urlencoded.
- Kies de Methode: POST of GET. Gebruik POST, tenzij je systeem GET nodig heeft. GET stuurt de gegevens in de URL.
- Vul een Secret in om de verzoeken te ondertekenen (aanbevolen).
- Kies de gebeurtenissen onder Welke gebeurtenissen moeten de webhook activeren?:
- "Wanneer er een nieuwe lead wordt aangemaakt" (op accountniveau)
- "Elke keer dat een lead deelneemt aan een campagne"
- "Wanneer een lead een prijs wint"
- Zorg dat Actief aanstaat en sla op.
In de campagne-editor kun je onder Authenticatie ook Basic Auth kiezen, en met Eigen payload zelf de veldnamen bepalen.
Wat wordt er verstuurd
De body bevat een event en een data-object met de campagne (id en naam), de velden van de lead, het kanaal, de toestemmingen met tekst, tijdstip en IP-adres, quizantwoorden en, bij winnaars, de prijs met de code. Lege waarden worden weggelaten.
De handtekening controleren
Heb je een secret ingesteld, dan heeft elk verzoek een header X-Hub-Signature: sha1= gevolgd door een HMAC-SHA1 van de JSON-gecodeerde gegevens, met je secret als sleutel. Bereken hetzelfde aan jouw kant en vergelijk, zodat je zeker weet dat het verzoek van Scratcher komt.
Leveringen en nieuwe pogingen
Reageert je URL niet of geeft hij een fout terug, dan probeert Scratcher het nog twee keer: na 5 seconden en na een minuut. Klik op Leveringen tonen (of Leveringen bekijken) om elk verzoek en elke response te zien, alleen mislukte te tonen en een levering Opnieuw proberen. Leveringen worden 60 dagen bewaard.
Zet Response body loggen aan om ook op te slaan wat je systeem antwoordde. Dat helpt bij het debuggen.