Använd webhooks med HubSpot-arbetsflöden

Använd webhooks i arbetsflöden för att skicka eller hämta information mellan HubSpot och andra externa verktyg. Det finns en mängd olika användningsområden för webhooks, exempel på populära användningsområden för webhooks är:

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

• Skicka affärsdata till ett externt system för hantering av leveranser för att skapa en inköpsorder.

• Skicka chattvarningar från ditt externa system till företagets chattström för att meddela anställda att något viktigt har inträffat.

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

Du kan skicka både POST- och GET-begäranden med hjälp av arbetsflöden. HubSpot reglerar webhook-trafiken separat från andra arbetsflödesprocesser. Detta görs för att effektivisera arbetsflödes- och webhookprestanda. När en webhook är långsam eller tar tid kan arbetsflödesåtgärden ta längre tid än väntat att utföra.

Observera: HubSpot försöker igen misslyckade webhooks i upp till tre dagar, med början en minut efter misslyckandet. Efterföljande misslyckanden kommer att prövas på nytt med ökande intervaller, med ett maximalt intervall på åtta timmar mellan försöken. Läs mer om specifika undantag för felkoder i HubSpots dokumentation för utvecklare.

Läs mer om webhooks i utvecklarnas dokumentation om webhooks. Om du har frågor om din specifika implementering av webhooks med HubSpot kan du ta kontakt på HubSpot Developers Forums.

Konfigurera en webhook i ditt arbetsflöde

• I ditt HubSpot-konto, navigera till Automatisering > Arbetsflöden.}
• Klicka på namnet på arbetsflödet.
• Klicka på ikonen + för att lägga till en åtgärd.
• I den högra panelen väljer du Skicka en webhook.
• Klicka på rullgardinsmenyn Metod och välj sedan POST eller GET.
• Ange webhook-URL:n. Webhook-URL:er är begränsade till ett säkert protokoll och måste börja med HTTPS. Om du vill begära specifik information kan du lägga till frågeparametrar som till exempel ?queryparameter=abc till webbhook-URL:en. Om inga frågeparametrar har lagts till skickas en generisk POST- eller GET-förfrågan.
• Ange din autentiseringstyp för att autentisera förfrågningar till din webhook:
  • Så här använder du en signatur för begäran i din webhook-huvudrubrik:
    • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan Inkludera signatur för begäran i huvudet.
    • Ange sedan ditt HubSpot-app-ID. Läs mer om hur du verifierar begärandesignaturer.

• • Du kan också använda en API-nyckel för autentisering. När du använder en API-nyckel för autentisering beror API-nyckelns namn och API-nyckelplats på hur webhooken är konfigurerad. Av säkerhetsskäl kommer API-nyckeln inte att visas i några testförfrågningar. Användning av en API-nyckel:
    • Klicka på rullgardinsmenyn Autentiseringstyp. Välj sedan API-nyckel.

• • • Ange namnet på din API-nyckel.
    • Klicka på rullgardinsmenyn API-nyckelplats. Välj sedan antingen Förfrågeparametrar eller Förfrågningshuvud. Läs mer om hur du använder API-nycklar i HubSpot.
• Om du ställer in en POST-förfrågan kan du välja att inkludera alla egenskaper från CRM-posten eller att skicka endast specifika egenskaper:
  • Om du vill inkludera alla egenskaper väljer du Inkludera alla egenskaper under avsnittet Anpassa förfrågningskroppen.
  • För att inkludera endast specifika egenskaper:
    
    • Under avsnittet Anpassa förfrågningskroppen väljer du Välj specifika egenskaper.
    • Klicka på rullgardinsmenyn Välj egenskap. Klicka sedan på [objekt] i det här arbetsflödet och välj en egenskap.
    • Om du vill ändra en egenskaps namn i webhooken redigerar du textfältet Egendomsnamn . Detta kommer endast att uppdatera egenskapsnamnet i POST-förfrågan, det kommer inte att uppdatera egenskapsnamnet eller det interna namnet i HubSpot.
    • Om du vill lägga till en annan egenskap klickar du på Lägg till egenskap.
    • Om du vill ta bort en egenskap klickar du på ikonen för borttagning av papperskorgen
      .
      

• Om du ställer in en GET-begäran kan du använda egenskaper som frågeparametrar:
  
  • Klicka på rullgardinsmenyn Välj egenskap under avsnittet Frågeparametrar . Klicka sedan på [objekt] i det här arbetsflödet och välj en egenskap.
  • Om du vill ändra en egenskaps namn i frågeparametern redigerar du textfältet Egendomsnamn . Detta kommer endast att uppdatera egenskapsnamnet i GET-förfrågan, det kommer inte att uppdatera egenskapsnamnet eller det interna namnet i HubSpot.

