Siirry sisältöön
Huomaa: Tämän artikkelin käännös on tarkoitettu vain tiedoksi. Käännös on luotu automaattisesti käännösohjelmiston avulla, eikä sitä ole välttämättä tarkistettu. Näin ollen tämän artikkelin englanninkielistä versiota on pidettävä hallitsevana versiona, joka sisältää uusimmat tiedot. Voit tutustua siihen täällä.

Mukauta verkkokoukkujasi (BETA)

Päivitetty viimeksi: kesäkuuta 20, 2023

Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:

Operations Hub Professional, Enterprise

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:

  • Siirry HubSpot-tililläsi kohtaan Automaatio > Työnkulut.
  • 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


.










Oliko tästä artikkelista apua?
Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.