Mukauta verkkokoukkujasi (BETA)

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 Automaatiot > 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 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

• 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

• Jos haluat lisätä toisen ominaisuuden, valitse Lisää kyselyparametri
.
• Jos haluat poistaa ominaisuuden, napsauta poista roskakori-kuvaketta
.
• Napsauta Tallenna