Bruk webhooks med HubSpot-arbeidsflyter

Bruk webhooks i arbeidsflyter for å sende eller hente informasjon mellom HubSpot og andre eksterne verktøy. Det finnes en rekke bruksområder for webhooks. Eksempler på populære bruksområder for webhooks er blant annet:

• Publisering av HubSpot-kontaktdata til et annet system, for eksempel et CRM-system, når kontakten fyller ut et bestemt skjema på nettstedet ditt.

• Sende avtaledata til et eksternt forsendelseshåndteringssystem for å opprette en innkjøpsordre.

• Sende chat-varsler fra det eksterne systemet til bedriftens chat-strøm for å varsle de ansatte om at noe viktig har skjedd.

• Hente data fra et annet system for å oppdatere HubSpot-postene dine.

Du kan sende både POST- og GET-forespørsler ved hjelp av arbeidsflyter. HubSpot regulerer webhook-trafikken separat fra andre arbeidsflytprosesser. Dette gjøres for å effektivisere arbeidsflyten og ytelsen til webhooks. Når en webhook er treg eller får timeout, kan det ta lengre tid enn forventet å utføre arbeidsflyten.

Merk: HubSpot gjør nye forsøk på mislykkede webhooks i opptil tre dager, med start ett minutt etter feilen. Etterfølgende feil vil bli forsøkt på nytt med økende intervaller, med maksimalt åtte timer mellom forsøkene. Arbeidsflyter vil ikke bli forsøkt på nytt etter å ha mottatt svarstatuskoder i 4XX-serien.
Et unntak fra denne regelen er feil med 429-hastighetsgrense; arbeidsflyter vil automatisk prøve på nytt etter å ha mottatt et 429-svar, og vil respektere Retry-After-headeren hvis den finnes. Retry-After registreres i milisekunder. Du finner mer informasjon om spesifikke feilkodeunntak i HubSpots utviklerdokumentasjon.

Les mer om webhooks i dokumentasjonen for webhooks for utviklere. Hvis du har spørsmål om din spesifikke implementering av webhooks med HubSpot, kan du ta kontakt med HubSpot Developers Forums.

Konfigurer en webhook i arbeidsflyten din

• Gå til Automatiseringer > Arbeidsflyter i HubSpot-kontoen din.
• Klikk på navnet på arbeidsflyten.
• Klikk på +-ikonet for å legge til en handling.
• Velg Send en webhook i panelet til venstre.
• Klikk på rullegardinmenyen Metode, og velg deretter POST eller GET.
• Skriv inn URL-adressen til webhooken. Webhook-URL-er er begrenset til en sikker protokoll og må begynne med HTTPS. Hvis du vil be om spesifikk informasjon, kan du legge til spørringsparametere som ?queryparameter=abc i webhook-URL-adressen. Hvis ingen spørringsparametere er lagt til, sendes en generisk POST- eller GET-forespørsel.
• Konfigurer autentiseringstypen for å autentisere forespørsler til webhooken:
  • Slik bruker du en forespørselssignatur i webhook-headeren:
    • Klikk på rullegardinmenyen Autentiseringstype. Velg deretter Include request signature in header.
    • Skriv deretter inn HubSpot-app-ID-en din. Finn ut hvordan du verifiserer forespørselssignaturer.

• • Du kan også bruke en API-nøkkel eller en offentlig app som er opprettet via en utviklerkonto for autentisering.

Merk: Fra og med 30. november 2022 er HubSpot API-nøkler utdatert og støttes ikke lenger. Du kan fortsatt bruke eksterne API-nøkler for autentisering i HubSpot-arbeidsflyter.

• • • Når du bruker en API-nøkkel for autentisering, avhenger API-nøkkelens navn og plassering av hvordan webhooken er konfigurert. Av sikkerhetsgrunner vises ikke API-nøkkelen i noen testforespørsler. Slik bruker du en API-nøkkel:
      • Klikk på rullegardinmenyen Autentiseringstype. Velg deretter API-nøkkel.

