Gebruik webhooks met HubSpot workflows

Gebruik webhooks in workflows om POST of GET verzoeken te sturen vanuit uw workflows. Er zijn een verscheidenheid aan toepassingen voor webhooks, voorbeelden van populaire use cases voor webhooks zijn onder andere:

• Het posten van HubSpot contactpersonen gegevens naar een ander systeem, zoals een CRM, wanneer die contactpersoon een bepaald formulier op uw site invult.

• Het versturen van deal data naar een extern verzendsysteem om een inkooporder aan te maken.

• Chatalerts van uw externe systeem naar de chatstream van uw bedrijf sturen om medewerkers te laten weten dat er iets belangrijks is gebeurd.

• Gegevens ophalen uit een ander systeem om uw HubSpot records bij te werken.

HubSpot regelt webhook verkeer apart van andere workflow processen. Dit wordt gedaan om workflow en webhook prestaties te stroomlijnen. Wanneer een webhook traag is of een time-out heeft, kan het langer duren dan verwacht om de workflowactie uit te voeren.

Let op: HubSpot zal mislukte webhooks tot drie dagen lang opnieuw proberen, vanaf één minuut na mislukking. Latere mislukkingen zullen opnieuw worden geprobeerd met toenemende intervallen, met een maximum van acht uur tussen pogingen. Meer informatie over specifieke foutcode-uitzonderingen in HubSpot's documentatie voor ontwikkelaars.

Leer meer over webhooks in de webhooks documentatie voor ontwikkelaars. Als u vragen heeft over uw specifieke implementatie van webhooks met HubSpot, reik dan uit op de HubSpot Developers Forums.

Een webhook in uw workflow instellen

• { local.navWorkflows }}
• Klik op denaamvan de workflow.
• Klik op het+ icoonom een actie toe te voegen.
• Selecteer in het rechterpaneelSend a webhook (Een webhaak verzenden).
• Klik op het vervolgkeuzemenu Methode en selecteer POST of GET.
• Voer de webhook URL in. Webhook URL's zijn beperkt tot een beveiligd protocol en moeten beginnen met HTTPS. Om specifieke informatie op te vragen, voegt u queryparameters toe aan de Webhook URL. Als er geen queryparameters zijn toegevoegd, wordt er een algemeen POST- of GET-verzoek verzonden.
• Om alle verzoeken naar uw webhook te verifiëren:
  • Klik op het Authenticatie type dropdown menu, selecteer dan Include request signature in header.
  • Voer uw HubSpot App ID in. Leer hoe uverzoekhandtekeningen kunt verifiëren.
• Klik op Opslaan.
  
  

Test uw webhook binnen HubSpot

Wanneer u uw POST of GET webhook instelt, kunt u een test uitvoeren om de webhook respons te bekijken. Tijdens de test, terwijl gegevens worden verzonden naar en opgehaald van een derde partij, zullen bestaande records in HubSpot niet worden beïnvloed.

Na het testen van uw webhook, kunt uselecteren welke velden moeten worden uitgevoerd voor gebruik als invoer later in uw workflow. Selecteer alleen outputs die beschikbaar zijn in elke reactie. Als de uitvoer wordt gebruikt in een latere actie maar niet beschikbaar is in de reactie, zal de actie mislukken.

• Klik in het zijpaneel op Testactie om de sectie uit te vouwen.
• Klik op het vervolgkeuzemenu Object en selecteer vervolgens een record om te testen.
• Klik op Test.
• Als u de details van de webhook wilt controleren, selecteert u het tabblad Response of Request. Op elk tabblad kunt u klikken op Alles openen om alle secties uit te vouwen, of Alles samenvouwen om alle secties samen te vouwen.
  
  • Klik in het tabblad Reactie op headers: of body: om elke sectie uit te vouwen.
  • Klik in het tabblad Request op httpHeaders: om de sectie uit te breiden.
    
    

Uw webhook extern testen

Nadat u uw workflow met een webhook-actie hebt gemaakt, kunt u een snelle test uitvoeren met een dummy webhook URL:

• Navigeer in uw browser naar https://webhook.site en kopieer de unieke URL.
• Plak de URL in het veld Webhook URL in uw webhook actie.
  
  

• Zodra uw workflow is ingeschakeld, kunt u handmatig een testcontact aanmelden.

Als een webhook actie met een POST verzoek wordt getriggerd, zal een JSON response body naar de webhook worden gestuurd met alle informatie over het contact, inclusief formulier inzendingen, lijst lidmaatschappen, en alle contact eigenschap waarden. Het ontvangende systeem kan dan de JSON gegevens parseren, en gebruiken voor zijn eigen toepassing.

Als een webhook actie met een GET verzoek wordt getriggerd, zal een generiek GET verzoek worden verzonden, tenzij aanvullende query parameters zijn toegepast.

Let op: historische eigenschap waarden zullen alleen worden geretourneerd in contact-gebaseerde workflows. Webhooks die in alle andere workflowtypes worden gebruikt, zullen alleen de meest recente waarde terugsturen.

Verzoekhandtekeningen in workflow-webhooks verifiëren

Wanneer u Verzoek handtekening heeft geselecteerd in de Authenticatie sectie voor uwTrigger een webhook actie, zal HubSpot de webhook vullen met een X-HubSpot-Signature header met een SHA-256 hash van de aaneenschakeling van de app-secret voor uw applicatie, de HTTP methode, de URI, en de ongeparsede body. Meer informatie hierover vindt u in dedocumentatie voor ontwikkelaars.

Om te verifiëren dat de verzoeken ontvangen op uw URL afkomstig zijn van HubSpot:

• Bezit een ontwikkelaarsaccount. Als je er geen hebt, meld je dan aan voor een ontwikkelaarsaccount.
• Bezit een app. Als u geen app hebt, leer dan hoe u een app maakt.
• Controleer de hashwaarde van de handtekening.