Slik utløser du webhooks i kontaktbaserte arbeidsflyter i HubSpot

Bruk webhooks i kontaktbaserte arbeidsflyter for å sende eller hente data mellom HubSpot og dine eksterne verktøy. Dette gjør det mulig å automatisere prosesser på tvers av ulike plattformer. Du kan bruke en POST-webhook til å sende data fra HubSpot, og en GET-webhook til å hente data fra eksterne verktøy.

Når du konfigurerer POST- eller GET-webhooks, kan du regulere utførelseshastigheten ved hjelp av hastighetsbegrensninger, og teste webhook-konfigurasjonen manuelt i HubSpot eller ved hjelp av eksterne verktøy. 
Du kan også lære hvordan du verifiserer forespørsler fra HubSpot, hvordan du bruker webhooks til å starte arbeidsflyter automatisk, og hvordan du bruker responsdata fra webhooks i andre arbeidsflythandlinger.

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

Hva er noen eksempler på bruksområder for webhooks?

Eksempler på vanlige bruksområder for webhooks inkluderer:

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

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

• 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 å optimalisere ytelsen til arbeidsflyter og webhooks. Når en webhook er treg eller går ut på tid, kan det ta lengre tid enn forventet å utføre arbeidsflythandlingen.

Hvordan sender jeg data fra HubSpot ved hjelp av en POST-webhook?

1. I HubSpot-kontoen din klikker du på Mer og navigerer deretter til Automatisering > Arbeidsflyter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Automatisering > Arbeidsflyter.
2. For å redigere en eksisterende arbeidsflyt klikker du på navnet på arbeidsflyten. Eller opprett en ny arbeidsflyt.
3. I arbeidsflytredigereren klikker du på +-ikonet for å legge til en handling.
4. I venstre panel, i delen Data ops, velger du Send en webhook.
    

5. Klikk på rullegardinmenyen «Metode » og velg «POST».
6. Skriv inn webhook-URL-en.
   • Webhook-URL-er er begrenset til en sikker protokoll og må begynne med HTTPS.
   • For å be om spesifikk informasjon kan du legge til spørringsparametere som ?queryparameter=abc i webhook-URL-en.
   • Hvis det ikke er lagt til noen søkeparametere, vil det bli sendt en generisk POST- eller GET-forespørsel.
7. Konfigurer autentiseringstypen for å autentisere forespørsler til webhooken din. Du kan enten bruke en forespørselssignatur i webhook-overskriften eller bruke en API-nøkkel:
   • Slik bruker du en forespørselssignatur i webhook-overskriften:
     • Klikk på rullegardinmenyen for autentiseringstype. Velg deretter «Inkluder forespørselssignatur i overskriften».
     • Skriv deretter inn HubSpot-app-ID-en din. Lær hvordan du verifiserer forespørselssignaturer.
   • Slik bruker du en API-nøkkel eller en offentlig app opprettet via en utviklerkonto for autentisering:
     • Når du bruker en API-nøkkel for autentisering, avhenger navnet på API-nøkkelen og plasseringen av API-nøkkelen av hvordan webhooken er konfigurert. Av sikkerhetsmessige årsaker vises ikke API-nøkkelen i noen testforespørsler. Slik bruker du en API-nøkkel:
       • Klikk på rullegardinmenyen for autentiseringstype. Velg deretter «API-nøkkel».
       • Skriv inn navnet på API-nøkkelen din.
       • Klikk på rullegardinmenyen for API-nøkkelplassering. Velg deretter enten «Spørringsparametere » eller «Forespørselshode». Les mer om bruk av API-nøkler i HubSpot.
     • Hvis du sender en forespørsel til HubSpot-API-er:
       • Klikk på rullegardinmenyen for API-nøkkel og velg en hemmelig nøkkel. Verdien for den hemmelige nøkkelen må ha formatet Bearer [YOUR_TOKEN].
       • Sett verdien for «API-nøkkelnavn» til «Authorization».
       • Sett verdien for «API-nøkkelplassering» til «Forespørselsoverskrift».
8. For å inkludere alle egenskaper, velg «Inkluder alle [objekt]-egenskaper».
9. For å inkludere bare bestemte egenskaper:
   • Velg «Tilpass forespørselsteksten».
   • For å tilpasse forespørselsteksten ved hjelp av en HubSpot-egenskap, skriv inn nøkkelen og velg en egenskap. For å legge til en annen egenskap, klikk på «Legg til egenskap».
   • For å tilpasse forespørselsteksten ved hjelp av et statisk felt, skriver du inn nøkkelen og verdien. For å legge til en ny egenskap, klikker du på «Legg til statisk verdi».
   • For å fjerne en egenskap eller en statisk verdi, klikk på papirkurvikonet.
10. Klikk på «Lagre» øverst.

Merk: For å velge flere utdata må svaret være strukturert som et JSON-objekt.

Hvordan henter jeg inn data til HubSpot ved hjelp av en GET-webhook?

