Så här aktiverar du webhooks i kontaktbaserade arbetsflöden i HubSpot

Använd webhooks i kontaktbaserade arbetsflöden för att skicka eller hämta data mellan HubSpot och dina externa verktyg. På så sätt kan du automatisera processer över olika plattformar. Du kan använda en POST-webhook för att skicka data från HubSpot och en GET-webhook för att hämta data från externa verktyg.

När du konfigurerar dina POST- eller GET-webhooks kan du styra webhookens exekveringshastighet med hastighetsbegränsningar och testa din webhookkonfiguration manuellt i HubSpot eller med hjälp av externa verktyg. 
Du kan också lära dig hur du verifierar förfrågningar från HubSpot, hur du använder webhooks för att starta arbetsflöden automatiskt och hur du använder svarsdata från webhooks i andra arbetsflödesåtgärder.

Läs mer om webhooks i dokumentationen för utvecklare om webhooks. Om du har frågor om just din implementering av webhooks med HubSpot kan du vända dig till HubSpot Developers Forums.

Vilka är några exempel på användningsfall för webhooks?

Exempel på vanliga användningsfall för webhooks är:

• Att överföra kontaktdata från HubSpot till ett annat system, till exempel ett CRM-system, när kontakten fyller i ett visst formulär på din webbplats.

• Att skicka affärsdata till ett externt leveranshanteringssystem för att skapa en inköpsorder.

• Hämta data från ett annat system för att uppdatera dina HubSpot-poster.

Du kan skicka både POST- och GET-förfrågningar med hjälp

av

arbetsflöden. HubSpot hanterar webhook-trafiken separat från andra arbetsflödesprocesser. Detta görs för att optimera prestandan för både arbetsflöden och webhooks. När en webhook är långsam eller får en timeout kan det ta längre tid än väntat att utföra arbetsflödesåtgärden.

Hur skickar jag data från HubSpot med hjälp av en POST-webhook?

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt till Automatisering > Arbetsflöden.
2. För att redigera ett befintligt arbetsflöde klickar du på arbetsflödets namn. Du kan också skapa ett nytt arbetsflöde.
3. I arbetsflödesredigeraren klickar du på plusikonen (+) för att lägga till en åtgärd.
4. I den vänstra panelen, i avsnittet Data ops, väljer du Skicka en webhook.
    

5. Klicka på rullgardinsmenyn Metod och välj POST.
6. Ange webhook-URL:en.
   • Webhook-URL:er måste använda ett säkert protokoll och börja med HTTPS.
   • För att begära specifik information kan du lägga till sökparametrar, till exempel ?queryparameter=abc, i webhook-URL:en .
   • Om inga sökparametrar har lagts till skickas en generisk POST- eller GET-begäran.
7. Konfigurera din autentiseringstyp för att autentisera förfrågningar till din webhook. Du kan antingen använda en förfrågningssignatur i din webhook-rubrik eller använda en API-nyckel:
   • Så här använder du en begärandesignatur i din webhook-rubrik:
     • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan Inkludera begärandesignatur i rubriken.
     • Ange sedan ditt HubSpot-app-ID. Läs mer om hur du verifierar förfrågningssignaturer.
   • Så här använder du en API-nyckel eller en offentlig app som skapats via ett utvecklarkonto för autentisering:
     • När du använder en API-nyckel för autentisering beror namnet på API-nyckeln och var den finns på hur webhooken är konfigurerad. Av säkerhetsskäl visas inte API-nyckeln i några testförfrågningar. Så här använder du en API-nyckel:
       • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan API-nyckel.
       • Ange namnet på din API-nyckel.
       • Klicka på rullgardinsmenyn för API-nyckelns placering. Välj sedan antingen Frågeparametrar eller Förfrågningshuvud. Läs mer om hur du använder API-nycklar i HubSpot.
     • Om du skickar en begäran till HubSpot-API:er:
       • Klicka på rullgardinsmenyn för API-nyckel och välj en hemlig nyckel. Värdet för den hemliga nyckeln måste ha formatet Bearer [YOUR_TOKEN].
       • Ställ in värdet för API-nyckelns namn till Authorization.
       • Ange värdet för API-nyckelplats till Förfrågningshuvud.
8. För att inkludera alla egenskaper, välj Inkludera alla [objekt]-egenskaper.
9. Om du endast vill inkludera specifika egenskaper:
   • Välj Anpassa förfrågans innehåll.
   • För att anpassa förfrågningstexten med hjälp av en HubSpot-egenskap, ange Nyckel och välj en egenskap. För att lägga till en annan egenskap, klicka på Lägg till egenskap.
   • För att anpassa förfrågningstexten med hjälp av ett statiskt fält anger du nyckeln och värdet. För att lägga till en annan egenskap klickar du på Lägg till statiskt värde.
   • För att ta bort en egenskap eller ett statiskt värde, klicka på papperskorgsikonen.