• • • • Skriv inn navnet på API-nøkkelen.
      • Klikk på rullegardinmenyen API-nøkkelplassering. Velg deretter enten Forespørselsparametere eller Forespørselsoverskrift. Finn ut mer om hvordan du bruker API-nøkler i HubSpot.
    • Hvis du sender en forespørsel til et av HubSpot API-ene våre:
      • Klikk på rullegardinmenyen API-nøkkel og velg en hemmelighet. Den hemmelige verdien må være i formatet Bearer [YOUR_TOKEN].
      • Angi verdien for API-nøkkelens navn til Authorization.
      • Angi verdien for API-nøkkelens plassering til Request Header.
• Hvis du konfigurerer en POST-forespørsel, kan du velge å inkludere alle egenskaper fra CRM-oppføringen eller bare sende bestemte egenskaper:
  • Hvis du vil inkludere alle egenskaper, velger du Inkluder alle egenskaper under Tilpass forespørselens brødtekst.
  • Hvis du bare vil inkludere bestemte egenskaper:
    
    • Velg Velg spesifikke egenskaper under delen Tilpass forespørselens brødtekst.
    • Klikk på rullegardinmenyen Velg egenskap. Klikk deretter på [objekt] i denne arbeidsflyten og velg en egenskap.
    • Hvis du vil endre navnet på en egenskap i webhooken, redigerer du tekstfeltet Egenskapsnavn . Dette vil bare oppdatere egenskapsnavnet i POST-forespørselen, ikke egenskapsnavnet eller det interne navnet i HubSpot.
    • Hvis du vil legge til en ny egenskap, klikker du på Legg til egenskap.
    • Hvis du vil fjerne en egenskap, klikker du på søppelbøtteikonet delete.
      

• Hvis du konfigurerer en GET-forespørsel, kan du bruke egenskaper som spørringsparametere:
  
  • Klikk på rullegardinmenyen Velg egenskap under delen Spørringsparametere . Klikk deretter på [objekt] i denne arbeidsflyten og velg en egenskap.
  • Hvis du vil endre navnet på en egenskap i spørringsparameteren, redigerer du tekstfeltet Egenskapsnavn . Dette vil bare oppdatere egenskapsnavnet i GET-forespørselen, ikke egenskapsnavnet eller det interne navnet i HubSpot.
  • Hvis du vil legge til en ny egenskap, klikker du på Legg til spørringsparameter.
  • Hvis du vil fjerne en egenskap, klikker du på søppelbøtteikonet delete.
• Klikk på Lagre.
  
  

Merk: Hvis du vil velge flere utganger, må svaret være strukturert som et JSON-objekt.

Tilpass POST-forespørselen din

Hvis du konfigurerer en POST-forespørsel, kan du velge å inkludere alle egenskaper fra CRM-oppføringen eller bare sende bestemte egenskaper:

• Hvis du vil inkludere alle egenskaper, velger du Inkluder alle egenskaper under Tilpass forespørselens brødtekst.
• For å inkludere bare bestemte egenskaper:
  
  • Under delen Forespørselstekst velger du Tilpass forespørselstekst.
  • Skriv inn Nøkkel og Verdi.
  • Hvis du vil endre navnet på en egenskap i webhooken, redigerer du tekstfeltet Nøkkel . Dette vil bare oppdatere egenskapsnavnet i POST-forespørselen, ikke egenskapsnavnet eller det interne navnet i HubSpot.
  • Hvis du vil legge til en ny egenskap, klikker du på Legg til egenskap.
  • Hvis du vil fjerne en egenskap, klikker du på søppelikonet delete.
    
    

Tilpass GET-forespørslene dine

Hvis du konfigurerer en GET-forespørsel, kan du bruke egenskaper som spørringsparametere for å hente spesifikke data:

• Under delen Spørreparametere skriver du inn nøkkelen og velger deretter en egenskap.
• Hvis du vil endre navnet på en egenskap i spørringsparameteren, redigerer du tekstfeltet Egenskapens navn. Dette vil bare oppdatere egenskapsnavnet i GET-forespørselen, ikke egenskapsnavnet eller det interne navnet i HubSpot.
• Klikk på Legg til egenskap for å legge til en annen egenskap.
• Hvis du vil fjerne en egenskap, klikker du på søppelbøtteikonet delete.
• Velg en godkjenningstype fra rullegardinmenyen.
• Klikk på Lagre.
  
  

