Webhook 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.
Schritte
Gehen Sie zu Einstellungen und Verwaltung > System design und wählen Sie die Registerkarte Webhooks.
Klicken Sie auf Hinzufügen.
Geben Sie einen Name des Webhooks ein, um den Webhook zu identifizieren (erforderlich). Maximal 100 Zeichen.
Optional können Sie eine Beschreibung hinzufügen. Diese wird im Webhooks-Panel angezeigt.
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.
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.
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.
(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.
(Optional) Schalten Sie den Aktiv-Schalter (obere rechte Ecke) aus, um den Webhook im Zustand Gestoppt zu speichern.
Klicken Sie auf Speichern.
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.