Brug webhooks med HubSpot-workflows

Brug webhooks i workflows til at sende eller hente information mellem HubSpot og andre eksterne værktøjer. Der er mange anvendelsesmuligheder for webhooks, og eksempler på populære use cases for webhooks inkluderer:

• At sende HubSpot-kontaktdata til et andet system, f.eks. et CRM-system, når kontakten udfylder en bestemt formular på din hjemmeside.

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

• Send chatadvarsler fra dit eksterne system til din virksomheds chatstrøm for at underrette medarbejderne om, at der er sket noget vigtigt.

• 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-trafik separat fra andre workflow-processer. Dette gøres for at strømline workflow- og webhook-performance. Når et webhook er langsomt eller går i stå, kan det tage længere tid end forventet at udføre workflow-handlingen.

Bemærk venligst: HubSpot vil prøve mislykkede webhooks igen 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 blive forsøgt igen efter at have modtaget svarstatuskoder i 4XX-serien.
En undtagelse fra denne regel er 429 rate limit-fejl; workflows vil automatisk prøve igen efter at have modtaget et 429-svar og vil respektere Retry-After-headeren, hvis den er til stede. Retry-After registreres i milisekunder. Læs mere om specifikke fejlkodeundtagelser i HubSpots udviklerdokumentation.

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

Opsæt et webhook i dit workflow

• På din HubSpot-konto skal du navigere til Automatiseringer > Arbejdsgange.
• Klik på navnet på workflowet.
• Klik på +-ikonet for at tilføje en handling.
• Vælg Send et webhook i venstre panel.
• Klik på dropdown-menuen Metode, og vælg POST eller GET.
• 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 som f.eks. ?queryparameter=abc til webhook-URL'en. Hvis der ikke er tilføjet nogen forespørgselsparametre, sendes en generisk POST- eller GET-forespørgsel.
• Opsæt din autentificeringstype til at autentificere anmodninger til dit webhook:
  • Sådan bruger du en anmodningssignatur i din webhook-header:
    • Klik på rullemenuen Authentication type. Vælg derefter Include request signature in header.
    • Indtast derefter dit HubSpot App ID. Lær, hvordan du verificerer anmodningssignaturer.

• • Du kan også bruge en API-nøgle eller en offentlig app, der er oprettet via en udviklerkonto, til autentificering.

Bemærk: Fra den 30. november 2022 er HubSpot API Keys for ældet og understøttes ikke længere. Du kan stadig bruge eksterne API-nøgler til autentificering i HubSpot-workflows.

• • • Når du bruger en API-nøgle til godkendelse, afhænger API-nøglens navn og placering af, hvordan webhook'et er konfigureret. Af sikkerhedsmæssige årsager vil API-nøglen ikke blive vist i nogen 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å dropdown-menuen API-nøgleplacering. Vælg derefter enten Query parameters eller Request header. Læs mere om at bruge API-nøgler i HubSpot.
    • Hvis du laver en forespørgsel til en af vores HubSpot API'er:
      • Klik på rullemenuen API-nøgle, og vælg en hemmelighed. Den hemmelige værdi skal være i formatet Bearer [YOUR_TOKEN].
      • Indstil værdien af API-nøglens navn til Authorization.
      • Indstil værdien af API-nøglens placering til Request Header.
• Hvis du opretter en POST-anmodning, kan du vælge at inkludere alle egenskaber fra CRM-posten eller kun at sende specifikke egenskaber:
  • Hvis du vil inkludere alle egenskaber, skal du vælge Include all properties under Customize request body.
  • For kun at inkludere specifikke egenskaber:
    
    • Vælg Vælg specifikke egenskaber under afsnittet Tilpas anmodningens brødtekst.
    • Klik på rullemenuen Vælg egen skab. Klik derefter på [objekt] i dette workflow, og vælg en egenskab.
    • Hvis du vil ændre en egenskabs navn i webhook'en, skal du redigere tekstfeltet Egenskabsnavn . Dette vil kun opdatere egenskabsnavnet i POST-anmodningen, det vil ikke opdatere egenskabsnavnet eller det interne navn i HubSpot.
    • Klik på Tilføj egenskab for at tilføje en anden egenskab.
    • Hvis du vil fjerne en egenskab, skal du klikke på delete skraldespandsikonet.
      

• Hvis du opretter en GET-forespørgsel, kan du bruge egenskaber som forespørgselsparametre:
  
  • Klik på dropdown-menuen Vælg egen skab under afsnittet Forespørgselsparametre . Klik derefter på [objekt] i dette workflow, og vælg en egenskab.
  • Hvis du vil ændre en egenskabs navn i forespørgselsparameteren, skal du redigere tekstfeltet Egenskabsnavn . Dette vil kun opdatere egenskabsnavnet i GET-anmodningen, det vil ikke opdatere egenskabsnavnet eller det interne navn i HubSpot.
  • Klik på Add query parameter for at tilføje en anden egenskab.
  • Hvis du vil fjerne en egenskab, skal du klikke på delete skraldespandsikonet.
