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ä.
Workflows

Käytä verkkokoukkuja HubSpot-työnkulkujen kanssa

Päivitetty viimeksi: marraskuuta 1, 2021

Tämä koskee seuraavia:

Toimet Hub Professional

Käytä webhookeja työnkuluissa siirtääksesi tietoja HubSpotista toiseen verkkosovellukseen.

Webhookeilla on monenlaisia käyttötarkoituksia, kuten tietojen lähettäminen ja ilmoitusten lähettäminen. Esimerkkejä suosituista webhookien käyttötapauksista ovat mm. seuraavat:

  • HubSpotin yhteystietojen lähettäminen toiseen järjestelmään, kuten CRM-järjestelmään, kun kyseinen yhteyshenkilö täyttää tietyn lomakkeen sivustollasi.

  • Kaupan tietojen lähettäminen ulkoiseen lähetysten käsittelyjärjestelmään ostotilauksen luomista varten.

  • Chat-ilmoitusten lähettäminen ulkoisesta järjestelmästä yrityksesi chat-virtaan, joka ilmoittaa työntekijöille, että jotain tärkeää on tapahtunut.

HubSpot säätelee webhook-liikennettä erillään muista työnkulun prosesseista. Tämä tehdään työnkulun ja webhook-suorituskyvyn virtaviivaistamiseksi. Kun webhook on hidas tai sen aika loppuu, työnkulun toimenpiteen suorittaminen voi kestää odotettua kauemmin.

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 erityisiin virhekoodipoikkeuksiin HubSpotin kehittäjädokumentaatiossa.

Lisätietoja webhookien teknisistä näkökohdista saat HubSpotin kehittäjien dokumentaatiosta.

Webhookin määrittäminen työnkulkuun

  • Siirry HubSpot-tililläsi kohtaan Automaatio > Työnkulut.
  • Napsauta työnkulunnimeä.
  • Lisää toiminto napsauttamalla+-kuvaketta.
  • Valitse oikeassa paneelissaTrigger a webhook.
  • Kirjoita webhookin URL-osoite. Webhook-URL-osoitteet on rajoitettu suojattuun protokollaan, ja niiden on alettava HTTPS:llä.
  • ValitseKäytä pyynnön allekirjoitusta-valintaruutu, jotta kaikki webhookiin tulevat pyynnöt todennetaan, ja syötä sovellustunnuksesi. Lue, mitenpyyntöjen allekirjoitukset tarkistetaan.
  • NapsautaTallenna.

Huomaa: Trigger a webhook -toiminto tukee vain POST-menetelmää.

Testaa webhookisi

Kun olet luonut työnkulun webhook-toiminnolla, voit suorittaa nopean testin valesivun webhook-URL-osoitteella. Siirry selaimessa osoitteeseen https://webhook.site ja kopioi automaattisesti luotu yksilöllinen URL-osoite. Liitä URL-osoite webhook-toiminnon Webhook URL - kenttään.

trigger-a-webhook-action


Kun webhook-toiminto käynnistyy, webhookiin lähetetään JSON-vastausrunko, joka sisältää kaikki tiedot yhteystiedosta, mukaan lukien lomakkeiden lähettämiset, luettelon jäsenyydet ja kaikki yhteystiedon ominaisuuksien arvot. Vastaanottava järjestelmä voi sitten jäsentää JSON-tiedot ja käyttää niitä omassa sovelluksessaan.

Huomaa: historialliset ominaisuusarvot palautetaan vain yhteystietopohjaisissa työnkuluissa. Kaikissa muissa työnkulkutyypeissä käytetyt verkkokoukut palauttavat vain viimeisimmän arvon.

Lue lisää webhookeista kehittäjien webhooks-dokumentaatiosta. Jos sinulla on kysyttävää webhookien erityisestä toteutuksesta HubSpotin kanssa, ota yhteyttä HubSpot Developers Forums -foorumeilla.

Pyyntöjen allekirjoitusten tarkistaminen työnkulun webhookeissa

Jos olet valinnut Request signature (Pyynnön allekirjoitus) -vaihtoehdonTrigger a webhook -toiminnon Authentication (Todentaminen ) -osiossa, HubSpot täyttää webhookin X-HubSpot-Signature-otsakkeella, jossa on SHA-256-hash, joka koostuu sovelluksesi app-salaisuuden, HTTP-menetelmän, URI:n ja käsittelemättömän rungon yhdistelmästä. Lue lisää tästäkehittäjien dokumentaatiosta.

Voit varmistaa, että URL-osoitteeseesi saapuvat pyynnöt ovat HubSpotilta: