Webhooks

Vad är en Webhook?

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

‍

En webhook är en mekanism för att skicka automatiska meddelanden eller data från en webbapplikation till en annan i realtid. Istället för att en klient behöver fråga en server upprepade gånger efter uppdateringar eller information, kan servern skicka data till klienten direkt när det finns något nytt att rapportera.

I praktiken fungerar en webhook så att en klient (oftast en webbserver) registrerar en URL hos en annan server (oftast en webbtjänst). När en händelse inträffar som klienten är intresserad av, skickar den första servern ett HTTP-meddelande till den URL som angivits. Detta meddelande innehåller oftast relevant data eller information om händelsen som just inträffat. Den andra servern kan då använda denna data för att vidta lämpliga åtgärder eller uppdatera sig själv i enlighet med händelsen.

Webhooks används ofta för att integrera olika webbtjänster och automatisera processer mellan dem, såsom att skicka aviseringar från en app till en annan, uppdatera databaser när nya data finns tillgängliga, eller att samordna olika delar av en större systemarkitektur.

‍

Sätta upp en webhook-koppling i Geometra

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

‍

För att koppla upp ett projekt att skicka sin data via en webhook till din mottagande tjänst eller applikation behöver du en slutpunkts-URL. Detta är adressen dit du vill att Geometra ska kontinuerligt skicka data från projektet. Datan skickas i real-tid och behöver tas om hand om på mottagande sida av dig.

I projektvyn kan du klistra in adressen till en slutpunkt dit du vill skicka datan. Varje gång du sedan öppnar projektet kommer dataflödet att påbörja en ”project_sync” som ser till att du alltid får en uppdaterad kopia innan du behöver jobba.

Meddlandet ”project_sync” innehåller all information som finns i projektet.

Skapa, ändra och ta bort kalkyler

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

‍

Det finns tre meddelanden som avser kalkyler: ”create_estimate”, “update_estimate” och “delete_estimate”.

Dessa meddelanden innehåller all information om själva kalkylen, exv. Anbudskalkylen som skapas per automatik i varje projekt.

‍

Skapa, ändra och ta bort objekt

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

‍

Det finns tre meddelande som avser objekt: ”create_object”, ”update_object” och “delete_object”.

Dessa meddelanden innehåller all information om enskilda objekt. När du skapar ett objekt skickas meddelandet med alla uträknade värden och utseende parametrar. Dock skickas inga rader för objektet, de skickas i separata meddelanden.

‍

Skapa, ändra och ta bort rader

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

‍

Det finns tre meddelande som avser data för rader i Geometra: ”create _row”, ”update_row” och “delete_row”.

Dessa meddelande innehåller all information från enskilda rader. När du lägger till en rad skickas meddelandet med all information som finns för att skapa den raden. Uppdateringar till raden skickar bara en referens om vilken rad (ID) och vilket värde som ändrats, t.ex. material.

‍

Automatisering

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

‍

Syftet med att göra en webhook-koppling för ditt projekt i Geometra är att du slipper manuellt exportera din data till Excel, Sheets eller andra kalkylverktyg. Du berättar helt enkelt vad du vill alltid ska vara uppdaterat med information från Geometra.

Finns inte möjligheten att ta emot data via Webhook i ditt kalkylprogram idag rekommenderar vi att du kontaktar din leverantör för att se över ev. lösningar. Att koppla sig mot Geometras webhook är kostnadsfritt och inget som din leverantör behöver betala för att få tillgång till. Vi hjälper gärna till, så hör av dig!

Olika anslutningspunkter

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

‍

Det finns flertal olika verktyg på marknaden idag för att skapa kopplingar som fungerar med webhooks. Några av de största är: Zapier, Make, N8N och PowerAutomate.

‍

‍

‍

‍

‍

‍

‍

‍

‍