En webhook skickar data till en URL som du väljer i samma ögonblick som något händer, till exempel när någon registrerar sig eller vinner en vinst. Din utvecklare sätter upp systemet som tar emot den. Webhooks ingår från Basic-planen och uppåt.
Lägg till en webhook
Du kan lägga till webhooks för en kampanj, i redigeraren under Anslut > Webhooks, eller för hela ditt konto under Inställningar > Webhooks.
- Klicka på Lägg till webhook.
- Ange Payload-URL. Den måste använda HTTPS.
- Välj Innehållstyp: application/json eller application/x-www-form-urlencoded.
- Välj Metod: POST eller GET. Använd POST om inte ditt system kräver GET, som skickar data i URL:en.
- Ange en Hemlighet för att signera förfrågningarna (rekommenderas).
- Välj händelser under Vilka händelser ska utlösa webhooken?:
- "När en ny lead skapas" (kontonivå)
- "Varje gång en lead deltar i en kampanj"
- "När en lead vinner en vinst"
- Kontrollera att Aktiv är påslaget och spara.
I kampanjredigeraren kan du också välja Basic Auth under Autentisering och använda Anpassad payload för att själv bestämma fältnamnen.
Det här skickas
Innehållet har ett event och ett data-objekt med kampanjen (id och namn), leadets fält, kanalen, samtyckena med text, tidpunkt och IP-adress, quizsvar och, för vinnare, vinsten med dess kod. Tomma värden utelämnas.
Kontrollera signaturen
Om du har angett en hemlighet har varje förfrågan en X-Hub-Signature-header: sha1= följt av en HMAC-SHA1 av den JSON-kodade datan, med din hemlighet som nyckel. Räkna fram samma värde på din sida och jämför, så vet du att förfrågan kom från Scratcher.
Leveranser och nya försök
Om din URL inte svarar eller returnerar ett fel försöker Scratcher igen två gånger: efter 5 sekunder och efter en minut. Klicka på Visa leveranser för att se varje förfrågan och svar, visa bara misslyckade och använda Försök igen på en leverans. Leveranser sparas i 60 dagar.
Slå på Logga svarsinnehåll för att också spara vad ditt system svarade, vilket hjälper vid felsökning.