Använd webhooks med HubSpot-arbetsflöden

Använd webhooks i arbetsflöden för att skicka POST- eller GET-begäranden från dina arbetsflöden. Det finns en mängd olika användningsområden för webhooks, exempel på populära användningsområden för webhooks är:

• Exempel på vanliga användningsområden för webwebhooks är att skicka HubSpot-uppgifter om kontakter till ett annat system, t.ex. ett CRM-system, 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.

HubSpot reglerar webhook-trafiken separat från andra arbetsflödesprocesser. Detta görs för att effektivisera arbetsflödet och prestandan för webhookar. 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ånamnetpå arbetsflödet.
• Klicka på ikonen +för att lägga till en åtgärd.
• I den högra panelen väljer duSkicka 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 lägger du till frågeparametrar i Webhook-URL: en. Om inga frågeparametrar har lagts till skickas en generisk POST- eller GET-förfrågan.
• För att autentisera alla förfrågningar till din webhook:
  • Klicka på rullgardinsmenyn Autentiseringstyp och välj sedan Inkludera begärandesignatur i rubriken.
  • Ange ditt HubSpot App ID. Läs mer om hur duverifierar begärandesignaturer.
• 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 skickas data till och hämtas från en tredje part, men befintliga poster i HubSpot påverkas inte.

När du har testat din webhook kan duvälja vilka fält som ska skickas ut 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 om 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-adressen i fältet 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 åtgärdenUtlösa en webhook kommer HubSpot att fylla webhooken med en X-HubSpot-Signature-huvud med en SHA-256-hash av sammanlänkningen av app-sekret för ditt program, HTTP-metoden, URI och den oparserade kroppen. Läs mer om detta idokumentationen 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.