Käytä verkkokoukkuja HubSpot-työnkulkujen kanssa

Käytä webhookeja työnkuluissa POST- tai GET-pyyntöjen lähettämiseen työnkuluistasi. Webhookeille on monia käyttötarkoituksia, esimerkkejä suosituista webhookien käyttötapauksista ovat mm. seuraavat:

• HubSpot-yhteystietojen lähettäminen toiseen järjestelmään, kuten CRM-järjestelmään, kun 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.

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.

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önkulunnimeä.
• Lisää toiminto napsauttamalla+-kuvaketta.
• Valitse oikeassa paneelissaLä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ä. Jos haluat pyytää tiettyjä tietoja, lisää kyselyparametreja Webhook-URL-osoitteeseen. Jos kyselyparametreja ei ole lisätty, lähetetään yleinen POST- tai GET-pyyntö.
• Voit todentaa kaikki webhookiin tulevat pyynnöt:
  • Napsauta Authentication type (Todennustyyppi ) -pudotusvalikkoa ja valitse sitten Include request signature in header (Sisällytä pyynnön allekirjoitus otsikkoon).
  • Kirjoita HubSpot App ID. Lue, mitentarkistat pyyntöjen allekirjoitukset.
• Napsauta Tallenna.
  
  

Testaa webhookisi HubSpotissa

Kun olet määrittänyt POST- tai GET-verkkokoukun, voit suorittaa testin, jolla voit tarkastella verkkokoukun vastausta. Testin aikana, kun tietoja lähetetään ja haetaan kolmannelle osapuolelle, se ei vaikuta HubSpotissa oleviin tietueisiin.

Webhookin testaamisen jälkeen voitvalita, mitkä kentät tulostetaan käytettäväksi syötteinä myöhemmin työnkulussa. Valitse vain ulostulot, 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 napsauttamalla 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. Voit laajentaa kaikki osiot valitsemalla kussakin välilehdessä Avaa kaikki tai sulkea kaikki osiot 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.
  
  

• Kun työnkulku on otettu käyttöön, voit rekisteröidä testikontaktin manuaalisesti.

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 ) -osiossaTrigger 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:

• Omista kehittäjätili. Jos sinulla ei ole sellaista, rekisteröi kehittäjätili.
• Omistat sovelluksen. Jos sinulla ei ole sovellusta, opettele luomaan sovellus.
• Tarkista allekirjoituksen hash-arvo.