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å dit website.

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

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

• Hente 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. 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 HubSpot Developers Forums.

Opsæt et webhook i dit workflow

• Naviger i din HubSpot-konto til Automatisering > Arbejdsgange.
• Klik på navnet på workflowet.
• Klik på ikonet + for at tilføje en handling.
• Vælg Send et webhook i højre panel.
• Klik på rullemenuen Metode, og vælg derefter 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, vil der blive sendt en generisk POST- eller GET-anmodning.
• Opsæt din autentificeringstype til at autentificere anmodninger til dit webhook:
  • For at bruge en anmodningssignatur i din webhook-header:
    • Klik på dropdown-menuen 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 30. november 2022 er HubSpot API Keys ved at blive 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 autentificering, 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å dropdown-menuen 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-anmodning, 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 være struktureret 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 at teste med.
• Klik på Test.
• Vælg fanen Response eller Request for at tjekke webhook-detaljerne. 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:

• Naviger til 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: Historiske egenskabsværdier vil kun blive returneret i kontaktbaserede workflows. Webhooks, der bruges i alle andre workflowtyper, vil kun returnere den seneste værdi.

Bekræft anmodningssignaturer i workflow-webhooks

Hvis 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, hvordan du opretter en app.
• Tjek hash-væ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.

Sådan bruger du data fra det tilsluttede webhook:

• Naviger i din HubSpot-konto til Automatisering > 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 kan du under Tilmeldingsegenskaber vælge en af egenskaberne fra det tilsluttede webhook.