Sådan udløser du webhooks i HubSpots kontaktbaserede arbejdsgange

Brug webhooks i kontaktbaserede arbejdsgange til at sende eller hente data mellem HubSpot og dine eksterne værktøjer. På den måde kan du automatisere processer på tværs af forskellige platforme. Du kan bruge en POST-webhook til at sende data fra HubSpot og en GET-webhook til at hente data fra eksterne værktøjer.

Når du konfigurerer dine POST- eller GET-webhooks, kan du styre webhookens udførelseshastighed med hastighedsbegrænsninger og manuelt teste din webhook-konfiguration i HubSpot eller ved hjælp af eksterne værktøjer. 
Du kan også lære, hvordan du verificerer anmodninger fra HubSpot, hvordan du bruger webhooks til automatisk at starte arbejdsgange, og hvordan du bruger webhook-responsdata i andre handlinger i arbejdsgangen.

Læs mere om webhooks i dokumentationen om webhooks for udviklere. Hvis du har spørgsmål om din specifikke implementering af webhooks med HubSpot, kan du henvende dig på HubSpot Developers Forums.

Hvad er nogle eksempler på anvendelsesscenarier for webhooks?

Eksempler på populære anvendelsesscenarier for webhooks omfatter:

• Overførsel af HubSpot-kontaktdata til et andet system, f.eks. et CRM-system, når den pågældende kontakt udfylder en bestemt formular på din hjemmeside.

• At sende aftaledata til et eksternt forsendelseshåndteringssystem for at oprette en indkøbsordre.

• Hentning af data fra et andet system for at opdatere dine HubSpot-poster.

Du kan sende både POST- og GET-anmodninger ved hjælp af workflows. HubSpot regulerer webhook-trafikken separat fra andre workflow-processer. Dette gøres for at optimere ydeevnen for både workflows og webhooks. Når en webhook er langsom eller går i timeout, kan det tage længere tid end forventet at udføre workflow-handlingen.

Hvordan sender jeg data fra HubSpot ved hjælp af en POST-webhook?

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. For at redigere en eksisterende workflow skal du klikke på navnet på workflown. Du kan også oprette en ny workflow.
3. I workflow-editoren skal du klikke på +-ikonet for at tilføje en handling.
4. I venstre panel, under afsnittet Data ops, skal du vælge Send en webhook.
    

5. Klik på rullemenuen "Metode ", og vælg " POST".
6. Indtast webhook-URL'en.
   • Webhook-URL'er er begrænset til en sikker protokol og skal begynde med HTTPS.
   • For at anmode om specifikke oplysninger kan du tilføje forespørgselsparametre, f.eks. ?queryparameter=abc, til webhook-URL'en.
   • Hvis der ikke er tilføjet nogen forespørgselsparametre, sendes en generisk POST- eller GET-anmodning.
7. Konfigurer din godkendelsestype for at godkende anmodninger til din webhook. Du kan enten bruge en anmodningssignatur i din webhook-header eller bruge en API-nøgle:
   • Sådan bruger du en anmodningssignatur i din webhook-header:
     • Klik på rullemenuen Autentificeringstype. Vælg derefter Inkluder anmodningssignatur i header.
     • Indtast derefter dit HubSpot-app-ID. Lær, hvordan du verificerer anmodningssignaturer.
   • Sådan bruger du en API-nøgle eller en offentlig app oprettet via en udviklerkonto til godkendelse:
     • Når du bruger en API-nøgle til godkendelse, afhænger navnet på API-nøglen og placeringen af API-nøglen af, hvordan webhooken er konfigureret. Af sikkerhedsmæssige årsager vises API-nøglen ikke i testanmodninger. Sådan bruger du en API-nøgle:
       • Klik på rullemenuen Autentificeringstype. Vælg derefter API-nøgle.
       • Indtast navnet på din API-nøgle.
       • Klik på rullemenuen for API-nøgleplacering. Vælg derefter enten Forespørgselsparametre eller Anmodningshoved. Få mere at vide om brug af API-nøgler i HubSpot.
     • Hvis du sender en anmodning til HubSpot-API'er:
       • Klik på rullemenuen API-nøgle, og vælg en hemmelighed. Værdien for hemmeligheden skal have formatet Bearer [YOUR_TOKEN].
       • Indstil værdien for API-nøglenavn til Authorization.
       • Indstil værdien for API-nøgleplacering til Request Header.
8. For at medtage alle egenskaber skal du vælge " Inkluder alle [objekt]-egenskaber".
9. For kun at medtage bestemte egenskaber:
   • Vælg Tilpas anmodningstekst.
   • For at tilpasse anmodningsteksten ved hjælp af en HubSpot-egenskab skal du indtaste nøglen og vælge en egenskab. For at tilføje en anden egenskab skal du klikke på Tilføj egenskab.
   • For at tilpasse anmodningsteksten ved hjælp af et statisk felt skal du indtaste nøglen og værdien. For at tilføje en anden egenskab skal du klikke på Tilføj statisk værdi.
   • For at fjerne en egenskab eller en statisk værdi skal du klikke på papirkurv-ikonet.
