Använd webhooks med HubSpot-arbetsflöden

Använd webhooks i arbetsflöden för att överföra information från HubSpot till en annan webbapplikation.

Det finns en mängd olika användningsområden för webhooks, t.ex. att skicka data och skicka meddelanden. Exempel på populära användningsområden för webhooks är bland annat:

• Skicka uppgifter om HubSpot-kontakter till ett annat system, t.ex. 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 chattflöde för att informera anställda om att något viktigt har hänt.

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.

Mer information om de tekniska aspekterna av webhooks finns i HubSpot's utvecklardokumentation.

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 duUtlösa en webhook.
• Ange webbhookens webbadress. Webhook-URL:er är begränsade till ett säkert protokoll och måste börja med HTTPS.

• Markera kryssrutanAnvänd begärandesignatur för att autentisera alla begäranden till din webhook och ange ditt App-ID. Läs mer om hur duverifierar begäranssignaturer.
• Klicka påSpara.

Observera: åtgärden Trigger a webhook stöder endast POST-metoden.

Testa din webhook

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 din webbläsare och kopiera den unika webbadress som skapas automatiskt. Klistra in URL:en i fältet Webhook URL i din webhookåtgärd.

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

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.

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.

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 fyller HubSpot webhooken med en X-HubSpot-Signature-huvudrubrik med en SHA-256-hash av sammanlänkningen av app-sekret för din applikation, HTTP-metoden, URI:n 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.