Test webhooken i HubSpot

Når du konfigurerer en POST- eller GET-webhook, kan du kjøre en test for å se webhook-svaret. Når data sendes til og hentes fra en tredjepart under testen, påvirkes ikke eksisterende oppføringer i HubSpot. Hvis du bruker en API-nøkkel for autentisering, vises ikke API-nøkkelen i noen testforespørsler.

Når du har testet webhooken, kan du velge hvilke felter som skal sendes ut og brukes som input senere i arbeidsflyten. Velg bare utdata som er tilgjengelige i alle svar. Hvis utdataene brukes i en senere handling, men ikke er tilgjengelige i svaret, vil handlingen mislykkes.

• Klikk på Testhandling i sidepanelet for å utvide delen.
• Klikk på rullegardinmenyen Objekt, og velg deretter en post å teste med.
• Klikk på Test.
• Hvis du vil sjekke webhook-detaljene, velger du kategorien Svar eller Forespørsel. I hver fane kan du klikke på Åpne alle for å utvide alle seksjoner eller Skjul alle for å skjule alle seksjoner.
  
  • I Svar-fanen klikker du på Headers: eller Body: for å utvide hver seksjon.
  • I kategorien Forespørsel klikker du på httpHeaders: for å utvide delen.
    
    

Test webhooken eksternt

Etter at du har opprettet arbeidsflyten med en webhook-handling, kan du kjøre en rask test med en dummy-webhook-URL:

• Gå til https://webhook.site i nettleseren, og kopier den unike URL-adressen.
• Lim inn URL-adressen i feltet Webhook URL i webhook-handlingen.

• Når arbeidsflyten er slått på, kan du registrere en testkontakt manuelt.

Hvis en webhook-handling med en POST-forespørsel utløses, sendes en JSON-svardel til webhooken som inneholder all informasjon om kontakten, inkludert skjemainnleveringer, listemedlemskap og alle kontaktens egenskapsverdier. Mottakersystemet kan deretter analysere JSON-dataene og bruke dem i sin egen applikasjon.

Hvis en webhook-handling med en GET-forespørsel utløses, sendes en generisk GET-forespørsel, med mindre det er lagt til flere spørringsparametere.

Merk: Historiske egenskapsverdier returneres kun i kontaktbaserte arbeidsflyter. Webhooks som brukes i alle andre typer arbeidsflyter, returnerer bare den nyeste verdien.

Bekreft forespørselssignaturer i webhooks for arbeidsflyter

Hvis du har valgt Forespørselssignatur i autentiseringsdelen for handlingen Utløs en webhook, vil HubSpot fylle ut webhooken med en X-HubSpot-Signature-header med en SHA-256-hash av sammenkoblingen av app-secret for applikasjonen din, HTTP-metoden, URI-en og den uparserte brødteksten. Les mer om dette i dokumentasjonen for utviklere.

For å verifisere at forespørslene som mottas på URL-adressen din, kommer fra HubSpot:

• Ha en utviklerkonto. Hvis du ikke har en, kan du registrere deg for en utviklerkonto.
• Skaff deg en app. Hvis du ikke har en app, bør du lære deg å lage en.
• Kontroller hash-verdien til signaturen.

Utløse arbeidsflyter fra webhooks

Webhooks kan brukes til å utløse arbeidsflyter. Når data endres i en tredjepartsapp, kan dette utløse en arbeidsflyt. Finn ut mer om hvordan du utløser arbeidsflyter fra webhooks.

Bruk webhook-data i datapanelet

Data fra webhooken som er koblet til kontoen din, kan brukes til visse handlinger i datapanelet.

For å bruke data fra den tilkoblede webhooken:

• Gå til Automatiseringer > Arbeidsflyter i HubSpot-kontoen din.
• Klikk på navnet på arbeidsflyten.
• Klikk på + plussikonet for å legge til en handling.
• I venstre panel velger du en handling som bruker datapanelet.
• I datapanelet under Egenskaper for påmelding kan du velge en av egenskapene fra den tilkoblede webhooken.