10. Klik på " Gem" øverst.

Bemærk: For at vælge flere output skal svaret være struktureret som et JSON-objekt.

Hvordan henter jeg data ind i HubSpot ved hjælp af en GET-webhook?

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. For at redigere en eksisterende workflow skal du klikke på navnet på workflown. Du kan også oprette en ny workflow.
3. I workflow-editoren skal du klikke på +-ikonet for at tilføje en handling.
4. I venstre panel, under afsnittet Data ops, skal du vælge Send en webhook.
    

5. Klik på rullemenuen "Metode ", og vælg " GET".
6. Indtast webhook-URL'en.
   • Webhook-URL'er er begrænset til en sikker protokol og skal begynde med HTTPS.
   • For at anmode om specifikke oplysninger kan du tilføje forespørgselsparametre, f.eks. ?queryparameter=abc, til webhook-URL'en.
   • Hvis der ikke er tilføjet nogen forespørgselsparametre, sendes en generisk POST- eller GET-anmodning.
7. Konfigurer din godkendelsestype for at godkende anmodninger til din webhook. Du kan enten bruge en anmodningssignatur i din webhook-header eller bruge en API-nøgle:
   • Sådan bruger du en anmodningssignatur i din webhook-header:
     • Klik på rullemenuen Autentificeringstype. Vælg derefter Inkluder anmodningssignatur i header.
     • Indtast derefter dit HubSpot-app-ID. Lær, hvordan du verificerer anmodningssignaturer.
   • Sådan bruger du en API-nøgle eller en offentlig app oprettet via en udviklerkonto til godkendelse:
     • Når du bruger en API-nøgle til godkendelse, afhænger navnet på API-nøglen og placeringen af API-nøglen af, hvordan webhooken er konfigureret. Af sikkerhedsmæssige årsager vises API-nøglen ikke i testanmodninger. Sådan bruger du en API-nøgle:
       • Klik på rullemenuen Autentificeringstype. Vælg derefter API-nøgle.
       • Indtast navnet på din API-nøgle.
       • Klik på rullemenuen for API-nøgleplacering. Vælg derefter enten Forespørgselsparametre eller Anmodningshoved. Få mere at vide om brug af API-nøgler i HubSpot.
     • Hvis du sender en anmodning til HubSpot-API'er:
       • Klik på rullemenuen API-nøgle, og vælg en hemmelighed. Værdien for hemmeligheden skal have formatet Bearer [YOUR_TOKEN].
       • Indstil værdien for API-nøglenavn til Authorization.
       • Indstil værdien for API-nøgleplacering til Request Header.
8. Hvis du konfigurerer en GET-anmodning, kan du enten bruge HubSpot-egenskaber eller tilføje statiske værdier som forespørgselsparametre: 

9. Sådan bruger du en HubSpot-egenskab som forespørgselsparameter:
   • Indtast nøglen under afsnittet Forespørgselsparametre , og vælg derefter en egenskab.
   • Klik på Tilføj egenskab for at tilføje en anden egenskab.
   • Klik på sletteikonet for at fjerne en egenskab.
10. Sådan bruger du en statisk værdi som en forespørgselsparameter:
    • Indtast nøglen under afsnittet "Forespørgselsparametre ", og indtast derefter en værdi.
    • Klik på Tilføj statisk værdi for at tilføje en ny egenskab.
    • For at fjerne en egenskab skal du klikke på sletteikonet.
11. Klik på " Gem".

Hvordan styrer jeg webhookens udførelseshastighed med

hastighedsbegrænsninger

?

Indstil en hastighedsbegrænsning for at bestemme, hvor hurtigt webhook-handlingen skal udføres. Hastighedsbegrænsningen vil også påvirke alle efterfølgende handlinger i arbejdsgangen.

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. Klik på navnet på arbejdsgangen.
3. I workflow-editoren skal du klikke på handlingen Send en webhook.
4. Klik på " Konfigurer hastighedsbegrænsning" i venstre panel for at udvide afsnittet.
5. Klik for at aktivere kontakten "Aktivér hastighedsbegrænsning". Som standard er denne indstilling deaktiveret. 
6. Konfigurer din hastighedsbegrænsning: 
   • Handlingsudførelser: Indstil det maksimale antal udførelser pr. tidsperiode. 
   • Tidsramme: Indstil tidsrammen for din hastighedsbegrænsning. Du kan indstille denne tidsramme i sekunder, minutter eller timer. 

Hvordan tester jeg min webhook-konfiguration i HubSpot?

Når du konfigurerer din POST- eller GET-webhook, kan du udføre en test for at se webhook-svaret. Under testen, mens data sendes til og hentes fra en tredjepart, vil eksisterende poster i HubSpot ikke blive påvirket. Hvis du bruger en API-nøgle til autentificering, vil API-nøglen ikke blive vist i nogen testanmodninger.

