# Fehlerbehebung

> Die häufigsten Probleme unter Organisation › Einstellungen › Entwickler › Webhooks, geordnet nach dem, was du beobachtest – jeder Abschnitt nennt die Ursache und den nächsten Schritt.

Wie du einen Webhook einrichtest, testest und aktivierst, steht auf den anderen Seiten unter [Webhooks](/organisation/einstellungen/entwickler/webhooks).

## Der Menüpunkt „Webhooks“ fehlt {#menuepunkt-fehlt}

Deiner Benutzerrolle fehlt der Zugriff auf die **Einstellungen** oder auf den Bereich **Entwickler › Webhooks**. Eine Person mit Administrator-Rolle kann das unter **Organisation › Einstellungen › Team & Rollen › Benutzerrollen** freigeben. Zum Ansehen genügt **Nur lesen**, zum Anlegen und Ändern **Lesen + Bearbeiten**.

## Es lässt sich kein weiterer Webhook anlegen {#kontingent-erreicht}

Euer Tarif begrenzt die Zahl der Webhooks, und das Kontingent ist ausgeschöpft. Ein Klick auf den **+**-Knopf in der Liste öffnet dann statt der Seite **Neuer Webhook** das Fenster **Webhook-Kontingent** mit der Obergrenze. Deaktivierte Webhooks zählen mit. Erst Löschen gibt einen Platz frei. Für mehr Webhooks ist ein Tarifwechsel nötig.

Steht im Fenster stattdessen „Das Tarif-Kontingent konnte nicht ermittelt werden. Bitte versuche es später erneut.“, versuche es etwas später noch einmal.

## Die URL wird nicht angenommen {#url-abgelehnt}

Drei Gründe kommen infrage:

- Die Adresse beginnt nicht mit `https://`. `http://` reicht nicht.
- Sie zeigt auf eine interne Adresse, also `localhost` oder eine private IP-Adresse. Das Ziel muss aus dem Internet erreichbar sein.
- Sie zeigt auf die i-Planner-API selbst (`api.i-planner.app` oder `api.i-planner.de`). Das ist als Endlosschleifen-Schutz gesperrt. Ein Schreibzugriff auf die API würde genau das Event auslösen, das der Webhook abonniert hat.

Fehlt `https://` oder zeigt die Adresse auf die i-Planner-API, meldet die Maske direkt am Feld **URL** „URL muss mit https:// beginnen und darf nicht auf das iPlanner-API (api.i-planner.app/.de) zeigen — Endlosschleifen-Schutz.“ Die Adresse wird dann nicht gespeichert. Lehnt i-Planner eine API-Adresse erst beim Speichern ab, erscheint stattdessen das Fenster **URL nicht erlaubt**.

## GET oder DELETE lassen sich als Methode nicht auswählen {#get-delete}

Die Signatur unterschreibt den Inhalt des Requests. GET und DELETE haben keinen Body, den man unterschreiben könnte. Zur Auswahl stehen deshalb nur **POST**, **PUT** und **PATCH**.

## Bei den Header-Werten steht nur `***` {#header-verdeckt}

i-Planner blendet Header-Werte beim Laden der Seite grundsätzlich aus, weil sie Zugangsdaten enthalten können. Der gespeicherte Wert ist unverändert vorhanden und wird weiterhin mitgesendet. Lässt du `***` stehen, bleibt er erhalten. Erst wenn du das Feld überschreibst, ersetzt der neue Wert den alten.

## Das Signing-Secret ist verloren {#secret-verloren}

Öffne den Webhook über **Organisation › Einstellungen › Entwickler › Webhooks** und **Bearbeiten**. Klicke unter **HTTP-Signatur** auf **Secret anzeigen**. i-Planner zeigt das aktuelle Signing-Secret erneut an, und du kannst es mit **Kopieren** übernehmen. Dafür braucht deine Benutzerrolle **Lesen + Bearbeiten**.

## Der Test bekommt eine Weiterleitung (301/302) zurück {#weiterleitung}