1. I HubSpot-kontoen din klikker du på Mer og navigerer deretter til Automatisering > Arbeidsflyter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Automatisering > Arbeidsflyter.
2. For å redigere en eksisterende arbeidsflyt, klikk på navnet på arbeidsflyten. Eller opprett en ny arbeidsflyt.
3. I arbeidsflytredigereren klikker du på +-ikonet for å legge til en handling.
4. I venstre panel, i delen Data ops, velger du Send en webhook.
    

5. Klikk på rullegardinmenyen «Metode » og velg «GET».
6. Skriv inn webhook-URL-en.
   • Webhook-URL-er er begrenset til en sikker protokoll og må begynne med HTTPS.
   • For å be om spesifikk informasjon kan du legge til spørringsparametere som ?queryparameter=abc i webhook-URL-en.
   • Hvis det ikke er lagt til noen søkeparametere, vil det bli sendt en generisk POST- eller GET-forespørsel.
7. Konfigurer autentiseringstypen for å autentisere forespørsler til webhooken din. Du kan enten bruke en forespørselssignatur i webhook-overskriften eller bruke en API-nøkkel:
   • Slik bruker du en forespørselssignatur i webhook-overskriften:
     • Klikk på rullegardinmenyen for autentiseringstype. Velg deretter «Inkluder forespørselssignatur i overskriften».
     • Skriv deretter inn HubSpot-app-ID-en din. Lær hvordan du verifiserer forespørselssignaturer.
   • Slik bruker du en API-nøkkel eller en offentlig app opprettet via en utviklerkonto for autentisering:
     • Når du bruker en API-nøkkel for autentisering, avhenger navnet på API-nøkkelen og plasseringen av API-nøkkelen av hvordan webhooken er konfigurert. Av sikkerhetsmessige årsaker vises ikke API-nøkkelen i testforespørsler. Slik bruker du en API-nøkkel:
       • Klikk på rullegardinmenyen for autentiseringstype. Velg deretter «API-nøkkel».
       • Skriv inn navnet på API-nøkkelen din.
       • Klikk på rullegardinmenyen for API-nøkkelplassering. Velg deretter enten «Spørringsparametere » eller «Forespørselshode». Les mer om bruk av API-nøkler i HubSpot.
     • Hvis du sender en forespørsel til HubSpot-API-er:
       • Klikk på rullegardinmenyen for API-nøkkel og velg en hemmelig nøkkel. Verdien for den hemmelige nøkkelen må ha formatet Bearer [YOUR_TOKEN].
       • Sett verdien for «API-nøkkelnavn» til «Authorization».
       • Sett verdien for «API-nøkkelplassering» til «Forespørselshode».
8. Hvis du konfigurerer en GET-forespørsel, kan du enten bruke HubSpot-egenskaper eller legge til statiske verdier som spørringsparametere: 

9. Slik bruker du en HubSpot-egenskap som spørringsparameter:
   • Under delen «Søkeparametere» skriver du inn nøkkelen og velger deretter en egenskap.
   • For å legge til en ny egenskap, klikk på «Legg til egenskap».
   • For å fjerne en egenskap, klikk på sletteikonet.
10. Slik bruker du en statisk verdi som spørringsparameter:
    • I delen «Søkeparametere» skriver du inn nøkkelen og deretter en verdi.
    • For å legge til en ny egenskap, klikk på «Legg til statisk verdi».
    • For å fjerne en egenskap, klikk på sletteikonet.
11. Klikk på «Lagre».

Hvordan styrer jeg utførelseshastigheten for webhooks med

hastighetsbegrensninger

?

Angi en hastighetsbegrensning for å bestemme hvor raskt webhook-handlingen skal utføres. Hastighetsbegrensningen vil også påvirke alle påfølgende handlinger i arbeidsflyten.

1. I HubSpot-kontoen din klikker du på Mer og navigerer deretter til Automatisering > Arbeidsflyter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Automatisering > Arbeidsflyter.
2. Klikk på navnet på arbeidsflyten.
3. I arbeidsflytredigereren klikker du på handlingen Send en webhook.
4. I venstre panel klikker du på «Konfigurer hastighetsbegrensning» for å utvide seksjonen.
5. Klikk for å slå på bryteren «Slå på hastighetsbegrensning ». Som standard er denne innstillingen slått av. 
6. Konfigurer hastighetsbegrensningen: 
   • Handlingsutførelser: Angi maksimalt antall utførelser per tidsperiode. 
   • Tidsramme: Angi tidsrammen for hastighetsbegrensningen. Du kan angi denne tidsrammen i sekunder, minutter eller timer. 

Hvordan tester jeg webhook-konfigurasjonen min i HubSpot?

Når du konfigurerer POST- eller GET-webhooken din, kan du kjøre en test for å se webhook-svaret. Under testen, mens data sendes til og hentes fra en tredjepart, vil eksisterende poster i HubSpot ikke bli påvirket. Hvis du bruker en API-nøkkel for autentisering, vil ikke API-nøkkelen vises i noen testforespørsler.