Når du har testet din webhook, kan du vælge, hvilke felter der skal udlæses til brug som input senere i din workflow. Vælg kun udlæsninger, der er tilgængelige i hvert svar. Hvis udlæsningen bruges i en senere handling, men ikke er tilgængelig i svaret, vil handlingen mislykkes.

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. Klik på navnet på arbejdsgangen.
3. I workflow-editoren skal du klikke på handlingen Send en webhook.
4. Klik på " Test handling " i venstre panel for at udvide afsnittet.
5. Hvis du tester en POST-anmodning, vil opsætningen af webhook-testen variere afhængigt af, om du har valgt at Tilpasse anmodningsteksten eller at Medtage alle [objekt]-egenskaber i webhook-handlingen.
   • Hvis du har valgt " Tilpas anmodningstekst", skal du indtaste testværdierne for egenskaberne til din test.
   • Hvis du har valgt "Inkluder alle [objekt]-egenskaber", skal du klikke på rullemenuen [objekt] og derefter vælge en post, der skal testes med.
6. Klik på Test.
7. For at kontrollere webhook-oplysningerne skal du vælge fanen "Response" eller "Request". På hver fane kan du klikke på "Open all " for at udvide alle sektioner eller på "Collapse all " for at skjule alle sektioner.
   • På fanen " Response " skal du klikke på "headers:" eller " body:" for at udvide de enkelte sektioner.
   • På fanen " Request " skal du klikke på " httpHeaders:" for at udvide sektionen.
     
     

Hvordan tester jeg webhooks ved hjælp af eksterne værktøjer?

Når du har oprettet din arbejdsgang med en webhook-handling, kan du køre en hurtig test med en dummy-webhook-URL:

1. Gå til https://webhook.site i din browser, og kopier den unikke URL.
2. Indsæt URL'en i feltet Webhook-URL i din webhook-handling.
3. Når din arbejdsgang er aktiveret, kan du manuelt tilmelde en testkontakt.
4. Når du tester din webhook eksternt:
   • Hvis en webhook-handling med en POST-anmodning udløses, sendes en JSON-respons til webhooken, der indeholder alle oplysninger om kontakten, herunder formularindsendelser, listemedlemskaber og alle kontaktegenskabsværdier. Det modtagende system kan derefter analysere JSON-dataene og bruge dem til sin egen applikation.
   • Hvis en webhook-handling med en GET-anmodning udløses, sendes en generisk GET-anmodning, medmindre der er anvendt yderligere forespørgselsparametre.

Bemærk: Historiske egenskabsværdier returneres kun i kontaktbaserede arbejdsgange. Webhooks, der bruges i alle andre typer arbejdsgange, returnerer kun den seneste værdi.

Hvordan verificerer jeg, at webhook-anmodninger kommer fra HubSpot?

Hvis du har valgt Anmodningssignatur i afsnittet Godkendelse for din handling »Udløs en webhook«, vil HubSpot udfylde webhooken med en X-HubSpot-Signature-header med en SHA-256-hash af sammenkædningen af app-secret for din applikation, HTTP-metoden, URI'en og den ikke-parsede body. Læs mere om dette i udviklerdokumentationen.

Sådan kontrollerer du, at de anmodninger, der modtages på din URL, kommer fra HubSpot:

• Du skal have en udviklerkonto. Hvis du ikke har en, skal du oprette en udviklerkonto.
• Du skal have en app. Hvis du ikke har en app, kan du læse, hvordan du opretter en app.
• Kontroller signaturens hashværdi.

Hvordan bruger jeg webhooks til automatisk at starte arbejdsgange?

Webhooks kan bruges til at udløse arbejdsgange. Når data ændres i en tredjepartsapp, kan dette udløse en arbejdsgang. Læs mere om at udløse arbejdsgange fra webhooks.

Hvordan bruger jeg webhook-responsdata i andre workflow-handlinger?

Data fra den webhook, der er forbundet til din konto, kan bruges til bestemte handlinger i datapanelet.

Sådan bruger du data fra den forbundne webhook:

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. Klik på navnet på din arbejdsgang.
3. Klik på +-ikonet for at tilføje en handling.
4. I venstre panel skal du vælge en handling, der bruger datapanelet.
5. I datapanelet skal du under Handlingsdata vælge handlingen Send en webhook. Du kan derefter bruge egenskaber fra den tilknyttede webhook.
    

Hvad sker der, når en webhook mislykkes?

HubSpot vil forsøge igen med mislykkede webhooks i op til tre dage, startende ét minut efter fejlen. Efterfølgende fejl vil blive forsøgt igen med stigende intervaller, med et maksimalt interval på otte timer mellem forsøgene.

Workflows vil ikke forsøge igen efter modtagelse af responsstatuskoder i 4XX-serien. Undtaget herfra er 429-fejl vedrørende hastighedsbegrænsning; workflows vil automatisk forsøge igen efter modtagelse af en 429-respons og vil overholde "Retry-After"-headeren, hvis denne er til stede. "Retry-After" angives i millisekunder. Læs mere om specifikke undtagelser for fejlkoder i HubSpots udviklerdokumentation.