Jos käytät webhookeja työnkuluissa POST- tai GET-pyyntöjen lähettämiseen työnkuluista, voit mukauttaa webhookit ohjaamaan lähetettyjä ja vastaanotettuja tietoja.
POST-pyynnöissä voit määrittää ominaisuudet, jotka lähetetään ulkoisiin järjestelmiin, kuten CRM-järjestelmään. Vastaavasti GET-pyynnöissä voit määrittää kyselyparametrien avulla pyydetyt ominaisuudet.
Lue lisää webhookeista kehittäjien webhooks-dokumentaatiosta. Jos sinulla on kysyttävää webhookien erityisestä toteutuksesta HubSpotin kanssa, ota yhteyttä HubSpot Developers Forums -foorumeilla
.
Huomaa: HubSpot yrittää epäonnistuneita webhookeja uudelleen enintään kolmen päivän ajan, alkaen minuutin kuluttua epäonnistumisesta . Seuraavia epäonnistumisia yritetään uudelleen yhä useammin, ja kokeiden välinen aika voi olla enintään kahdeksan tuntia. Tutustu tiettyihin virhekoodipoikkeuksiin HubSpotin kehittäjädokumentaatiossa
.
Webhookin määrittäminen
Voit luoda ja mukauttaa webhookit:
- Napsauta työnkulun nimeä .
- Lisää toiminto napsauttamalla +-kuvaketta .
- Valitse oikeassa paneelissa Lähetä webhook.
- Napsauta Method (Menetelmä ) -pudotusvalikkoa ja valitse POST tai GET.
- Kirjoita webhookin URL-osoite. Webhook-URL-osoitteet on rajoitettu suojattuun protokollaan, ja niiden on alettava HTTPS:llä. Voit pyytää tiettyjä tietoja lisäämällä Webhook-URL-osoitteeseen kyselyparametreja, kuten
?queryparameter=abc. Jos kyselyparametreja ei ole lisätty, lähetetään yleinen POST- tai GET-pyyntö.
- Määritä todennustyyppi, jolla todennetaan webhookiin tulevat pyynnöt:
- Pyynnön allekirjoituksen käyttäminen webhook-otsakkeessa:
- Napsauta avattavaa Authentication type (Todennustyyppi ) -valikkoa. Valitse sitten Include request signature in header.
- Kirjoita sitten HubSpot App ID. Lue, miten pyynnön allekirjoitukset tarkistetaan.
-
- Voit myös käyttää API-avainta todennukseen. Kun käytät API-avainta todennukseen, käytetyn API-avaimen nimi ja API-avaimen sijainti riippuvat siitä, miten webhook on määritetty. Turvallisuussyistä API-avain ei näy testipyynnöissä. API-avaimen käyttäminen:
- Napsauta avattavaa Authentication type (Todennustyyppi ) -valikkoa. Valitse sitten API-avain.
-
-
- Kirjoita API-avaimen nimi.
- Napsauta API-avaimen sijainti -pudotusvalikkoa. Valitse sitten joko kyselyparametrit tai pyynnön otsikko. Lisätietoja API-avainten käytöstä HubSpotissa.
Mukauta POST-pyyntöäsi
Jos määrität POST-pyynnön, voit valita, haluatko sisällyttää kaikki CRM-tietueen ominaisuudet vai lähettää vain tietyt ominaisuudet:
- Jos haluat sisällyttää kaikki ominaisuudet, valitse Mukauta pyynnön runko -osiossa Sisällytä kaikki
ominaisuudet.
- Jos haluat sisällyttää vain tiettyjä ominaisuuksia:
- Valitse Mukauta pyynnön runko -osiossa Valitse tietyt ominaisuudet
.
- Napsauta Choose property (Valitse ominaisuus ) -pudotusvalikkoa. Napsauta sitten [objekti] tässä työnkulussa ja valitse ominaisuus
.
- Jos haluat muuttaa ominaisuuden nimeä webhookissa, muokkaa Ominaisuuden nimi
-tekstikenttää. Tämä päivittää vain ominaisuuden nimen POST-pyynnössä, se ei päivitä ominaisuuden nimeä tai sisäistä nimeä HubSpotissa.
- Jos haluat lisätä toisen ominaisuuden, valitse Lisää ominaisuus
.
- Voit poistaa ominaisuuden napsauttamalla poisto roskakorin kuvaketta
.
GET-pyyntöjen mukauttaminen
Jos määrität GET-pyynnön, voit käyttää ominaisuuksia kyselyparametreina tiettyjen tietojen hakemiseen:
- Napsauta Kyselyparametrit-osiossa Valitse ominaisuus -pudotusvalikkoa. Napsauta sitten [objekti] tässä työnkulussa ja valitse ominaisuus
.
- Jos haluat muuttaa ominaisuuden nimeä kyselyparametrissa, muokkaa Ominaisuuden nimi
-tekstikenttää. Tämä päivittää vain ominaisuuden nimen GET-pyynnössä, se ei päivitä ominaisuuden nimeä tai sisäistä nimeä HubSpotissa.
- Jos haluat lisätä toisen ominaisuuden, valitse Lisää kyselyparametri
.
- Jos haluat poistaa ominaisuuden, napsauta poista roskakori-kuvaketta
.
- Napsauta Tallenna
.