Slik utløser du webhooks i HubSpots kontaktbaserte 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 inkluderer:

• Publisere 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.

• 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-trafikk separat fra andre arbeidsflytprosesser. Dette gjøres for å strømlinjeforme arbeidsflyten og webhook-ytelsen. Når en webhook er treg eller går ut på tid, kan det ta lengre tid enn forventet å utføre arbeidsflytaksjonen.

Merk: HubSpot vil prøve på nytt mislykkede webhooks i opptil tre dager, med start ett minutt etter feilen. Påfølgende feil vil bli forsøkt på nytt med økende intervaller, med maksimalt åtte timers mellomrom mellom forsøkene. Arbeidsflyter vil ikke prøve på nytt etter å ha mottatt 4XX-serien responsstatuskoder.
Ett unntak fra denne regelen er 429-feil på grunn av 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.

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

Konfigurer en POST-forespørsel

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. For å redigere en eksisterende arbeidsflyt, klikk på navnet på arbeidsflyten. Eller opprett en ny arbeidsflyt.
3. I arbeidsflyteditoren klikker du på +-ikonet for å legge til en handling.
4. I venstre panel, i delen Dataops, velger du Send en webhook.
    

5. Klikk på rullegardinmenyen Metode og velg POST.
6. Skriv inn webhook-URL-en.
   • Webhook-URL-adresser 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 til webhook-URL-en.
   • Hvis ingen spørringsparametere er lagt til, vil en generisk POST- eller GET-forespørsel bli sendt.
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 Autentiseringstype. Velg deretter Inkluder forespørselssignatur i overskrift.
     • 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 gjennom en utviklerkonto for autentisering:
     • Når du bruker en API-nøkkel for autentisering, avhenger API-nøkkelnavnet og API-nøkkelplasseringen 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 API-nøkkelnavnet.
       • Klikk på rullegardinmenyen API-nøkkelplassering. Velg deretter enten Spørringsparametere eller Forespørselsoverskrift. Lær mer om bruk av API-nøkler i HubSpot.
     • Hvis du sender en forespørsel til HubSpot API-er:
       • Klikk på rullegardinmenyen API-nøkkel og velg en hemmelig nøkkel. Den hemmelige verdien må ha formatet Bearer [YOUR_TOKEN].
       • Angi verdien for API-nøkkelnavn til Authorization.
       • Angi 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ørselstekst.
   • 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, skriv inn nøkkelen og verdien. For å legge til en annen egenskap, klikk på Legg til statisk verdi.
   • For å fjerne en egenskap eller statisk verdi, klikk på sletteikonet.
10. Klikk på Lagre.

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

Konfigurer en GET-forespørsel

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. For å redigere en eksisterende arbeidsflyt, klikk på navnet på arbeidsflyten. Eller opprett en ny arbeidsflyt.
3. I arbeidsflyteditoren 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-adresser 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 til webhook-URL-en.
   • Hvis ingen spørringsparametere er lagt til, vil en generisk POST- eller GET-forespørsel bli sendt.
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 Autentiseringstype. Velg deretter Inkluder forespørselssignatur i overskrift.
     • 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 gjennom en utviklerkonto for autentisering:
     • Når du bruker en API-nøkkel for autentisering, avhenger API-nøkkelnavnet og API-nøkkelplasseringen 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 API-nøkkelnavnet.
       • Klikk på rullegardinmenyen API-nøkkelplassering. Velg deretter enten Spørringsparametere eller Forespørselsoverskrift. Lær mer om bruk av API-nøkler i HubSpot.
     • Hvis du sender en forespørsel til HubSpot API-er:
       • Klikk på rullegardinmenyen API-nøkkel og velg en hemmelig nøkkel. Den hemmelige verdien må ha formatet Bearer [YOUR_TOKEN].
       • Angi verdien for API-nøkkelnavn til Authorization.
       • Angi verdien for API-nøkkelplassering til Forespørselsoverskrift.
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 Spørringsparametere skriver du inn nøkkelen og velger deretter en egenskap.
   • For å legge til en annen egenskap, klikker du på Legg til egenskap.
   • For å fjerne en egenskap, klikker du på sletteikonet.
10. Slik bruker du en statisk verdi som spørringsparameter:
    • Under delen Spørringsparametere skriver du inn nøkkelen og deretter en verdi.
    • For å legge til en annen egenskap, klikk på Legg til statisk verdi.
    • For å fjerne en egenskap, klikk på sletteikonet.
11. Klikk på Lagre.

Angi en hastighetsbegrensning for webhooken din

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. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet på arbeidsflyten.
3. I arbeidsflyteditoren klikker du på Send en webhook-handling.
4. Klikk på Konfigurer hastighetsbegrensningi venstre panel 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. 

Test webhooken din i HubSpot

Når du konfigurerer POST- eller GET-webhooken, kan du utføre en test for å se webhook-responsen. 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 API-nøkkelen ikke vises i noen testforespørsler.

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

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet på arbeidsflyten.
3. I arbeidsflyteditoren klikker du på Handlingen Send en webhook.
4. I venstre panel 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ørselstekst, angir du egenskapstestverdiene for 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 alle for å utvide alle seksjoner, eller Skjul alle for å skjule alle seksjoner.
   • I fanen Svar klikker du på overskrifter: eller brødtekst: for å utvide hver seksjon.
   • I fanen Forespørsel klikker du på httpHeaders: for å utvide seksjonen.
     
     

Test webhooken eksternt

Når du har opprettet arbeidsflyten 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 er aktivert, kan du manuelt registrere en testkontakt.
   
   

4. Når du tester webhook eksternt:
   • Hvis en webhook-handling med en POST-forespørsel utløses, sendes en JSON-respons til webhooken som inneholder all informasjon om kontakten, inkludert skjemainnsendelser, listemedlemskap og alle kontaktverdier. Mottakersystemet kan deretter analysere JSON-dataene og bruke dem til sin egen applikasjon.
   • Hvis en webhook-handling med en GET-forespørsel utløses, vil en generisk GET-forespørsel sendes, med mindre det er brukt tilleggsparametere.

Merk: historiske egenskapsverdier vil bare returneres i kontaktbaserte arbeidsflyter. Webhooks som brukes i alle andre typer arbeidsflyter, vil bare returnere den nyeste verdien.

Bekreft forespørselssignaturer i arbeidsflyt-webhooks

Der du har valgt Forespørselssignatur i delen Autentisering for Trigger en webhook-handling, 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 ikke-parsede kroppen. Les mer om dette i utviklerdokumentasjonen.

For å verifisere 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.

Utløs arbeidsflyter fra webhooks

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.

Bruk webhook-data i datapanelet

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. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet på arbeidsflyten din.
3. Klikk på + pluss-ikonet for å legge til en handling.
4. I venstre panel velger du en handling som bruker datapanelet.
5. I datapanelet klikker du på Vis egenskaper eller handlingsutdata fra rullegardinmenyen og velger Webhook-utløser. Du kan deretter bruke egenskaper fra den tilkoblede webhooken.