# Webhooks (https://docs.akollo.com/de/connections/webhooks)



Webhooks übertragen Ereignisse zwischen Akollo und anderen Systemen in dem Moment, in dem sie eintreten. Über eingehende Webhooks benachrichtigt ein anderes System Akollo. Über ausgehende Webhooks benachrichtigt Akollo ein anderes System.

<Mermaid
  title="Eingehende und ausgehende Webhooks"
  chart="`sequenceDiagram
participant S as Anderes System
participant A as Akollo
S->>A: Signierte Zustellung an die Empfängeradresse
A->>A: Signatur, Wiederholung und Größe prüfen
A-->>S: Angenommen oder abgelehnt
A->>S: Signiertes Ereignis an den https-Endpunkt
S-->>A: Zustellergebnis, als Versuch protokolliert`"
/>

## Eingehende Webhooks [#eingehende-webhooks]

Unter **Integrations → Inbound** (Eingehend) legen Sie einen Endpunkt an, an den ein Anbieter Webhooks senden kann.

<Steps>
  <Step>
    ### Zweck wählen [#zweck-wählen]

    Wählen Sie unter **Purpose** (Zweck): **Provider webhook**, **Automation trigger** oder **Microsoft Graph lifecycle**.
  </Step>

  <Step>
    ### Prüfverfahren wählen [#prüfverfahren-wählen]

    Wählen Sie unter **Verifier** (Prüfverfahren): **Standard Webhooks**, **Jira (HMAC)**, **Slack (v0 signature)**, **Microsoft Graph (clientState)** oder **GitHub**. Jedes andere Verfahren als Standard Webhooks verlangt das **Provider secret**, also das Geheimnis, das Ihnen der Anbieter gegeben hat.
  </Step>

  <Step>
    ### Verbindung zuordnen (optional) [#verbindung-zuordnen-optional]

    Wählen Sie optional eine aktive Verbindung, zu der der Endpunkt gehört.
  </Step>

  <Step>
    ### Endpunkt anlegen und Angaben sichern [#endpunkt-anlegen-und-angaben-sichern]

    Wählen Sie **Create endpoint**. Die **Receiver URL** (Empfängeradresse) und bei Standard Webhooks das Signaturgeheimnis werden nur einmal angezeigt. Geben Sie die Empfängeradresse an den Anbieter weiter und bewahren Sie das Geheimnis sicher auf.
  </Step>
</Steps>

Die Liste zeigt, wann jeder Endpunkt zuletzt eine Zustellung erhalten hat. Abgelehnte Zustellungen werden nach Grund gezählt (Signatur, Wiederholung oder Größe), ohne die Zustellung selbst anzuzeigen. Ein Endpunkt lässt sich mit Begründung deaktivieren und wieder aktivieren.

## Ausgehende Webhooks [#ausgehende-webhooks]

**Integrations → Webhooks** sendet die Ereignisse dieser Organisation an ein anderes System. Ein Endpunkt hat:

* eine https-Adresse;
* die zu sendenden Ereignistypen;
* die Wahl, ob der vollständige Datensatz oder nur ein Verweis gesendet wird.

Das Signaturgeheimnis wird einmal angezeigt. Die Liste zeigt für jeden Endpunkt Adresse, Ereignisse, Zustand und Zustellerfolg der letzten 24 Stunden.

<Screenshot src="/screens/en/webhooks.webp" alt="Liste ausgehender Webhooks mit zwei Endpunkten, ihren Ereignistypen, den Kennzeichen Enabled und Disabled und einem Begründungsfeld neben Disable und Re-enable" caption="Ausgehende Webhooks: jeder Endpunkt mit Ereignissen und Zustand." />

Die Seite eines Endpunkts zeigt sein Nachrichtenprotokoll mit Filtern und die Zustellversuche jeder Nachricht. Dort können Sie:

* eine oder mehrere Nachrichten erneut senden;
* alles wiederherstellen, was seit einem gewählten Zeitpunkt gesendet wurde, bis zu 30 Tage zurück;
* ein Testereignis senden;
* das Signaturgeheimnis erneuern; das bisherige funktioniert noch 24 Stunden.

Ein fehlschlagender Endpunkt zeigt, seit wann er fehlschlägt und wann er sich selbst deaktiviert. Ein Endpunkt lässt sich mit Begründung deaktivieren und wieder aktivieren; löschen lässt er sich nicht.

<Callout type="info" title="Hinweis">
  In diesem Release ist die ausgehende Zustellung noch nicht eingeschaltet. Die Seiten bieten weder das Anlegen eines Endpunkts noch das Senden eines Testereignisses, das erneute Senden von Nachrichten oder die Wiederherstellung ab einem Zeitpunkt an.
</Callout>

## Häufige Fragen [#häufige-fragen]

<Accordions type="single">
  <Accordion title="Ich habe das Signaturgeheimnis verloren. Kann ich es erneut ansehen?">
    Nein. Signaturgeheimnisse werden nur einmal angezeigt. Bei einem ausgehenden Endpunkt können Sie das Geheimnis erneuern; das bisherige funktioniert noch 24 Stunden.
  </Accordion>

  <Accordion title="Kann ich eine abgelehnte eingehende Zustellung einsehen?">
    Nein. Die Liste zählt abgelehnte Zustellungen nach Grund (Signatur, Wiederholung oder Größe), zeigt die Zustellung selbst aber nicht an.
  </Accordion>

  <Accordion title="Kann ich einen ausgehenden Endpunkt löschen?">
    Nein. Sie können ihn mit Begründung deaktivieren und später wieder aktivieren.
  </Accordion>

  <Accordion title="Wie weit zurück kann ich ausgehende Nachrichten wiederherstellen?">
    Bis zu 30 Tage ab dem gewählten Zeitpunkt. In diesem Release ist die ausgehende Zustellung noch nicht eingeschaltet.
  </Accordion>
</Accordions>

## Verwandte Seiten [#verwandte-seiten]

* [Verbundene Systeme](/de/connections)
* [API und Schlüssel](/de/connections/api)
* [Automatisierung](/de/product-guide/automation)