Bearbeiten, drehen, deaktivieren oder löschen Sie einen Webhook

Ändern Sie die URL, den Namen oder die Ereignisse eines Notiondesk-Webhook-Endpunkts, rotieren Sie dessen Signaturgeheimnis, deaktivieren oder aktivieren Sie ihn oder löschen Sie ihn.

3 Min. Lesezeit

Sie können einen Endpunkt jederzeit von seiner Seite aus ändern: seine URL, seinen Namen oder seine Ereignisse bearbeiten, sein Signaturgeheimnis ändern, ihn für eine Weile deaktivieren oder ihn löschen.

Schnellzugriff: Gehen Sie zu Einstellungen > Entwickler > Webhooks und klicken Sie auf den Endpunkt. Bearbeiten Sie ihn und klicken Sie auf Änderungen speichern oder verwenden Sie „Weitere Aktionen “ ( … ), um ihn zu deaktivieren oder zu löschen.

Bevor Sie beginnen

Sie sind der Inhaber des Arbeitsbereichs oder ein Administrator. Andere Rollen können die Webhooks-Seite nicht öffnen.

Bearbeiten Sie einen Endpunkt

  1. Gehen Sie zu Einstellungen > Entwickler > Webhooks und klicken Sie auf den Endpunkt.
  1. Ändern Sie die URL oder den Namen .
  1. Klicken Sie unter „Veranstaltungen“ auf „Veranstaltung hinzufügen“ , um weitere Veranstaltungen hinzuzufügen, oder auf das Kreuz neben einer Veranstaltung, um sie zu entfernen. Behalten Sie mindestens eine Veranstaltung bei.
  1. Klicken Sie auf „Änderungen speichern“ .

Neue Ereignisse verwenden die aktualisierten Einstellungen. Wenn Sie die URL ändern, beginnt die Fehlerzählung von vorn, und bereits geplante Wiederholungsversuche werden an die neue URL weitergeleitet.

Drehen Sie das Signaturgeheimnis

Drehen Sie das Geheimnis um, falls es durchgesickert sein sollte oder falls Sie es verloren haben.

  1. Klicken Sie auf der Endpunktseite unter „Signaturgeheimnis“ auf „Drehen“ .
  1. Zum Bestätigen auf Drehen klicken.
  1. Klicken Sie auf Kopieren , speichern Sie das neue Geheimnis auf Ihrem Server und klicken Sie dann auf Ich habe es gespeichert .
Das alte Geheimnis ist sofort nicht mehr gültig. Jede Anfrage, die nach der Rotation gesendet wird, einschließlich Wiederholungsversuchen, wird mit dem neuen Geheimnis signiert. Aktualisieren Sie daher gleichzeitig Ihren Server.

Überprüfen Sie, ob ein Webhook von Notiondesk stammt. Dies zeigt, wie Ihr Server das Geheimnis verwendet.

Deaktivieren oder Aktivieren eines Endpunkts

Deaktivieren Sie einen Endpunkt, um das Senden von Ereignissen zu stoppen, ohne ihn zu löschen, beispielsweise während Sie an Ihrem Server arbeiten.

  1. Klicken Sie auf der Endpunktseite auf Weitere Aktionen ( ... ).
  1. Klicken Sie auf Deaktivieren .

Der Endpunkt wird als deaktiviert angezeigt. Solange er deaktiviert ist:

  • Es empfängt keine Ereignisse. Ereignisse, die in der Zwischenzeit eintreten, werden nicht gespeichert und auch nach erneuter Aktivierung nicht gesendet.
  • Bereits geplante Wiederholungsversuche werden abgebrochen.
  • Sie können weiterhin auf „Testereignis senden“ klicken.

Um es wieder zu aktivieren, klicken Sie auf „Weitere Aktionen“ ( … ), dann auf „Aktivieren“ . Es empfängt wieder neue Ereignisse, und die Fehlerzählung beginnt von neuem.

Wenn der Endpunkt als „Pausiert“ angezeigt wird, hat Notiondesk ihn nach wiederholten Fehlern deaktiviert. Klicken Sie auf „Fortsetzen“, sobald Ihr Server wieder funktioniert. Die Überprüfung der Webhook-Übermittlungen und die Behebung von Fehlern erklären, warum Endpunkte pausiert werden.

Einen Endpunkt löschen

  1. Klicken Sie auf der Endpunktseite auf Weitere Aktionen ( ... ).
  1. Klicken Sie auf Löschen .
  1. Klicken Sie auf „Löschen“ , um zu bestätigen.
Das Löschen kann nicht rückgängig gemacht werden. Das Zustellungsprotokoll des Endpunkts wird dabei gelöscht, und in der Warteschlange befindliche Ereignisse werden nicht gesendet.

Häufig gestellte Fragen

Gehen Ereignisse verloren, wenn ein Endpunkt deaktiviert ist?

Ja. Ereignisse, die eintreten, während die Funktion deaktiviert ist, werden niemals gesendet. Wenn Sie nur die URL oder die Ereignisse ändern müssen, bearbeiten Sie stattdessen den Endpunkt.

Kann ich das alte Signaturgeheimnis nach der Drehung sehen?

Nein. Jedes Geheimnis wird nur einmal angezeigt, wenn Sie den Endpunkt hinzufügen oder das Geheimnis ändern. Auf der Endpunktseite werden nur die ersten Zeichen angezeigt.

Hat die Änderung der Ereignisse Auswirkungen auf bereits erfolgte Lieferungen?

Nein. Vergangene Lieferungen bleiben unter „Letzte Lieferungen“ erhalten . Nur Ereignisse, die nach dem Speichern stattfinden, werden in der neuen Liste verwendet.

Kann ich einen gelöschten Endpunkt wiederherstellen?

Nein. Fügen Sie einen neuen Endpunkt mit derselben URL und denselben Ereignissen hinzu. Dieser erhält ein neues Signaturgeheimnis.

Verwandte Artikel

War diese Seite hilfreich?

Still need help? Ask us