10. Klicka på Spara högst upp.

Observera: för att välja flera utdata måste svaret vara strukturerat som ett JSON-objekt.

Hur hämtar jag data till HubSpot med hjälp av en GET-webhook?

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt till Automatisering > Arbetsflöden.
2. För att redigera ett befintligt arbetsflöde klickar du på arbetsflödets namn. Du kan också skapa ett nytt arbetsflöde.
3. I arbetsflödesredigeraren klickar du på plusikonen (+) för att lägga till en åtgärd.
4. I den vänstra panelen, under avsnittet Data ops, väljer du Skicka en webhook.
    

5. Klicka på rullgardinsmenyn Metod och välj GET.
6. Ange webhook-URL:en.
   • Webhook-URL:er måste använda ett säkert protokoll och börja med HTTPS.
   • För att begära specifik information kan du lägga till sökparametrar, till exempel ?queryparameter=abc, i webhook-URL: en.
   • Om inga sökparametrar har lagts till skickas en generisk POST- eller GET-begäran.
7. Konfigurera din autentiseringstyp för att autentisera förfrågningar till din webhook. Du kan antingen använda en förfrågningssignatur i din webhook-rubrik eller använda en API-nyckel:
   • Så här använder du en begärandesignatur i din webhook-rubrik:
     • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan Inkludera begärandesignatur i rubriken.
     • Ange sedan ditt HubSpot-app-ID. Läs mer om hur du verifierar förfrågningssignaturer.
   • Så här använder du en API-nyckel eller en offentlig app som skapats via ett utvecklarkonto för autentisering:
     • När du använder en API-nyckel för autentisering beror namnet på API-nyckeln och var den finns på hur webhooken är konfigurerad. Av säkerhetsskäl visas inte API-nyckeln i några testförfrågningar. Så här använder du en API-nyckel:
       • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan API-nyckel.
       • Ange namnet på din API-nyckel.
       • Klicka på rullgardinsmenyn för API-nyckelns placering. Välj sedan antingen Frågeparametrar eller Förfrågningshuvud. Läs mer om hur du använder API-nycklar i HubSpot.
     • Om du skickar en begäran till HubSpot-API:er:
       • Klicka på rullgardinsmenyn för API-nyckel och välj en hemlig nyckel. Värdet för den hemliga nyckeln måste ha formatet Bearer [YOUR_TOKEN].
       • Ställ in värdet för API-nyckelns namn till Authorization.
       • Ange värdet för API-nyckelplats till Förfrågningshuvud.
8. Om du konfigurerar en GET-förfrågan kan du antingen använda HubSpot-egenskaper eller lägga till statiska värden som frågeparametrar: 

9. Så här använder du en HubSpot-egenskap som sökparameter:
   • Under avsnittet Frågeparametrar anger du nyckeln och väljer sedan en egenskap.
   • För att lägga till en annan egenskap klickar du på Lägg till egenskap.
   • För att ta bort en egenskap klickar du på ikonen för borttagning.
10. Så här använder du ett statiskt värde som sökparameter:
    • Under avsnittet Sökparametrar anger du nyckeln och sedan ett värde.
    • För att lägga till en ytterligare egenskap, klicka på Lägg till statiskt värde.
    • För att ta bort en egenskap, klicka på ikonen för borttagning.
11. Klicka på Spara.

Hur styr jag webhookens exekveringshastighet med

hastighetsbegränsningar

?

Ställ in en hastighetsbegränsning för att bestämma hur snabbt webhook-åtgärden ska utföras. Hastighetsbegränsningen påverkar även alla efterföljande åtgärder i arbetsflödet.

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt till Automatisering > Arbetsflöden.
2. Klicka på arbetsflödets namn.
3. I arbetsflödesredigeraren klickar du på åtgärden Skicka en webhook.
4. Klicka på Konfigurera hastighetsbegränsningi den vänstra panelen för att expandera avsnittet.
5. Klicka för att slå på strömbegränsningen. Som standard är denna inställning avstängd. 
6. Ställ in din hastighetsbegränsning: 
   • Åtgärdskörningar: ställ in det maximala antalet körningar per tidsperiod. 
   • Tidsram: ställ in tidsramen för din hastighetsbegränsning. Du kan ställa in denna tidsram i sekunder, minuter eller timmar. 

Hur testar jag min webhook-konfiguration i HubSpot?

När du konfigurerar din POST- eller GET-webhook kan du köra ett test för att se webhook-svaret. Under testet, medan data skickas till och hämtas från en tredje part, påverkas inte befintliga poster i HubSpot. Om du använder en API-nyckel för autentisering visas inte API-nyckeln i några testförfrågningar.

