Configure webhooks

Last updated: August 4, 2026

Du kan konfigurera webhooks för att skicka aviseringar i realtid om händelser i Installer.com till externa system, vilket möjliggör sömlösa integrationer.

Konfigurera en webhook

Navigera till dina Integrations-inställningar i appen.
Välj alternativet att Lägg till ny webhook.
Ange Webhook-URL:en dit Installer.com kommer att skicka händelseaviseringar.
Välj de Händelser som kommer att utlösa webhooks, till exempel "Order skapad" eller "Jobbstatus uppdaterad".
Anpassa Nyttolastens struktur med Handlebars-mallar för att definiera data som skickas med varje avisering.
- Alla mallvärden JSON-escapas automatiskt för att säkerställa korrekt hantering av specialtecken som citattecken och et-tecken i nyttolasten.
- För att inkludera detaljer för flera produktlinjer, använd {{#each}} Handlebars-hjälpfunktionen. Denna itererar genom en lista med objekt, såsom produkter associerade med en beställning.
Till exempel, för att lista produkter i en beställningsnyttolast:
```
{
  "orderId": "{{order.id}}",
  "customerName": "{{order.customer.name}}",
  "products": [
    {{#each order.products}}
    {
      "productId": "{{this.id}}",
      "name": "{{this.name}}",
      "quantity": "{{this.quantity}}"
    }{{/each}}
  ]
}
```
Dessutom, för webhook-händelser som involverar aktörer (t.ex. en installatör eller en kund), kan fältet organizationExternalId exponeras. Detta fält tillhandahåller den externa ID:n för aktörens organisation och inkluderas endast i nyttolasten om aktören tillhör en organisationshierarki där ett externt ID är relevant.
Spara din webhook-konfiguration.

Webhook-uppgiftsstatus

Statusen för en webhook-uppgift bestäms av HTTP-svarskoden som tas emot från den konfigurerade Webhook-URL:en:

Lyckad: En HTTP-statuskod i 2xx-intervallet (t.ex. 200 OK, 201 Created) indikerar att webhook-uppgiften var lyckad.
Försök igen: En HTTP-statuskod i 4xx-intervallet (t.ex. 400 Bad Request, 404 Not Found) eller 5xx-intervallet (t.ex. 500 Internal Server Error, 503 Service Unavailable) kommer att göra att webhook-uppgiften försöks igen.
Misslyckad: Om en webhook-uppgift konsekvent tar emot HTTP-statuskoder som kan försöks igen efter flera försök, kommer den så småningom att markeras som misslyckad.

Relaterade artiklar

Behöver du hjälp? Kontakta Installer.com support.