> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/automation-api/automated-task-example-webhook.md).

# Beispiel für automatische Aufgabe - Slack-Kanal- und E-Mail-Benachrichtigungen bei einem Synchronisierungsfehler senden

## Slack-Kanal-Benachrichtigung und E-Mail-Warnung bei Sync-Fehler senden

{% hint style="info" %}
**Wichtige Punkte**

* Der ***VergeOS Task Engine*** ermöglicht es Ihnen, Abläufe zu automatisieren, die durch bestimmte Systembedingungen, Ereignisse oder geplante Zeitpunkte ausgelöst werden. Mithilfe modularer, wiederverwendbarer Komponenten (Tasks, Ereignisse, Zeitpläne und Webhooks) können Sie Automatisierungen ganz einfach an Ihre Umgebung anpassen.
* Das folgende Beispiel zeigt, wie Tasks, Ereignisse und Webhooks zusammenarbeiten, um bei jedem von einem Sync-Vorgang erzeugten Fehler automatisch gleichzeitig Warnungen (Slack-Kanal und E-Mail) zu senden.
  {% endhint %}

## Anwendungsfall

Administratoren eines DR/BC-Dienstanbieters müssen sofort benachrichtigt werden, wenn ein nächtlicher Sync-Job Fehler aufweist. Die frühzeitige Benachrichtigung gibt ihnen Zeit, den Fehler zu untersuchen und eine Behebung zu versuchen, und erhöht die Wahrscheinlichkeit, dass sie den Sync neu starten und innerhalb des verfügbaren Synchronisationsfensters abschließen können.

Das Unternehmen verwendet mehrere redundante Warnsysteme, um Administratoren über kritische Probleme zu informieren: Ein System sendet Warnungen per E-Mail, während ein anderes Nachrichten in einen dedizierten Slack-Kanal postet.

Mithilfe der Komponenten der VergeOS Task Engine können Administratoren sofort in beiden Systemen Warnungen auslösen, wann immer ein wichtiger Sync-Job Fehler meldet. Die Automatisierung besteht aus einem Webhook, zwei Tasks und einem Ereignis. Die folgenden Schritte führen Sie durch die vollständige Konfiguration:

{% hint style="info" %}
**1. Den Webhook konfigurieren**

Der Webhook definiert die Ziel-URL und die vom externen Slack-System erforderliche Authentifizierungsmethode.

***System > Aufgaben-Dashboard > Neuer Webhook***

<img src="/files/e5e73e879a26db89415a0c3e4d0bc16f1f972867" alt="Create webhook" data-size="original">
{% endhint %}

{% hint style="info" %}
**2. Einen Task zum Senden der E-Mail erstellen**

Dieser Task definiert die E-Mail-Warnung, die gesendet wird.

***System > Aufgaben-Dashboard > Neuer Task***

<img src="/files/9c4677cd9f03d67f88af1fee3cf4dda752012e88" alt="Create webhook" data-size="original">
{% endhint %}

{% hint style="info" %}
**3. Einen Task zum Senden des Webhooks erstellen**

Dieser Task definiert die Nachrichten-Nutzlast, die per Webhook an Slack gesendet wird.

***System > Aufgaben-Dashboard > Neuer Task***

<img src="/files/83f4062460a3ff1057775354aa5fec2a8988e9e1" alt="Create Slack webhook task" data-size="original">
{% endhint %}

{% hint style="info" %}
**4. Dem&#x20;*****Slack-Nutzlast senden*****&#x20;Aufgabe**

Durch die Zuweisung eines Ereignisauslösers können wir die Bedingung (einen Sync-Fehler) festlegen, die den Task auslöst.

Von der *Slack-Nutzlast senden* Aufgaben-Dashboard: ***Ereignisauslöser > Neu***

<img src="/files/1f08943c36b240320adacb2a7bdd56b45ce168d7" alt="Assign Event Trigger to Slack Task" data-size="original">
{% endhint %}

{% hint style="info" %}
**5. Dem&#x20;*****'E-Mail-Warnung senden'*****&#x20;Aufgabe**

Wir wenden denselben Ereignisauslöser auf diesen Task an, damit die E-Mail-Warnung ebenfalls gesendet wird, wenn ein Sync-Fehler auftritt.

***System > Aufgaben-Dashboard > Aufgaben >*** wählen Sie den *E-Mail-Warnung senden* Task ***> Ereignisauslöser > Neu***

<img src="/files/03ca2d4b8dcb03bd41e9f75f157a938a4d4a9f66" alt="Assign Event Trigger to Email Task" data-size="original">
{% endhint %}

Diese Automatisierung stellt sicher, dass Administratoren sofort benachrichtigt werden, wenn ein Sync-Job einen Fehler aufweist, sodass sie umgehend handeln können und die beste Chance haben, das Problem zu beheben, bevor sich das Synchronisationsfenster schließt.

{% hint style="success" %}
**Auslöser basierend auf mehreren Objekten**

In diesem Beispiel ist der Auslöser an einen einzelnen ausgehenden Sync gebunden. Wenn derselbe Auslöser für mehrere oder sogar alle ausgehenden Sync-Jobs gelten soll, weisen Sie diesen einen gemeinsamen [Tag](/run-the-platform/system-administration/tags.md) für diese Syncs zu. Anschließend können Sie den Auslöser so konfigurieren, dass er immer dann ausgelöst wird, wenn ein Sync mit diesem Tag einen Fehler erzeugt.
{% endhint %}

## Fehlerbehebung

{% hint style="warning" %}
**Häufige Probleme**

* **Webhook wird nicht ausgelöst**: Vergewissern Sie sich, dass die Webhook-URL korrekt ist und der externe Dienst (Slack) aus Ihrer VergeOS-Umgebung erreichbar ist.
* **E-Mail nicht empfangen**: Überprüfen Sie, ob die SMTP-Einstellungen unter System > Einstellungen > SMTP korrekt konfiguriert sind.
* **Ereignisauslöser wird nicht aktiviert**: Stellen Sie sicher, dass der Auslöser dem richtigen Sync-Objekt zugewiesen ist und der Ereignistyp auf „Fehler“ gesetzt ist.
  {% endhint %}

## Zusätzliche Ressourcen

* [Überblick über die Task Engine](/automate-protect-and-extend/automation/task-engine.md)
* [Webhooks konfigurieren](/automate-protect-and-extend/automation/webhooks.md)
* [Mit Tags arbeiten](/run-the-platform/system-administration/tags.md)
* [SMTP-Konfiguration](/run-the-platform/system-administration/smtp.md)

## Feedback

{% hint style="info" %}
**Brauchen Sie Hilfe?**

Wenn Sie weitere Unterstützung benötigen oder Fragen zu diesem Artikel haben, zögern Sie bitte nicht, sich an das [VergeOS-Support-Team](broken://spaces/RDqjqiAbPZD7nK9rjfqU/pages/8c8d3dd8447f3e6289926e29d315a800b2153b50).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/de/automation-api/automated-task-example-webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
