Anpassa dina webhooks (BETA)

Om du använder webhooks i arbetsflöden för att skicka POST- eller GET-begäranden från dina arbetsflöden kan du anpassa dina webhooks så att du kan styra de data som skickas och tas emot.

I dina POST-begäranden kan du ange de egenskaper som skickas till externa system, t.ex. ett CRM. På samma sätt kan du i dina GET-begäranden ange de egenskaper som begärs genom frågeparametrar.

Läs mer om webhooks i dokumentationen för webhooks för utvecklare. Om du har frågor om din specifika implementering av webhooks med HubSpot kan du kontakta HubSpot Developers Forums

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 intervall, 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

Konfigurera din webhook

Så här skapar och anpassar du dina webhooks:

• I ditt HubSpot-konto navigerar du till Automatiseringar > Arbetsflöden.}
• Klicka på arbetsflödets namn .
• Klicka på ikonen + för att lägga till en åtgärd.
• Välj Skicka en webhook i den högra panelen.
• 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.
• Använd en nyckelnyckel för att autentisera förfrågningar till din webhook:
  • Så här använder du en förfrågningssignatur 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.
      
      

Anpassa din POST-förfrågan

• Om du vill inkludera alla egenskaper väljer du Inkludera alla egenskaper under avsnittet Anpassa begärandekroppen
.
• Om du bara vill inkludera specifika egenskaper:
  
  • Välj Välj specifika egenskaper under avsnittet Anpassa begärandekroppen
  .
  • 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

• Klicka på rullgardinsmenyn Välj egenskap i 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

• 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.