HubSpot Kennisbank

Uw webhooks aanpassen (BETA)

Geschreven door HubSpot Support | Aug 11, 2022 1:41:05 PM

Als u webhooks in workflows gebruikt om POST- of GET-verzoeken vanuit uw workflows te verzenden, kunt u uw webhooks aanpassen om de verzonden en ontvangen gegevens te regelen.

In uw POST-verzoeken kunt u de eigenschappen specificeren die naar eventuele externe systemen, zoals een CRM, worden verzonden. Op dezelfde manier kunt u in uw GET-verzoeken de eigenschappen specificeren die via queryparameters worden opgevraagd.

Leer meer over webhooks in de developers webhooks documentatie. Als u vragen heeft over uw specifieke implementatie van webhooks met HubSpot, neem dan contact op met de HubSpot Developers Forums

.

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 maximale pauze van acht uur tussen pogingen. Meer informatie over specifieke foutcode-uitzonderingen vindt u in HubSpot's documentatie voor ontwikkelaars

.

Uw webhook instellen

Om uw webhooks te creëren en aan te passen:

  • { local.navWorkflows }}
  • Klik op de naam van de workflow.
  • Klik op het + pictogram om een actie toe te voegen.
  • Selecteer in het rechterpaneel Een webhook 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, kunt u queryparameters zoals ?queryparameter=abc aan de Webhook URL toevoegen. Als er geen queryparameters zijn toegevoegd, wordt er een algemeen POST- of GET-verzoek verzonden.
  • Stel uw authenticatie type in om verzoeken naar uw webhook te authenticeren:
    • Om een verzoekhandtekening te gebruiken in uw webhook-header:
      • Klik op het Authenticatie type dropdown menu. Selecteer vervolgens Include request signature in header.
      • Voer vervolgens uw HubSpot App ID in. Leer hoe u verzoekhandtekeningen kunt verifiëren.
    • U kunt ook een API-sleutel gebruiken voor authenticatie. Bij gebruik van een API sleutel voor verificatie, zijn de API sleutel naam en API sleutel locatie die gebruikt worden afhankelijk van hoe de webhook is geconfigureerd. Om veiligheidsredenen wordt de API-sleutel niet weergegeven in testverzoeken. Om een API sleutel te gebruiken:
      • Klik op het Authenticatie type dropdown menu. Selecteer vervolgens API-sleutel.
      • Voer de naam van uw API-sleutel in.
      • Klik op het vervolgkeuzemenu API-sleutellocatie. Selecteer vervolgens Query parameters of Request header. Meer informatie over het gebruik van API-sleutels in HubSpot.

Pas uw POST-verzoek aan

Als u een POST-verzoek instelt, kunt u ervoor kiezen om alle eigenschappen van het CRM-record op te nemen of om alleen specifieke eigenschappen te verzenden:
  • Om alle eigenschappen op te nemen, selecteert u onder de sectie Request body aanpassen: Include all properties
  • .
  • Om alleen specifieke eigenschappen op te nemen:
    • Selecteer onder Customize request body de optie Choose specific properties
    • .
    • Klik op het vervolgkeuzemenu Kies eigenschap. Klik vervolgens op [object] in deze workflow en selecteer een eigenschap
    • .
    • Om de naam van een eigenschap in de webhook te wijzigen, bewerkt u het tekstveld Property name
    • . Dit zal alleen de property naam in het POST verzoek bijwerken, het zal niet de property naam of interne naam in HubSpot bijwerken.
    • Om een andere property toe te voegen, klik op Add property
    • .
    • Om een eigenschap te verwijderen, klik op het verwijder prullenbak icoon
      .


Uw GET verzoeken aanpassen

Als je een GET verzoek instelt, kun je eigenschappen gebruiken als query parameters om specifieke gegevens op te halen:
  • Klik onder het gedeelte Queryparameters op het vervolgkeuzemenu Kies eigenschap. Klik vervolgens op [object] in deze workflow en selecteer een eigenschap
  • .
  • Om de naam van een eigenschap in de queryparameter te wijzigen, bewerkt u het tekstveld Property name
. Dit zal alleen de naam van de eigenschap in het GET-verzoek bijwerken, het zal niet de naam van de eigenschap of de interne naam in HubSpot bijwerken.
  • Om een andere eigenschap toe te voegen, klik op query parameter toevoegen
  • .
  • Om een eigenschap te verwijderen, klik op het verwijder prullenbak icoon
  • .
  • Klik op Opslaan.