Overslaan naar inhoud
Nederlands
Neem contact met ons op
  • Er zijn geen suggesties want het zoekveld is leeg.

Hoe kan ik 12Build webhooks instellen?

Ontdek hoe je webhooks instelt om automatisch mutaties van 12Build-data te ontvangen en te verwerken in externe applicaties.

Wat vind je in dit artikel?

  • Samenvatting: De werking van webhooks binnen 12Build.

  • Voorwaarden en doelgroep: Wat je nodig hebt voor de configuratie.

  • De setup: Hoe je een nieuw endpoint aanmaakt.

  • Het Webhook bericht: Informatie over aflevering en JSON-structuur.

  • Beschikbare objecten: Welke data je kunt ontsluiten.

  • Relationele data: Eigen data beheren via de API.

  • Veelgestelde vragen (FAQ): Vragen over limieten en inactiviteit.

  • Probleemoplossing: Wat te doen bij mislukte afleveringen.

Samenvatting

Webhooks maken het mogelijk om mutaties in 12Build-data direct naar externe applicaties te 'pushen'. In plaats van handmatig data op te halen, stuurt 12Build een notificatie naar een door jou ingesteld endpoint zodra er een relevante wijziging plaatsvindt.

Voorwaarden en doelgroep

Deze functie is bedoeld voor beheerders of developers die 12Build willen koppelen aan andere systemen.

  • Relaties: Er worden alleen notificaties gestuurd voor bouwspecialisten waarmee een relatie bestaat (gemarkeerd met een groene, gouden of zwarte ster).

  • Limiet: De webhook-functie werkt tot een maximum van 3.000 relaties.

9X_7INVpZ3TbH8pQUfjDeK1Bfjm6DpPzyXx_5iuotEst3oRTo48sWoji3BJ7OkjRYYmOHRypuVKldzPImNZ83kSl420xvdWi2OAYJ6-ZC5tS49GVic3zilQaxPXMHE-QRjl4uccR

De setup

Je configureert de webhooks binnen de algemene instellingen van je organisatie.

  1. Ga naar de Bedrijfsprofiel instellingen.

  2. Navigeer naar het onderdeel Webhooks.

  3. Maak een nieuwe webhook aan en geef het gewenste endpoint (de URL van je externe applicatie) op.

  4. Selecteer de specifieke objecten en gebeurtenissen waarvoor je een notificatie wilt ontvangen.

Het Webhook bericht

Wanneer een systeemwijziging voldoet aan jouw instellingen, wordt er een JSON-bericht verzonden.

  • Aflevergarantie: Bij een mislukte poging (geen http 2xx response of een timeout) probeert 12Build het bericht maximaal 3x opnieuw te verzenden.

  • Inactief: Indien een webhook gedurende 3 dagen geen enkele succesvolle aflevering heeft gehad, wordt deze automatisch op inactief gezet.

  • Structuur: De body bevat JSON-data met velden zoals webhookId, action, object, timestamp, en zowel de huidige (current) als vorige (previous) data van het object.

Beschikbare objecten

Op dit moment kun je webhooks instellen voor de volgende vijf objecten:

  • Company

  • CompanyRelation

  • CompanyRelationData

  • Document

  • Message

Relationele data

Het is mogelijk om eigen relationele data toe te voegen aan relaties voor exclusief eigen gebruik.

  • Beheer: Er is momenteel geen interface in 12Build om deze data te beheren.

  • API: Gebruik de API-functies om relationele data te beheren via:

    • getRelations

    • addRelationData

    • removeRelationData

    • updateRelationData

Veelgestelde vragen (FAQ)

Vraag: Waarom ontvang ik geen notificaties van bepaalde bouwspecialisten? Antwoord: Webhooks sturen alleen data van bedrijven die als relatie zijn aangemerkt (favorieten met een ster). Controleer of de betreffende bouwspecialist een ster-status heeft.

Vraag: Wat gebeurt er als mijn server tijdelijk offline is? Antwoord: 12Build probeert het bericht tot vier keer toe te verzenden. Let op dat de webhook na 3 dagen zonder succesvolle aflevering automatisch wordt uitgeschakeld.

Probleemoplossing

  • Symptoom: De webhook staat op inactief.

    • Oorzaak: Er is gedurende de afgelopen 3 dagen geen succesvolle verbinding gemaakt met jouw endpoint (geen HTTP 200-serie response).

    • Oplossing: Controleer de bereikbaarheid en de logs van je endpoint en activeer de webhook opnieuw in de bedrijfsprofiel instellingen.