Gå til indhold
Dansk
Kontakt os
  • Der er ingen forslag, da søgefeltet er tomt.

Hvordan kan jeg konfigurere 12Build-webhooks?

Find ud af, hvordan du konfigurerer webhooks til automatisk at modtage og behandle ændringer i 12Build-data i eksterne applikationer.

Hvad finder du i denne artikel?

  • Resumé: Sådan fungerer webhooks i 12Build.

  • Forudsætninger og målgruppe: Hvad du har brug for til konfigurationen.

  • Opsætningen: Sådan opretter du et nyt endpoint.

  • Webhook-meddelelsen: Oplysninger om levering og JSON-struktur.

  • Tilgængelige objekter: Hvilke data du kan få adgang til.

  • Relationelle data: Administrer dine egne data via API'en.

  • Ofte stillede spørgsmål (FAQ): Spørgsmål om begrænsninger og inaktivitet.

  • Fejlfinding: Hvad skal man gøre ved mislykkede leveringer?

Resumé

Webhooks gør det muligt at 'pushe' ændringer i 12Build-data direkte til eksterne applikationer. I stedet for manuelt at hente data sender 12Build en notifikation til et endpoint, du har angivet, så snart der sker en relevant ændring.

Betingelser og målgruppe

Denne funktion er beregnet til administratorer eller udviklere, der ønsker at integrere 12Build med andre systemer.

  • Relationer: Der sendes kun notifikationer for underentreprenører, som der eksisterer en relation til (markeret med en grøn, guld eller sort stjerne).

  • Begrænsning: Webhook-funktionen fungerer op til maksimalt 3.000 relationer.

9X_7INVpZ3TbH8pQUfjDeK1Bfjm6DpPzyXx_5iuotEst3oRTo48sWoji3BJ7OkjRYYmOHRypuVKldzPImNZ83kSl420xvdWi2OAYJ6-ZC5tS49GVic3zilQaxPXMHE-QRjl4uccR

Opsætning

Du konfigurerer webhooks i din organisations generelle indstillinger.

  1. Gå til indstillingerne for Virksomhedsprofil.

  2. Naviger til afsnittet Webhooks.

  3. Opret en ny webhook, og angiv det ønskede endpoint (URL'en til din eksterne applikation).

  4. Vælg de specifikke objekter og begivenheder, som du ønsker at modtage en notifikation for.

Webhook-meddelelsen

Når en systemændring opfylder dine indstillinger, sendes der en JSON-besked.

  • Leveringsgaranti: Ved et mislykket forsøg (ingen http 2xx-respons eller en timeout) forsøger 12Build at sende meddelelsen op til 3 gange igen.

  • Inaktiv: Hvis en webhook ikke har haft nogen succesfuld levering i 3 dage, sættes den automatisk til inaktiv.

  • Struktur: Brødteksten indeholder JSON-data med felter som webhookId, action, object, timestamp, og både den aktuelle (current) som tidligere (previous) data for objektet.

Tilgængelige objekter

I øjeblikket kan du konfigurere webhooks for følgende fem objekter:

  • Company

  • Virksomhedsrelation

  • CompanyRelationData

  • Dokument

  • Meddelelse

Relationelle data

Det er muligt at tilføje egne relationelle data til relationer til eksklusivt eget brug.

  • Administration: Der findes i øjeblikket ingen grænseflade i 12Build til at administrere disse data.

  • API: Brug API-funktionerne til at administrere relationelle data via:

    • getRelations

    • addRelationData

    • removeRelationData

    • updateRelationData

Ofte stillede spørgsmål (FAQ)

Spørgsmål: Hvorfor modtager jeg ikke notifikationer fra bestemte byggefagspecialister? Svar: Webhooks sender kun data fra virksomheder, der er markeret som relationer (favoritter med en stjerne). Kontroller, om den pågældende byggefagspecialist har en stjernestatus.

Spørgsmål: Hvad sker der, hvis min server midlertidigt er offline? Svar: 12Build forsøger at sende beskeden op til fire gange. Bemærk, at webhooken automatisk deaktiveres efter 3 dage uden vellykket levering.

Fejlfinding

  • Symptom: Webhooken er inaktiv.

    • Årsag: Der er ikke blevet oprettet en vellykket forbindelse til dit endpoint i løbet af de sidste 3 dage (ingen HTTP 200-serie-respons).

    • Løsning: Kontroller tilgængeligheden og logfilerne for dit endpoint, og aktiver webhooken igen i virksomhedsprofilindstillingerne.