Webhooks

Hva er en Webhook?

<div class="version-tag">v5.0</div>

‍

En webhook er en mekanisme for å sende automatiske meldinger eller data fra en webapplikasjon til en annen i sanntid. I stedet for at en klient må spørre en server gjentatte ganger etter oppdateringer eller informasjon, kan serveren sende data til klienten direkte når det er noe nytt å rapportere.

I praksis fungerer en webhook slik at en klient (vanligvis en webserver) registrerer en URL hos en annen server (vanligvis en webtjeneste). Når en hendelse inntreffer som klienten er interessert i, sender den første serveren en HTTP-melding til den angitte URLen. Denne meldingen inneholder vanligvis relevant data eller informasjon om hendelsen som nettopp har skjedd. Den andre serveren kan deretter bruke denne dataen til å ta passende handlinger eller oppdatere seg selv i tråd med hendelsen.

Webhooks brukes ofte til å integrere forskjellige webtjenester og automatisere prosesser mellom dem, for eksempel å sende varsler fra en app til en annen, oppdatere databaser når ny data er tilgjengelig, eller koordinere forskjellige deler av en større systemarkitektur.

‍

‍

Oppsett av en webhook-tilkobling i Geometra

<div class="version-tag">v5.0</div>

‍

For å koble et prosjekt til å sende data via en webhook til din mottakende tjeneste eller applikasjon, trenger du en sluttpunkts-URL. Dette er adressen du ønsker at Geometra kontinuerlig skal sende data fra prosjektet til. Dataene sendes i sanntid og må håndteres på mottakersiden av deg.

I prosjektvisningen kan du lime inn adressen til et sluttpunkt hvor du vil sende dataen. Hver gang du deretter åpner prosjektet, vil datastrømmen starte en "project_sync", som sikrer at du alltid får en oppdatert kopi før du begynner å jobbe.

Meldingen "project_sync" inneholder all informasjon som finnes i prosjektet.

Opprett, endre og slett kalkyler

<div class="version-tag">v5.0</div>

‍

Det finnes tre meldinger knyttet til kalkyler: "create_estimate", "update_estimate" og "delete_estimate".

Disse meldingene inneholder all informasjon om selve kalkylen, for eksempel anbudskalkylen som opprettes automatisk i hvert prosjekt.

‍

Opprett, endre og slett objekter

<div class="version-tag">v5.0</div>

‍

Det finnes tre meldinger knyttet til objekter: "create_object", "update_object" og "delete_object".

Disse meldingene inneholder all informasjon om enkeltobjekter. Når du oppretter et objekt, sendes meldingen med alle beregnede verdier og utseendeparametere. Imidlertid sendes ingen rader for objektet; de sendes i separate meldinger.

‍

Opprett, endre og slett rader

<div class="version-tag">v5.0</div>

‍

Det finnes tre meldinger knyttet til data for rader i Geometra: "create_row", "update_row" og "delete_row".

Disse meldingene inneholder all informasjon om enkeltrader. Når du legger til en rad, sendes meldingen med all informasjon som trengs for å opprette den raden. Oppdateringer til raden sender bare en referanse til hvilken rad (ID) og hvilken verdi som er endret, for eksempel materiale.

‍

Automatisering

<div class="version-tag">v5.0</div>

‍

Hensikten med å opprette en webhook-tilkobling for prosjektet ditt i Geometra er at du slipper å eksportere data manuelt til Excel, Sheets eller andre kalkyleverktøy. Du forteller rett og slett hva du alltid vil ha oppdatert med informasjon fra Geometra.

Hvis muligheten for å motta data via Webhook ikke finnes i kalkyleprogrammet ditt i dag, anbefaler vi at du kontakter leverandøren din for å se etter eventuelle løsninger. Å koble seg til Geometras webhook er gratis, og det er ikke noe din leverandør trenger å betale for å få tilgang til. Vi hjelper gjerne til, så ikke nøl med å ta kontakt!

Forskjellige tilkoblingspunkter

<div class="version-tag">v5.0</div>

‍

Det finnes flere ulike verktøy på markedet i dag for å opprette koblinger som fungerer med webhooks. Noen av de største er: Zapier, Integromat, n8n og Power Automate.

‍

‍

‍

‍

‍

‍

‍

‍

‍