i-Planner folgt Weiterleitungen bewusst nicht. Geprüft und angesprochen wird nur die eingetragene Adresse. Trage die endgültige Ziel-URL direkt unter **HTTP › URL** ein.

## Der Schalter „Aktiv“ lässt sich nicht einschalten {#aktiv-gesperrt}

Ein Webhook lässt sich erst aktivieren, wenn für seine aktuelle **URL** und HTTP-Konfiguration ein erfolgreicher Test gespeichert ist. Bei einem neuen Webhook ist der Schalter außerdem gesperrt, bis **Name** und **URL** ausgefüllt sind und der Webhook angelegt ist. Sende im Bereich **Webhook testen** mit **Test senden** einen Test. Ist er erfolgreich, kannst du **Aktiv** unter **Stammdaten** einschalten. Einzelheiten stehen unter [Webhook aktivieren](/organisation/einstellungen/entwickler/webhooks/testen-und-aktivieren#webhook-aktivieren).

## Der Punkt vor dem Webhook ist gelb {#punkt-gelb}

Ist der Punkt gelb, ist der Webhook aktiv, hat aber keine Events eingerichtet. Deshalb wird er nie ausgelöst. Öffne den Webhook über **Organisation › Einstellungen › Entwickler › Webhooks** und **Bearbeiten**. Lege dann im Bereich **Events** mindestens einen Eventbereich mit einer Aktion an. Wie das geht, steht unter [Events auswählen](/organisation/einstellungen/entwickler/webhooks/einrichten#events-auswaehlen).

## Der Webhook feuert nicht {#feuert-nicht}

Prüfe der Reihe nach:

1. Ist der Webhook eingeschaltet? Ein roter Punkt in der Liste unter **Organisation › Einstellungen › Entwickler › Webhooks** heißt inaktiv. Ein neuer Webhook bleibt inaktiv, bis du ihn nach einem erfolgreichen Test unter **Stammdaten** mit **Aktiv** einschaltest.
2. Hat er **Events**? Ohne eingerichteten Eventbereich passiert nichts. In der Liste erkennst du das am gelben Punkt.
3. Welche **Quellen** sind eingeschaltet? Ist nur **REST-API** eingeschaltet, lösen Änderungen aus der Oberfläche nichts aus, und umgekehrt.
4. Sende einen Test (**Webhook testen › Test senden**), um zu sehen, ob die Adresse überhaupt antwortet.

## Der Webhook ist plötzlich inaktiv {#ploetzlich-inaktiv}

Entweder hat die **Auto-Deaktivierung** gegriffen. Nach der eingestellten Zahl aufeinanderfolgender Fehler schaltet i-Planner den Webhook selbst ab. Du findest die Einstellung unter **Erweitert**, mit 0 schaltest du sie aus. Oder jemand hat ihn über **Deaktivieren** oder den Schalter **Aktiv** pausiert. Dann schickt i-Planner die E-Mail „Webhook deaktiviert“ an diese Person, an alle Inhaber und an die Adressen unter **E-Mail-Benachrichtigung**.

## Weitere Themen {#weitere-themen}

- [Webhook einrichten](/organisation/einstellungen/entwickler/webhooks/einrichten): URL, Events, Quellen, Header und Signatur.
- [Testen und aktivieren](/organisation/einstellungen/entwickler/webhooks/testen-und-aktivieren): einen Test senden und den Webhook einschalten.
- [Webhooks](/organisation/einstellungen/entwickler/webhooks/uebersicht): die Webhook-Liste, pausieren, kopieren und löschen.
- [Entwickler › Fehlerbehebung](/organisation/einstellungen/entwickler/fehlerbehebung): wenn API-Aufrufe abgelehnt werden oder die Gruppe **Entwickler** fehlt.
- [Audit-Log](/organisation/audit-log): jede Zustellung im Protokoll **Webhooks**, filterbar nach **Erfolg** und **Fehlgeschlagen**.