Lähetä tietoja järjestelmiisi webhookeilla

Webhook lähettää tietoja valitsemaasi URL-osoitteeseen heti, kun jotain tapahtuu, esimerkiksi kun joku ilmoittautuu tai voittaa palkinnon. Kehittäjäsi rakentaa järjestelmän, joka vastaanottaa ne. Webhookit sisältyvät Basic-pakettiin ja sitä ylempiin.

Lisää webhook

Voit lisätä webhookeja kampanjaan editorissa kohdassa Yhdistä > Webhookit tai koko tilillesi kohdassa Asetukset > Webhookit.

1. Klikkaa Lisää webhook.
2. Syötä Payload-URL. Sen on käytettävä HTTPS:ää.
3. Valitse Sisältötyyppi: application/json tai application/x-www-form-urlencoded.
4. Valitse Menetelmä: POST tai GET. Käytä POSTia, ellei järjestelmäsi tarvitse GETiä, joka lähettää tiedot URL-osoitteessa.
5. Syötä Salaisuus pyyntöjen allekirjoittamista varten (suositellaan).
6. Valitse tapahtumat kohdassa Mitkä tapahtumat käynnistävät webhookin?:
   • ”Kun uusi liidi luodaan” (tilitasolla)
   • ”Aina kun liidi osallistuu kampanjaan”
   • ”Kun liidi voittaa palkinnon”
7. Varmista, että Aktiivinen on päällä, ja tallenna.

Kampanjaeditorissa voit myös valita kohdassa Tunnistautuminen Basic Auth -vaihtoehdon ja käyttää Mukautettu payload -asetusta, jos haluat päättää kenttien nimet itse.

Mitä lähetetään

Rungossa on event ja data-objekti, jossa ovat kampanja (id ja nimi), liidin kentät, kanava, suostumukset tekstin, ajankohdan ja IP-osoitteen kanssa, tietovisan vastaukset ja voittajille palkinto koodeineen. Tyhjät arvot jätetään pois.

Tarkista allekirjoitus

Jos asetat salaisuuden, jokaisessa pyynnössä on X-Hub-Signature-otsake: sha1= ja sen perässä JSON-koodatun datan HMAC-SHA1, jonka avaimena on salaisuutesi. Laske sama omalla puolellasi ja vertaa, niin voit olla varma, että pyyntö tuli Scratcherilta.

Toimitukset ja uudelleenyritykset

Jos URL-osoitteesi ei vastaa tai palauttaa virheen, Scratcher yrittää uudelleen kahdesti: 5 sekunnin ja minuutin kuluttua. Klikkaa Näytä toimitukset, niin näet jokaisen pyynnön ja vastauksen, voit näyttää vain epäonnistuneet ja valita toimitukselle Yritä uudelleen. Toimituksia säilytetään 60 päivää.

Ota käyttöön Kirjaa vastauksen sisältö lokiin, jos haluat tallentaa myös järjestelmäsi vastauksen, mikä auttaa vianmäärityksessä.