Configure webhooks

Last updated: August 4, 2026

Du kan konfigurere webhooks for å sende sanntidsvarsler om hendelser i Installer.com til eksterne systemer, noe som muliggjør sømløse integrasjoner.

Konfigurer en webhook

Naviger til Integrasjoner-innstillingene dine i appen.
Velg alternativet for å Legg til ny webhook.
Skriv inn Webhook-URL-en der Installer.com vil sende hendelsesvarsler.
Velg Hendelsene som vil utløse webhooken, for eksempel "Oppdrag opprettet" eller "Jobbstatus oppdatert".
Tilpass Nyttelast-strukturen ved hjelp av Handlebars-maler for å definere dataene som sendes med hvert varsel.
- Alle malverdier blir automatisk JSON-escapet for å sikre korrekt håndtering av spesialtegn som anførselstegn og &-tegn i nyttelasten.
- For å inkludere detaljer for flere produktlinjer, bruk {{#each}} Handlebars-hjelperen. Denne itererer gjennom en liste med elementer, for eksempel produkter knyttet til et oppdrag.
For eksempel, for å liste produkter i en oppdragsnyttelast:
```
{
  "orderId": "{{order.id}}",
  "customerName": "{{order.customer.name}}",
  "products": [
    {{#each order.products}}
    {
      "productId": "{{this.id}}",
      "name": "{{this.name}}",
      "quantity": "{{this.quantity}}"
    }{{/each}}
  ]
}
```
I tillegg, for webhook-hendelser som involverer aktører (f.eks. en installatør eller en kunde), kan feltet organizationExternalId bli eksponert. Dette feltet gir den eksterne ID-en til aktørens organisasjon og inkluderes kun i nyttelasten hvis aktøren tilhører et organisasjonshierarki der en ekstern ID er relevant.
Lagre webhook-konfigurasjonen din.

Statusen for en webhook-oppgave bestemmes av HTTP-svarkoden mottatt fra den konfigurerte Webhook-URL-en:

Vellykket: En HTTP-statuskode i 2xx-området (f.eks. 200 OK, 201 Created) indikerer at webhook-oppgaven var vellykket.
Forsøk på nytt: En HTTP-statuskode i 4xx-området (f.eks. 400 Bad Request, 404 Not Found) eller 5xx-området (f.eks. 500 Internal Server Error, 503 Service Unavailable) vil føre til at webhook-oppgaven blir forsøkt på nytt.
Mislyktes: Hvis en webhook-oppgave konsekvent mottar HTTP-statuskoder som kan forsøkes på nytt etter flere forsøk, vil den til slutt bli markert som mislyktes.

Trenger du hjelp? Kontakt Installer.com support.