• • Om du vill lägga till en annan egenskap klickar du på Lägg till frågeparameter.
  • Om du vill ta bort en egenskap klickar du på ikonen för papperskorgen för att ta bort den.
• Klicka på Save (Spara).
  
  

Anpassa din POST-förfrågan

Om du ställer in en POST-förfrågan kan du välja att inkludera alla egenskaper från CRM-posten eller att skicka endast specifika egenskaper:

• Om du vill inkludera alla egenskaper väljer du Inkludera alla egenskaper under avsnittet Anpassa begärandekroppen.
• Om du bara vill inkludera specifika egenskaper:
  
  • Under avsnittet Anpassa begärandekroppen väljer du Välj specifika egenskaper.
  • Klicka på rullgardinsmenyn Välj egenskap. Klicka sedan på [objekt] i det här arbetsflödet och välj en egenskap.
  • Om du vill ändra en egenskaps namn i webhooken redigerar du textfältet Egendomsnamn . Detta kommer endast att uppdatera egenskapsnamnet i POST-förfrågan, det kommer inte att uppdatera egenskapsnamnet eller det interna namnet i HubSpot.
  • Om du vill lägga till en annan egenskap klickar du på Lägg till egenskap.
  • Om du vill ta bort en egenskap klickar du på ikonen för borttagning av papperskorgen
    .
    

Anpassa dina GET-förfrågningar

Om du konfigurerar en GET-begäran kan du använda egenskaper som frågeparametrar för att hämta specifika data:

• Klicka på rullgardinsmenyn Välj egenskap under avsnittet Förfrågningsparametrar . Klicka sedan på [objekt] i det här arbetsflödet och välj en egenskap.
• Om du vill ändra en egenskaps namn i frågeparametern redigerar du textfältet Egendomsnamn . Detta kommer endast att uppdatera egenskapsnamnet i GET-förfrågan, det kommer inte att uppdatera egenskapsnamnet eller det interna namnet i HubSpot.

• Om du vill lägga till en annan egenskap klickar du på Lägg till frågeparameter.
• Om du vill ta bort en egenskap klickar du på ikonen för papperskorgen för att ta bort den.
• Klicka på Spara.
  
  

Testa din webhook i HubSpot

När du konfigurerar din POST- eller GET-webhook kan du utföra ett test för att visa 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 kommer API-nyckeln inte att visas i några testförfrågningar.

När du har testat din webhook kan duvälja vilka fält som ska produceras för att användas som indata senare i arbetsflödet. Välj endast utgångar som är tillgängliga i varje svar. Om utmatningen används i en senare åtgärd men inte är tillgänglig i svaret kommer åtgärden att misslyckas.

• I sidopanelen klickar du på Testa åtgärd för att expandera avsnittet.
• Klicka på rullgardinsmenyn Objekt och välj sedan en post att testa med.
• Klicka på Test.
• Om du vill kontrollera detaljerna i webhooken väljer du fliken Svar eller begäran. På varje flik kan du klicka på Öppna alla för att expandera alla sektioner eller på Kolla alla för att kollapsa alla sektioner.
  
  • På fliken Svar klickar du på headers: eller body: för att expandera varje avsnitt.
  • Klicka på httpHeaders: på fliken Begäran för att expandera avsnittet.
    
    

Testa din webhook externt

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

• Navigera till https://webhook.site i webbläsaren och kopiera den unika webbadressen.
• Klistra in URL-fältet för Webhook-URL i din webhook-åtgärd.
  
  

• När ditt arbetsflöde har aktiverats kan du manuellt registrera en testkontakt.

Om en webhookåtgärd med en POST-förfrågan utlöses skickas en JSON-svarskropp till webhooken som innehåller all information om kontakten, inklusive formulärsinlämningar, listmedlemskap och alla värden för kontaktegenskaper. Det mottagande systemet kan sedan analysera JSON-data och använda den i sin egen applikation.

Om en webhook-åtgärd med en GET-förfrågan utlöses skickas en generisk GET-förfrågan, om inte ytterligare frågeparametrar har tillämpats.

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

Verifiera begäranssignaturer i webhooks för arbetsflöden

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

Kontrollera att de förfrågningar som tas emot vid din URL kommer från HubSpot:

• Äga ett utvecklarkonto. Om du inte har något, registrera dig för ett utvecklarkonto.
• Äga en app. Om du inte har en app, lär dig hur du skapar en app.
• Kontrollera signaturens hashvärde.