• Klik på Gem.
  
  

Bemærk: Hvis du vil vælge flere udgange, skal svaret struktureres som et JSON-objekt.

Tilpas din POST-anmodning

Hvis du opretter en POST-anmodning, kan du vælge at inkludere alle egenskaber fra CRM-posten eller kun at sende specifikke egenskaber:

• Hvis du vil inkludere alle egenskaber, skal du vælge Include all properties under Customize request body.
• For kun at inkludere specifikke egenskaber:
  
  • Under afsnittet Request body skal du vælge Customize request body.
  • Indtast nøgle og værdi.
  • Hvis du vil ændre en egenskabs navn i webhook'en, skal du redigere tekstfeltet Key . Dette vil kun opdatere egenskabsnavnet i POST-anmodningen, det vil ikke opdatere egenskabsnavnet eller det interne navn i HubSpot.
  • Klik på Tilføj egenskab for at tilføje en anden egenskab.
  • Hvis du vil fjerne en egenskab, skal du klikke på delete papirkurv-ikonet.
    
    

Tilpas dine GET-anmodninger

Hvis du opretter en GET-anmodning, kan du bruge egenskaber som forespørgselsparametre til at hente specifikke data:

• Under afsnittet Forespørgselsparametre skal du indtaste nøglen og derefter vælge en egenskab.
• Hvis du vil ændre en egenskabs navn i forespørgselsparameteren, skal du redigere tekstfeltet Egenskabsnavn . Dette vil kun opdatere egenskabsnavnet i GET-anmodningen, det vil ikke opdatere egenskabsnavnet eller det interne navn i HubSpot.
• Klik på Tilføj egenskab for at tilføje en anden egenskab.
• Hvis du vil fjerne en egenskab, skal du klikke på delete skraldespandsikonet.
• Vælg en autentificeringstype fra dropdown-menuen.
• Klik på Gem.
  
  

Test dit webhook i HubSpot

Når du opsætter dit POST- eller GET-webhook, kan du udføre en test for at se webhook-svaret. Under testen, hvor 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 dit webhook, kan du vælge, hvilke felter der skal outputtes til brug som input senere i dit workflow. Vælg kun outputs, der er tilgængelige i alle svar. Hvis outputtet bruges i en senere handling, men ikke er tilgængeligt i svaret, vil handlingen fejle.

• Klik på Test action i sidepanelet for at udvide sektionen.
• Klik på rullemenuen Objekt, og vælg derefter en post , du vil teste med.
• Klik på Test.
• For at tjekke webhook-detaljerne skal du vælge fanen Response eller Request. På hver fane kan du klikke på Åbn alle for at udvide alle sektioner eller Skjul alle for at skjule alle sektioner.
  
  • Klik på headers: eller body: i Response-fanen for at udvide hver sektion.
  • Klik på httpHeaders: i fanen Request for at udvide sektionen.
    
    

Test dit webhook eksternt

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

• Gå ind på https://webhook.site i din browser, og kopier den unikke URL.
• Indsæt URL' en i feltet Webhook URL i din webhook-handling.

• Når dit workflow er slået til, kan du manuelt tilmelde en testkontakt.

Hvis en webhook-handling med en POST-anmodning udløses, sendes en JSON-svartekst til webhook'en, der indeholder alle oplysninger om kontakten, herunder formularindsendelser, listemedlemskaber og alle kontaktens egenskabsvæ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, vil der blive sendt en generisk GET-anmodning, medmindre der er anvendt yderligere forespørgselsparametre.

Bemærk venligst: Historiske egenskabsværdier returneres kun i kontaktbaserede workflows. Webhooks, der bruges i alle andre workflowtyper, vil kun returnere den seneste værdi.

Bekræft anmodningssignaturer i workflow-webhooks

Når du har valgt Request signature i Authentication-sektionen for din Trigger a webhook-handling, vil HubSpot udfylde webhook'et 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 uparserede body. Læs mere om dette i dokumentationen til udviklerne.

For at verificere, at de anmodninger, der modtages på din URL, er fra HubSpot:

• Hav en udviklerkonto. Hvis du ikke har en, så tilmeld dig en udviklerkonto.
• Ejer en app. Hvis du ikke har en app, så lær at lave en app.
• Tjek 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 det udløse et workflow. Læs mere om at udløse workflows fra webhooks.

Brug webhook-data i datapanelet

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

For at bruge data fra det tilsluttede webhook:

• På din HubSpot-konto skal du navigere til Automatiseringer > Arbejdsgange.
• Klik på navnet på dit workflow.
• Klik på + plus-ikonet for at tilføje en handling.
• I venstre panel skal du vælge en handling, der bruger datapanelet.
• I datapanelet under Tilmeldingsegenskaber kan du vælge en af egenskaberne fra det tilsluttede webhook.