Gebruik webhooks met HubSpot workflows

Gebruik webhooks in workflows om informatie door te geven van HubSpot aan een andere webapplicatie.

Er zijn verschillende toepassingen voor webhooks, zoals het verzenden van gegevens en het pushen van meldingen.

Voorbeelden van populaire use cases voor webhooks zijn:

• Het posten van HubSpot contactgegevens naar een ander systeem, zoals een CRM, wanneer dat contact een bepaald formulier op uw site invult.

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

• Het versturen van chatalerts van uw externe systeem naar de chatstream van uw bedrijf, zodat werknemers weten dat er iets belangrijks is gebeurd.

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

Let op: HubSpot zal mislukte webhooks tot drie dagen lang opnieuw proberen, te beginnen één minuut na mislukking. Latere mislukkingen zullen met toenemende intervallen opnieuw worden geprobeerd, met een maximale tussenpoos van acht uur. Meer informatie over specifieke foutcode-uitzonderingen vindt u in de documentatie voor ontwikkelaars van HubSpot.

Voor meer informatie over de technische aspecten van webhooks, raadpleegt u de documentatie voor ontwikkelaars van HubSpot.

Een webhook in uw workflow instellen

• Navigeer in uw HubSpot account naar Automatisering > Workflows.
• Klik op de naamvan deworkflow.
• Klik op het + pictogram om eenactie toe te voegen.
• Selecteer in het rechterpaneel Trigger eenwebhook.
• Voer de webhook URL in. Webhook URL's zijn beperkt tot een beveiligd protocol en moeten beginnen met HTTPS.

• Schakel het selectievakjeAanvraaghandtekening gebruiken in om alle verzoeken aan uw webhook te verifiëren en voer uw App ID in. Leer hoe uverzoekhandtekeningen kunt verifiëren.
• Klik op Opslaan.

Let op: de Trigger a webhook actie ondersteunt alleen de POST methode.

Test uw webhook

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 die automatisch wordt aangemaakt. Plak de URL in het veld Webhook URL in uw webhook actie.

Het onderstaande voorbeeld toont de request body van de webhook hierboven, die meta-informatie onthult over een specifieke contactpersoon, inclusief contactinformatie, formulierinzendingen, lijstlidmaatschappen, enz. Wanneer de workflow actie werd getriggerd, stuurde HubSpot het volledige record van de contactpersoon geformatteerd in JSON naar de gespecificeerde URL.

Het ontvangende systeem kan dan de JSON-gegevens parseren en gebruiken voor zijn eigen toepassing.

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

Meer informatie over webhooks vindt u in de documentatie over webhooks voor ontwikkelaars. Als u vragen hebt over uw specifieke implementatie van webhooks met HubSpot, kunt u contact opnemen op de HubSpot-ontwikkelaarsforums.

Verzoekhandtekeningen in workflow-webhooks verifiëren

Als u Request signature hebt geselecteerd in de sectie Authentication voor uw Trigger awebhook-actie, zalHubSpot 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 je geen app hebt, leer dan hoe je een app maakt.
• Controleer de hashwaarde van de handtekening.