Configure webhooks

Last updated: August 4, 2026

Sie können Webhooks konfigurieren, um Echtzeit-Benachrichtigungen über Ereignisse in Installer.com an externe Systeme zu senden und so nahtlose Integrationen zu ermöglichen.

Einen Webhook konfigurieren

Navigieren Sie zu Ihren Integrationen-Einstellungen innerhalb der App.
Wählen Sie die Option Neuen Webhook hinzufügen.
Geben Sie die Webhook-URL ein, an die Installer.com Ereignisbenachrichtigungen senden soll.
Wählen Sie die Ereignisse aus, die den Webhook auslösen, wie z.B. „Auftrag erstellt“ oder „Auftragsstatus aktualisiert“.
Passen Sie die Payload-Struktur mithilfe von Handlebars-Vorlagen an, um die mit jeder Benachrichtigung gesendeten Daten zu definieren.
- Alle Vorlagenwerte werden automatisch JSON-escaped, um die korrekte Handhabung von Sonderzeichen wie Anführungszeichen und Kaufleute-Und in der Payload sicherzustellen.
- Um Details für mehrere Produktlinien einzuschließen, verwenden Sie den {{#each}}-Handlebars-Helfer. Dieser iteriert durch eine Liste von Elementen, wie z.B. Produkte, die einem Auftrag zugeordnet sind.
Um beispielsweise Produkte in einer Auftrags-Payload aufzulisten:
```
{
  "orderId": "{{order.id}}",
  "customerName": "{{order.customer.name}}",
  "products": [
    {{#each order.products}}
    {
      "productId": "{{this.id}}",
      "name": "{{this.name}}",
      "quantity": "{{this.quantity}}"
    }{{/each}}
  ]
}
```
Zusätzlich kann bei Webhook-Ereignissen, die Akteure (z.B. einen Installateur oder einen Kunden) betreffen, das Feld organizationExternalId verfügbar sein. Dieses Feld enthält die externe ID der Organisation des Akteurs und wird nur dann in die Payload aufgenommen, wenn der Akteur zu einer Organisationshierarchie gehört, in der eine externe ID relevant ist.
Speichern Sie Ihre Webhook-Konfiguration.

Webhook-Aufgabenstatus

Der Status einer Webhook-Aufgabe wird durch den HTTP-Antwortcode bestimmt, der von der konfigurierten Webhook-URL empfangen wird:

Erfolgreich: Ein HTTP-Statuscode im 2xx-Bereich (z.B. 200 OK, 201 Created) zeigt an, dass die Webhook-Aufgabe erfolgreich war.
Wiederholen: Ein HTTP-Statuscode im 4xx-Bereich (z.B. 400 Bad Request, 404 Not Found) oder 5xx-Bereich (z.B. 500 Internal Server Error, 503 Service Unavailable) führt dazu, dass die Webhook-Aufgabe wiederholt wird.
Fehlgeschlagen: Wenn eine Webhook-Aufgabe nach mehreren Versuchen wiederholt wiederholbare HTTP-Statuscodes empfängt, wird sie schließlich als fehlgeschlagen markiert.

Configure webhooks

Einen Webhook konfigurieren

Webhook-Aufgabenstatus

Verwandte Artikel