Sådan udløser du webhooks i HubSpot kontaktbaserede workflows

Brug webhooks i arbejdsgange til at sende eller hente oplysninger mellem HubSpot og andre eksterne værktøjer. Der er mange forskellige anvendelsesmuligheder for webhooks. Eksempler på populære anvendelsesmuligheder for webhooks omfatter:

• At sende 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 forsendelsessystem 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 arbejdsgange. HubSpot regulerer webhook-trafik separat fra andre arbejdsgangsprocesser. Dette gøres for at strømline arbejdsgangen og webhook-ydeevnen. Når en webhook er langsom eller går i timeout, kan det tage længere tid end forventet at udføre arbejdsgangsaktionen.

Bemærk: HubSpot vil forsøge at genopføre mislykkede webhooks i op til tre dage, startende et 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 at have modtaget 4XX-serien responsstatuskoder.
En undtagelse fra denne regel er 429-ratebegrænsningsfejl; workflows vil automatisk forsøge igen efter at have modtaget en 429-respons og vil respektere Retry-After-headeren, hvis den er til stede. Retry-After registreres i millisekunder. Læs mere om specifikke undtagelser for fejlkoder i HubSpots udviklerdokumentation.

Læs mere om webhooks i udviklerdokumentationen om webhooks. Hvis du har spørgsmål om din specifikke implementering af webhooks med HubSpot, kan du kontakte HubSpot Developers Forums.

Opsæt en POST-anmodning

1. På din HubSpot-konto skal du gå til Automatisering > Arbejdsgange.
2. For at redigere en eksisterende workflow skal du klikke på navnet på workflown. Eller opret en ny workflow.
3. I workflow-editoren skal du klikke på + plus-ikonet for at tilføje en handling.
4. I venstre panel, i afsnittet Dataops, 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 såsom ?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 Godkendelsestype. Vælg derefter Inkluder forespørgselssignatur 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 Godkendelsestype. Vælg derefter API-nøgle.
       • Indtast dit API-nøglenavn.
       • Klik på rullemenuen API-nøgleplacering. Vælg derefter enten Forespørgselsparametre eller Anmodningsoverskrift. 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. Den hemmelige værdi 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 inkludere alle egenskaber skal du vælge Inkluder alle [objekt]egenskaber.
9. For kun at medtage bestemte egenskaber:
   • Vælg Tilpas anmodningsbrødtekst.
   • For at tilpasse anmodningsbrødteksten 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 anmodningsbrødteksten 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 statisk værdi skal du klikke på ikonet for sletning.
10. Klik på Gem.

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

Opsæt en GET-anmodning

1. På din HubSpot-konto skal du gå til Automatisering > Arbejdsgange.
2. For at redigere en eksisterende arbejdsgang skal du klikke på navnet på arbejdsgangen. Eller opret en ny arbejdsgang.
3. I workflow-editoren skal du klikke på + plus-ikonet for at tilføje en handling.
4. I venstre panel, i afsnittet Dataops, 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 såsom ?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 Godkendelsestype. Vælg derefter Inkluder forespørgselssignatur 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 Godkendelsestype. Vælg derefter API-nøgle.
       • Indtast dit API-nøglenavn.
       • Klik på rullemenuen API-nøgleplacering. Vælg derefter enten Forespørgselsparametre eller Anmodningsoverskrift. 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. Den hemmelige værdi 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:
   • Under afsnittet Forespørgselsparametre skal du indtaste nøglen og derefter vælge en egenskab.
   • For at tilføje en anden egenskab skal du klikke på Tilføj egenskab.
   • For at fjerne en egenskab skal du klikke på ikonet Slet.
10. Sådan bruger du en statisk værdi som forespørgselsparameter:
    • Indtast nøglen i afsnittet Query parameters (Forespørgselsparametre), og indtast derefter en værdi.
    • For at tilføje en anden egenskab skal du klikke på Tilføj statisk værdi.
    • For at fjerne en egenskab skal du klikke på ikonet Slet.
11. Klik på Gem.

Indstil en hastighedsbegrænsning for din webhook

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. På din HubSpot-konto skal du gå til Automatisering > Arbejdsgange.
2. Klik på navnet på arbejdsgangen.
3. I workflow-editoren skal du klikke på Send en webhook-handling.
4. Klik på Konfigurer hastighedsbegrænsningi venstre panel for at udvide sektionen.
5. Klik for at aktivere kontakten Aktiver hastighedsbegrænsning. Denne indstilling er som standard 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. 

Test din webhook i HubSpot

Når du konfigurerer din POST- eller GET-webhook, kan du udføre en test for at se webhook-responsen. Under testen, mens data sendes til og hentes fra en tredjepart, påvirkes eksisterende poster i HubSpot ikke. Hvis du bruger en API-nøgle til autentificering, vises API-nøglen ikke 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 output, der er tilgængeligt i alle svar. Hvis outputtet bruges i en senere handling, men ikke er tilgængeligt i svaret, vil handlingen mislykkes.

1. På din HubSpot-konto skal du gå 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 sektionen.
5. Hvis du tester en POST-anmodning, vil opsætningen af webhook-testen variere afhængigt af, om du har valgt at Tilpasse anmodningsbrødteksten eller Inkludere alle [objekt]egenskaber i webhook-handlingen.
   • Hvis du har valgt Tilpas anmodningsbrødtekst, skal du indtaste egenskabstestværdierne for 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.
6. Klik på Test.
7. For at kontrollere webhook-detaljerne skal du vælge fanen Svar eller Anmodning. På hver fane kan du klikke på Åbn alle for at udvide alle sektioner eller Skjul alle for at skjule alle sektioner.
   • I fanen Svar skal du klikke på headers: eller body: for at udvide hvert afsnit.
   • Klik på httpHeaders: på fanen Request for at udvide sektionen.
     
     

Test din webhook eksternt

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 workflow er blevet 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 kontaktvæ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 workflows. Webhooks, der bruges i alle andre workflowtyper, returnerer kun den seneste værdi.

Bekræft anmodningssignaturer i workflow-webhooks

Hvis du har valgt Anmod om signatur i afsnittet Godkendelse for din Trigger en webhook-handling, udfylder HubSpot webhooken med en X-HubSpot-Signature-header med en SHA-256-hash af sammenkædningen af app-hemmeligheden for din applikation, HTTP-metoden, URI'en og den ikke-analyserede brødtekst. Få mere at vide om dette i udviklerdokumentationen.

Sådan verificerer 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 hashværdien af signaturen.

Udløs workflows fra webhooks

Webhooks kan bruges til at udløse workflows. Når data ændres i en tredjepartsapp, kan dette udløse en workflow. Få mere at vide om at udløse workflows fra webhooks.

Brug webhook-data i datapanelet

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. På din HubSpot-konto skal du gå til Automatisering > Arbejdsgange.
2. Klik på navnet på din workflow.
3. Klik på + plus-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 klikke på Vis egenskaber eller handlingsoutput fra rullemenuen og vælge Webhook-udløser. Du kan derefter bruge egenskaber fra den tilknyttede webhook.