Gebruik webhooks met HubSpot workflows

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

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

Voorbeelden van populaire use cases voor webhooks zijn onder andere:

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

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

• Het versturen van chatwaarschuwingen van uw externe systeem naar de chatstroom van uw bedrijf die medewerkers laat weten dat er iets belangrijks is gebeurd.

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

Let op: HubSpot zal mislukte webhooks tot 3 dagen lang opnieuw proberen.

Voor meer informatie over de technische aspecten van webhooks, bekijk de documentatie van onze ontwikkelaars.

Zet een webhook op in uw workflow

• Navigeer in uw HubSpot account naar Automatisering > Workflows.
• Klik op de naamvan deworkflow.
• Klik op het + icoontje 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 selectievakjeHandtekening verzoek gebruiken in om eventuele verzoeken aan uw webhook te authenticeren en voer uw App-ID in. Leer hoe uverzoeken om handtekeningen 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 webhookactie 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. In het veld Webhook URL in uw webhook actie, plak de URL.

Het onderstaande voorbeeld toont de verzoek-instantie van de webhook hierboven, die meta-informatie over een specifieke contactpersoon onthult, inclusief contactgegevens, formulierinzendingen, lijst van lidmaatschappen, enz. Wanneer de workflow actie werd getriggerd, stuurde HubSpot het volledige record van de contactpersoon geformatteerd in JSON naar de opgegeven URL.

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

Let op: historische eigendomswaarden worden alleen geretourneerd in op contacten gebaseerde workflows. Webhooks die in alle andere workflowtypen worden gebruikt, geven alleen de meest recente waarde terug.

Meer informatie over webhooks vindt u in de webhooks-documentatie van de ontwikkelaars. Als u vragen heeft over uw specifieke implementatie van webhooks met HubSpot, neem dan contact op met de HubSpot Developers Forums.

Verifieer verzoek handtekeningen in workflow webhooks

Waar u in de sectie Authenticatieaanvraag voor uw Trigger eenwebhook actie hebt geselecteerd, zalHubSpot de webhook vullen met een X-HubSpot-handtekening header met een SHA-256 hash van de aaneenschakeling van de app-secret voor uw toepassing, de HTTP-methode, de URI, en de unparsed body. Meer informatie hierover vindt u in dedocumentatie van de ontwikkelaars.

Om te controleren of de verzoeken die u op uw URL ontvangt, 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 heeft, leer dan hoe u een app kunt maken.
• Controleer de hashwaarde van de handtekening.