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: elokuuta 22, 2022

Tämä koskee seuraavia:

Operations Hub Professional

Käytä webhookeja työnkuluissa tietojen lähettämiseen tai hakemiseen HubSpotin ja muiden ulkoisten työkalujen välillä. Webhookeille on monenlaisia käyttötarkoituksia, esimerkkejä webhookien suosituista 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, jotta työntekijöille voidaan ilmoittaa, että jotain tärkeää on tapahtunut.

  • Tietojen hakeminen toisesta järjestelmästä HubSpot-tietueiden päivittämiseksi.

Voit lähettää sekä POST- että GET-pyyntöjä työnkulkujen avulla. HubSpot säätelee webhook-liikennettä erillään muista työnkulun prosesseista. Tämä tehdään työnkulkujen ja webhookien suorituskyvyn tehostamiseksi. 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.

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

Webhookin määrittäminen työnkulkuun

  • 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.
  • 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.
    • Sisällyttää vain tiettyjä ominaisuuksia:
      • Valitse Customize request body (Mukauta pyynnön runko ) -osiossa Choose specific properties (Valitse tietyt ominaisuudet).
      • Napsauta Valitse ominaisuus -pudotusvalikkoa. Valitse 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
        .


  • Jos määrität GET-pyynnön, voit käyttää ominaisuuksia kyselyparametreina:
    • 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.



POST-pyynnön mukauttaminen

Jos määrität POST-pyynnön, voit valita, haluatko sisällyttää kaikki CRM-tietueen ominaisuudet tai lähettää vain tiettyjä ominaisuuksia:

  • Jos haluat sisällyttää kaikki ominaisuudet, valitse Mukauta pyynnön runko -osiossa Sisällytä kaikki ominaisuudet.
  • Voit 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 Property name -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.

Testaa webhookisi HubSpotissa

Kun olet määrittänyt POST- tai GET-verkkokoukun, voit suorittaa testin, jolla voit tarkastella verkkokoukun vastausta. Testin aikana tietoja lähetetään ja haetaan kolmannelle osapuolelle, mutta se ei vaikuta HubSpotissa oleviin tietueisiin . Jos käytät API-avainta todennukseen, API-avain ei näy testipyynnöissä.

Kun olet testannut webhookin, voitvalita, mitkä kentät tulostetaan käytettäväksi syötteinä myöhemmin työnkulussa. Valitse vain tulosteet, jotka ovat käytettävissä jokaisessa vastauksessa. Jos tulostetta käytetään myöhemmässä toiminnossa, mutta se ei ole käytettävissä vastauksessa, toiminto epäonnistuu.

  • Laajenna osio sivupaneelissa valitsemalla Testaa toiminto.
  • Napsauta avattavaa Object (Kohde ) -valikkoa ja valitse sitten Record (Tietue ), jolla testataan.
  • Napsauta Testaa.
  • Voit tarkistaa webhookin tiedot valitsemalla Vastaus- tai Pyyntö-välilehden. Kummassakin välilehdessä voit avata kaikki osiot valitsemalla Avaa kaikki tai sulkea kaikki o siot valitsemalla Sulje kaikki.
    • Laajenna kukin osio vastaus-välilehdellä napsauttamalla otsikot: tai runko :.
    • Laajenna Request (Pyyntö ) -välilehdessä oleva osio valitsemalla httpHeaders: .

Testaa verkkokoukku ulkoisesti

Kun olet luonut työnkulun webhook-toiminnolla, voit suorittaa nopean testin valesivun webhook-URL-osoitteella:

  • Siirry selaimessa osoitteeseen https://webhook.site ja kopioi yksilöllinen URL-osoite.
  • Liitä URL-osoite webhook-toiminnon Webhook URL -kenttään.

Jos POST-pyynnön sisältävä 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.

Jos GET-pyynnön sisältävä webhook-toiminto käynnistetään, lähetetään yleinen GET-pyyntö, ellei ole käytetty lisäkyselyparametreja.

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

Pyyntöjen allekirjoitusten tarkistaminen työnkulun webhookeissa

Jos olet valinnut Request signature (Pyynnön allekirjoitus ) -toiminnon Authentication (Todentaminen ) -osiossa Trigger a webhook -toiminnon, 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:

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.