Efter att du har testat din webhook kan du välja vilka fält som ska matas ut för att användas som indata senare i ditt arbetsflöde. Välj endast utdata som finns tillgängliga i varje svar. Om utdata används i en senare åtgärd men inte finns tillgänglig i svaret kommer åtgärden att misslyckas.

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt till Automatisering > Arbetsflöden.
2. Klicka på arbetsflödets namn.
3. I arbetsflödesredigeraren klickar du på åtgärden Skicka en webhook.
4. I den vänstra panelen klickar du på Teståtgärd för att expandera avsnittet.
5. Om du testar en POST-begäran kommer inställningen av webhook-testet att skilja sig åt beroende på om du har valt att Anpassa begärans innehåll eller att Inkludera alla [objekt]-egenskaper i webhook-åtgärden.
   • Om du har valt Anpassa begäransinnehåll anger du testvärdena för egenskaperna i ditt test.
   • Om du har valt ”Inkludera alla [objekt]-egenskaper” klickar du på rullgardinsmenyn [objekt] och väljer sedan en post att testa med.
6. Klicka på Testa.
7. För att kontrollera webhook-informationen väljer du fliken Svar eller Förfrågan. På varje flik kan du klicka på Öppna alla för att visa alla avsnitt, eller Dölj alla för att dölja alla avsnitt.
   • På fliken Svar klickar du på headers: eller body: för att visa respektive avsnitt.
   • På fliken Begäran klickar du på httpHeaders: för att visa avsnittet.
     
     

Hur testar jag webhooks med externa verktyg?

När du har skapat ditt arbetsflöde med en webhook-åtgärd kan du köra ett snabbtest med en test-URL för webhook:

1. Gå till https://webhook.site i din webbläsare och kopiera den unika URL:en.
2. Klistra in URL:en i fältet Webhook-URL i din webhook-åtgärd.
3. När ditt arbetsflöde har aktiverats kan du manuellt registrera en testkontakt.
4. När du testar din webhook externt:
   • Om en webhook-åtgärd med en POST-begäran utlöses skickas ett JSON-svar till webhooken som innehåller all information om kontakten, inklusive formulärinlämningar, listmedlemskap och alla kontaktattributvärden. Det mottagande systemet kan sedan analysera JSON-data och använda den för sin egen applikation.
   • Om en webhook-åtgärd med en GET-begäran utlöses skickas en generisk GET-begäran, såvida inte ytterligare sökparametrar har tillämpats.

Observera: historiska egenskapsvärden returneras endast i kontaktbaserade arbetsflöden. Webhooks som används i alla andra typer av arbetsflöden returnerar endast det senaste värdet.

Hur verifierar jag att webhook-förfrågningar kommer från HubSpot?

Om du har valt Förfrågningssignatur i avsnittet Autentisering för din åtgärd Utlös en webhook kommer HubSpot att fylla i webhooken med en X-HubSpot-Signature-rubrik med en SHA-256-hash av sammanfogningen av app-secret för din applikation, HTTP-metoden, URI:n och den oanalyserade kroppen. Läs mer om detta i utvecklarhandboken.

Så här kontrollerar du att de förfrågningar som tas emot på din URL kommer från HubSpot:

• Ha ett utvecklarkonto. Om du inte har ett, registrera dig för ett utvecklarkonto.
• Ha en app. Om du inte har en app kan du läsa om hur du skapar en app.
• Kontrollera signaturens hashvärde.

Hur använder jag webhooks för att starta arbetsflöden automatiskt?

Webhooks kan användas för att utlösa arbetsflöden. När data ändras i en tredjepartsapp kan detta utlösa ett arbetsflöde. Läs mer om att utlösa arbetsflöden från webhooks.

Hur använder jag svarsdata från webhooks i andra arbetsflödesåtgärder?

Data från den webhook som är ansluten till ditt konto kan användas för vissa åtgärder i datapanelen.

Så här använder du data från den anslutna webhooken:

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt till Automatisering > Arbetsflöden.
2. Klicka på namnet på ditt arbetsflöde.
3. Klicka på plusikonen (+) för att lägga till en åtgärd.
4. I den vänstra panelen väljer du en åtgärd som använder datapanelen.
5. I datapanelen, under Åtgärdsdata, väljer du åtgärden Skicka en webhook. Du kan sedan använda egenskaper från den anslutna webhooken.
    

Vad händer när en webhook misslyckas?

HubSpot försöker igen med misslyckade webhooks i upp till tre dagar, med start en minut efter misslyckandet. Efterföljande misslyckanden försöks igen med allt längre intervall, med ett maximalt uppehåll på åtta timmar mellan försöken.

Arbetsflöden gör inga nya försök efter att ha mottagit svarsstatuskoder i 4XX-serien. Undantaget är 429-fel för hastighetsbegränsning; arbetsflöden gör automatiskt ett nytt försök efter att ha mottagit ett 429-svar och respekterar Retry-After-rubriken om den finns. Retry-After anges i millisekunder. Läs mer om specifika undantag för felkoder i HubSpots utvecklardokumentation.