En webhook sender data til en URL du velger, i det øyeblikket noe skjer, for eksempel når noen melder seg på eller vinner en premie. Utvikleren din setter opp systemet som tar imot dataene. Webhooks er en del av Basic-planen og oppover.
Legg til en webhook
Du kan legge til webhooks på en kampanje, i editoren under Koble til > Webhooks, eller for hele kontoen under Innstillinger > Webhooks.
- Klikk på Legg til webhook.
- Skriv inn Payload-URL. Den må bruke HTTPS.
- Velg Innholdstype: application/json eller application/x-www-form-urlencoded.
- Velg Metode: POST eller GET. Bruk POST med mindre systemet ditt trenger GET, som sender dataene i URL-en.
- Skriv inn en Hemmelighet for å signere forespørslene (anbefales).
- Velg hendelsene under Hvilke hendelser skal utløse webhooken?:
- «Når en ny lead opprettes» (kontonivå)
- «Hver gang en lead deltar i en kampanje»
- «Når en lead vinner en premie»
- Sørg for at Aktiv er slått på, og lagre.
I kampanjeeditoren kan du også velge Basic Auth under Autentisering, og bruke Egendefinert payload for å bestemme feltnavnene selv.
Dette sendes
Innholdet har en event og et data-objekt med kampanjen (id og navn), leadens felter, kanalen, samtykkene med tekst, tidspunkt og IP-adresse, quizsvar og, for vinnere, premien med koden. Tomme verdier utelates.
Sjekk signaturen
Har du angitt en hemmelighet, har hver forespørsel en X-Hub-Signature-header: sha1= etterfulgt av en HMAC-SHA1 av de JSON-kodede dataene, med hemmeligheten din som nøkkel. Beregn det samme på din side og sammenlign, så du er sikker på at forespørselen kom fra Scratcher.
Leveringer og nye forsøk
Svarer ikke URL-en din, eller returnerer den en feil, prøver Scratcher igjen to ganger: etter 5 sekunder og etter et minutt. Klikk på Vis leveringer (eller Se leveringer) for å se hver forespørsel og hvert svar, vise bare de mislykkede og bruke Prøv igjen på en levering. Leveringer lagres i 60 dager.
Slå på Logg svarinnhold for også å lagre hva systemet ditt svarte, noe som hjelper når du feilsøker.