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 het webhook-verkeer apart van andere workflowprocessen. 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 opnieuw worden geprobeerd met toenemende intervallen, met een maximum van acht uur tussen de pogingen. Meer informatie over specifieke foutcode-uitzonderingen vindt u in de documentatie voor ontwikkelaars van HubSpot.

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

Een webhook instellen in uw workflow

• Navigeer in uw HubSpot account naar Automatisering > Workflows.
• Klik op de naamvan deworkflow.
• Klik op het + icoon om eenactie toe te voegen.
• Selecteer in het rechterpaneel Triggera webhook.
• 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 actie Trigger a webhook 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.

Zodra de webhook actie is getriggerd, zal een JSON response body worden verzonden naar de webhook 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.

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 heeft over uw specifieke implementatie van webhooks met HubSpot, neem dan contact op via de HubSpot Developers Forums.

Verzoek handtekeningen in workflow webhooks verifiëren

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