Un webhook trimite date la un URL ales de dumneavoastră în momentul în care se întâmplă ceva, de exemplu când cineva se înscrie sau câștigă un premiu. Dezvoltatorul dumneavoastră configurează sistemul care le primește. Webhookurile sunt incluse începând cu planul Basic.
Adăugați un webhook
Puteți adăuga webhookuri unei campanii, în editor, sub Conectați > Webhookuri, sau pentru întregul cont, sub Setări > Webhookuri.
- Faceți clic pe Adăugați webhook.
- Introduceți URL payload. Trebuie să folosească HTTPS.
- Alegeți Tip de conținut: application/json sau application/x-www-form-urlencoded.
- Alegeți Metodă: POST sau GET. Folosiți POST, cu excepția cazului în care sistemul are nevoie de GET, care trimite datele în URL.
- Introduceți un Secret pentru a semna cererile (recomandat).
- Alegeți evenimentele sub Ce evenimente trebuie să declanșeze webhookul?:
- „Când este creat un lead nou” (la nivel de cont)
- „De fiecare dată când un lead participă la o campanie”
- „Când un lead câștigă un premiu”
- Asigurați-vă că Activ este activat și salvați.
În editorul de campanii puteți alege și Basic Auth sub Autentificare și puteți folosi Payload personalizat pentru a decide singur numele câmpurilor.
Ce se trimite
Corpul cererii conține un event și un obiect data cu campania (id și nume), câmpurile leadului, canalul, consimțămintele cu text, oră și adresă IP, răspunsurile la quiz și, pentru câștigători, premiul cu codul lui. Valorile goale sunt omise.
Verificați semnătura
Dacă setați un secret, fiecare cerere are un header X-Hub-Signature: sha1= urmat de un HMAC-SHA1 al datelor codificate JSON, cu secretul dumneavoastră drept cheie. Calculați același lucru la dumneavoastră și comparați, ca să fiți sigur că cererea vine de la Scratcher.
Livrări și reîncercări
Dacă URL-ul nu răspunde sau returnează o eroare, Scratcher mai încearcă de două ori: după 5 secunde și după un minut. Faceți clic pe Afișați livrările (sau Vedeți livrările) pentru a vedea fiecare cerere și răspuns, pentru a afișa doar livrările eșuate și pentru a folosi Încercați din nou la o livrare. Livrările sunt păstrate 60 de zile.
Activați Jurnalizați corpul răspunsului pentru a salva și ce a răspuns sistemul dumneavoastră, ceea ce ajută la depanare.