Etter at du har testet webhooken, kan du velge hvilke felt som skal vises som utdata for senere bruk som inndata i arbeidsflyten din. Velg kun utdata som er tilgjengelige i alle svar. Hvis utdataene brukes i en senere handling, men ikke er tilgjengelige i svaret, vil handlingen mislykkes.

1. I HubSpot-kontoen din klikker du på Mer og navigerer deretter til Automatisering > Arbeidsflyter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Automatisering > Arbeidsflyter.
2. Klikk på navnet på arbeidsflyten.
3. I arbeidsflytredigereren klikker du på handlingen Send en webhook.
4. I panelet til venstre klikker du på «Test handling » for å utvide seksjonen.
5. Hvis du tester en POST-forespørsel, vil konfigurasjonen av webhook-testen variere avhengig av om du har valgt å «Tilpasse forespørselsteksten» eller «Inkludere alle [objekt]-egenskaper » i webhook-handlingen.
   • Hvis du har valgt «Tilpass forespørselsteksten», angir du testverdiene for egenskapene i testen.
   • Hvis du har valgt «Inkluder alle [objekt]-egenskaper», klikker du på rullegardinmenyen [objekt] og velger deretter en post å teste med.
6. Klikk på Test.
7. For å sjekke webhook-detaljene, velg fanen «Svar » eller «Forespørsel ». På hver fane kan du klikke på «Åpne alt » for å utvide alle seksjonene, eller «Skjul alt » for å skjule alle seksjonene.
   • I fanen «Respons» klikker du på «headers:» eller «body:» for å utvide hver seksjon.
   • I fanen «Request» klikker du på «httpHeaders:» for å utvide seksjonen.
     
     

Hvordan tester jeg webhooks ved hjelp av eksterne verktøy?

Når du har opprettet arbeidsflyten din med en webhook-handling, kan du kjøre en rask test med en dummy-webhook-URL:

1. Gå til https://webhook.site i nettleseren din, og kopier den unike URL-adressen.
2. Lim inn URL-en i feltet «Webhook-URL» i webhook-handlingen.
3. Når arbeidsflyten din er aktivert, kan du manuelt registrere en testkontakt.
4. Når du tester webhooken eksternt:
   • Hvis en webhook-handling med en POST-forespørsel utløses, vil en JSON-svartekst sendes til webhooken som inneholder all informasjon om kontakten, inkludert skjemainnsendinger, 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, vil en generisk GET-forespørsel bli sendt, med mindre det er angitt tilleggsparametere.

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

Hvordan bekrefter jeg at webhook-forespørsler kommer fra HubSpot?

Der du har valgt «Forespørselssignatur» i delen «Autentisering» for handlingselementet «Utløs en webhook», vil HubSpot fylle ut webhooken med en X-HubSpot-Signature-overskrift med en SHA-256-hash av sammenkoblingen av app-hemmeligheten for applikasjonen din, HTTP-metoden, URI-en og den uanalyserte brødteksten. Les mer om dette i utviklerdokumentasjonen.

For å bekrefte at forespørslene som mottas på URL-en din kommer fra HubSpot:

• Ha en utviklerkonto. Hvis du ikke har en, kan du registrere deg for en utviklerkonto.
• Ha en app. Hvis du ikke har en app, kan du lære hvordan du oppretter en app.
• Sjekk hashverdien til signaturen.

Hvordan bruker jeg webhooks til å starte arbeidsflyter automatisk?

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

Hvordan bruker jeg responsdata fra webhooks i andre arbeidsflyt-handlinger?

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

Slik bruker du data fra den tilkoblede webhooken:

1. I HubSpot-kontoen din klikker du på Mer og navigerer deretter til Automatisering > Arbeidsflyter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Automatisering > Arbeidsflyter.
2. Klikk på navnet på arbeidsflyten din.
3. Klikk på +-ikonet for å legge til en handling.
4. I panelet til venstre velger du en handling som bruker datapanelet.
5. I datapanelet, under Handlingsdata, velger du handlingen Send en webhook. Du kan deretter bruke egenskaper fra den tilkoblede webhooken.
    

Hva skjer når en webhook mislykkes?

HubSpot vil prøve på nytt med mislykkede webhooks i opptil tre dager, med start ett minutt etter feilen. Påfølgende feil vil bli prøvd på nytt med stadig lengre intervaller, med et maksimalt intervall på åtte timer mellom forsøkene.

Arbeidsflyter vil ikke prøve på nytt etter å ha mottatt responsstatuskoder i 4XX-serien. Unntatt for 429-feil knyttet til hastighetsbegrensning; arbeidsflyter vil automatisk prøve på nytt etter å ha mottatt en 429-respons, og vil respektere «Retry-After»-overskriften hvis den er til stede. «Retry-After» registreres i millisekunder. Les mer om spesifikke unntak for feilkoder i HubSpots utviklerdokumentasjon.