> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook erstellen

> Webhook in Einstellungen und Verwaltung ohne Code oder API-Aufrufe erstellen.

Sie können Webhook-Abonnements direkt in **Einstellungen und Verwaltung** erstellen und verwalten, ohne Code zu schreiben oder die API aufzurufen.

<Note>
  Um einen vorhandenen Webhook zu bearbeiten, klicken Sie mit der rechten Maustaste auf die Webhook-Zeile in der Liste **Webhooks** und wählen Sie **Bearbeiten**. Das Formular öffnet sich mit allen aktuellen Werten vorausgefüllt.
</Note>

## Schritte

1. Gehen Sie zu **Einstellungen und Verwaltung** > **System design** und wählen Sie die Registerkarte **Webhooks**.

2. Klicken Sie auf **Hinzufügen**.

   ![Neues Webhook-Formular in Einstellungen und Verwaltung -screenshot][img1]

3. Geben Sie einen **Name des Webhooks** ein, um den Webhook zu identifizieren (erforderlich). Maximal 100 Zeichen.

4. Optional können Sie eine **Beschreibung** hinzufügen. Diese wird im Webhooks-Panel angezeigt.

5. **Ereignisse, die diesen Webhook auslösen** (erforderlich).

   Wählen Sie ein oder mehrere Ereignisse aus der Liste **Ereignis hinzufügen**. Jedes ausgewählte Ereignis wird als Tag angezeigt. Um ein Ereignis zu entfernen, wählen Sie **x** auf dem Tag.

   <Tip>
     Sie können auch einen benutzerdefinierten Ereignisnamen direkt in das Feld eingeben und **Enter** drücken.
   </Tip>

6. **Ziel festlegen** (erforderlich).

   Wählen Sie, wohin der Webhook geliefert werden soll:

   * **Externe URL:** Geben Sie die **Endpunkt-URL** ein. Die URL muss HTTPS verwenden und über ein gültiges TLS-Zertifikat verfügen. Der Endpunkt wird beim Speichern validiert - eine nicht erreichbare oder fehlerhafte URL verhindert das Speichern. Wählen Sie **Test senden**, um die Verbindung vor dem Speichern zu überprüfen.
   * **CRMScript:** Wählen Sie ein Skript aus der Liste.

7. **Fehlermeldung** (erforderlich).

   Geben Sie an, wen Sie benachrichtigen möchten, wie diese Personen erreichbar sind und wann die Benachrichtigung gesendet werden soll.

   * **Empfänger:** Fügen Sie CRM-Benutzer hinzu oder geben Sie externe E-Mail-Adressen ein. Empfänger werden als Tags angezeigt.
   * **Benachrichtigen über:** Wählen Sie den Benachrichtigungskanal.
   * **Benachrichtigung auslösen:** Wählen Sie eine oder beide Optionen:
     * **Beim ersten Fehlversuch:** Sendet eine Benachrichtigung, wenn der Webhook zum ersten Mal die Lieferung nicht schafft.
     * **Wenn deaktiviert:** Sendet eine Benachrichtigung, wenn der Webhook nach wiederholten Fehlern automatisch deaktiviert wird.

   ![Webhook-Formular mit konfigurierten Ereignissen, Ziel und Fehlerbenachrichtigung -screenshot][img2]

8. (Optional) Erweitern Sie **Sicherheit und erweiterte Einstellungen**.

   * **Gemeinsames Geheimnis:** Wählen Sie **Generieren**, um einen kryptografisch zufälligen Wert für die Signierung jeder Nutzlast zu erstellen. Das Secret wird nur bei der Erstellung angezeigt - kopieren Sie es sofort. Um es später zu ersetzen, wählen Sie **Regenerieren**.
   * **Benutzerdefinierte Kopfzeilen:** Schlüssel-Wert-Paare, die jedem HTTP POST hinzugefügt werden. Nur für Externe URL-Webhooks verfügbar.
   * **Benutzerdefinierte Eigenschaften:** Zusätzliche Daten, die in jede Nutzlast eingefügt werden.

   ![Abschnitt Sicherheit und erweiterte Einstellungen erweitert -screenshot][img3]

9. (Optional) Schalten Sie den **Aktiv**-Schalter (obere rechte Ecke) aus, um den Webhook im Zustand *Gestoppt* zu speichern.

10. Klicken Sie auf **Speichern**.

    ![Lieferstatus unterhalb des Aktiv-Schalters nach dem Speichern angezeigt -screenshot][img4]

Nach dem Speichern werden Informationen zum Lieferstatus unterhalb des **Aktiv**-Schalters angezeigt. Klicken Sie oben auf **Zurück zu Webhooks**, um zur Liste zurückzukehren.

[img1]: ../../../../media/loc/en/automation/new-webhook-required-fields.png

[img2]: ../../../../media/loc/en/automation/create-webhook-in-ui.png

[img3]: ../../../../media/loc/en/automation/webhook-advanced-settings.png

[img4]: ../../../../media/loc/en/automation/webhook-delivery-status.png


## Related topics

- [Webhooks-Panel](/de/automation/webhook/admin/index.md)
- [Webhook über die API registrieren](/en/automation/webhook/dev/register.md)
- [CRMScript erstellen](/de/customization/macros-and-scripts/admin/create-script.md)