# Exchange Online

Mit dem Exchange Online-Connector können Sie regelmässig eine Exchange-Mailbox auf neue E-Mails überprüfen. Sobald eine neue E-Mail in der Mailbox erkannt wird, startet der zugehörige Workflow, und die E-Mail kann verarbeitet werden.

## Voraussetzungen

* **Unterstützte Mailboxen**: Es werden ausschließlich Exchange Online-Mailboxen unterstützt. On-Premise-Installationen von Exchange sind nicht kompatibel.
* **Microsoft Graph API**: Der Zugriff auf die Mailbox erfolgt über die Microsoft Graph API. Dafür benötigen Sie einen zuvor eingerichteten [Microsoft Graph API-Connector](/robot/connectoren/konfiguration/microsoft-graph-api.md).

## Erstellen eines Exchange Online-Connectors

Um einen neuen Exchange Online-Connector zu erstellen, wählen Sie den Menüpunkt *Connectoren* und klicken Sie anschliessend auf das <img src="/files/32GhkrdYgbHLeEkg44Lg" alt="" data-size="line"> Symbol.

<figure><img src="/files/CZ5eyvQDL9gV6KBW2glK" alt="" width="221"><figcaption><p>Erstellen eines neuen Connectors</p></figcaption></figure>

Danach vergeben Sie einen Namen und wählen die Option *E-Mail (IMAP / POP3 / Exchange / SMTP)* aus der Auswahlbox aus.

<figure><img src="/files/TriLOVQJ7dBMYVQc166a" alt="" width="459"><figcaption><p>Neuer Exchange Online Connector</p></figcaption></figure>

Im nächsten Schritt wählen Sie die Option Exchange Online.

<figure><img src="/files/rmqWtFZ2mijwjxlTtAbc" alt="" width="306"><figcaption></figcaption></figure>

Danach wählen Sie die Option *E-Mail abrufen* aus, um einen Connector zu konfigurieren der E-Mails aus einer Mailbox abholen kann.

<figure><img src="/files/3XqgA2uLVakmh82UVG4O" alt="" width="203"><figcaption><p>Option E-Mail abrufen</p></figcaption></figure>

Folgende Parameter sind für einen Exchange Online-Connector anzugeben.

<figure><img src="/files/rBzE8qGt5r4nvuSN0W7X" alt="" width="563"><figcaption><p>Parameter eines Exchange Online-Connectors zum Abrfuen von E-Mails</p></figcaption></figure>

### Microsoft Graph API

Wählen Sie einen Microsoft Graph API-Connector aus, mit dem der Zugriff auf die gewünschte Mailbox möglich ist.

{% hint style="info" %}
Um eine Mailbox abzurufen, muss der Microsoft Graph API-Connector mit der Berechtigung `Mail.ReadWrite` erstellt worden sein.
{% endhint %}

### Wiederholte Verarbeitung

Wenn diese Option aktiv ist, werden E-Mails erneut verarbeitet, auch wenn sie schon einmal von einem Workflow bearbeitet wurden.

### Abzurufender Ordner

Hier geben Sie den Ordner an, der laufend überwacht werden soll. Unterordner können mit `/` getrennt angegeben werden, z.B. `Inbox/Incidents`.

### Timeout

Mit dem Parameter *Timeout beim Abrufen* legen Sie fest, wie lange der Abruf der E-Mails maximal dauern darf. Wird diese Zeit überschritten, wird der Abruf abgebrochen.

### Verarbeitung

Mit diesem Parameter legen Sie fest, wie abgerufene E-Mails **am Mailserver** verarbeitet werden. Es stehen drei unterschiedliche Strategien zur Auswahl.

#### Strategie "Als gelesen markieren"

Neue E-Mails werden nach dem erfolgreichen Abrufen und Speichern in der Datenbank als gelesen gekennzeichnet. Jede ungelesene E-Mail wird als noch zu verarbeitende E-Mail angesehen.

#### Strategie "E-Mails löschen"

Neue E-Mails werden nach dem erfolgreichen Abrufen und Speichern in der Datenbank direkt vom Server gelöscht.

#### Strategie "In einen anderen Ordner verschieben"

E-Mails werden nach erfolgreichem Abruf in einen anderen Ordner auf dem Server verschoben. Geben Sie den Ordner an, in dem die E-Mails verschoben werden sollen. Unterordner können mit `/` getrennt angegeben werden, zum Beispiel `Inbox/Processed`.

### Intervall, Anzahl und Aufbewahrungsdauer

Mit dem Parameter *Abrufintervall (Sekunden)* stellen Sie ein, wie oft die Mailbox auf neue Nachrichten geprüft werden soll.

Mit *Anzahl abzurufender E-Mails* legen Sie fest, wie viele neue E-Mails bei einem Durchlauf vom Server abgerufen werden sollen. Liegen am Server mehr Nachrichten als Sie mit diesem Parameter einstellen, werden diese beim nächsten Durchlauf verarbeitet.

E-Mails werden in unserer Datenbank zwischengespeichert. Mit dem Parameter *E-Mail-Speicherdauer* legen Sie fest, nach wie vielen Tagen die E-Mails aus unserer Datenbank gelöscht werden sollen. Solange E-Mails nicht gelöscht sind, können Sie im [Workflow-Protokoll](/robot/workflows/workflow-protokoll.md) heruntergeladen und zur Fehleranalyse verwendet werden.

### Shared-Mailbox abrufen

Mit diesem Connector ist es auch möglich, eine Shared-Mailbox abzurufen. Aktivieren Sie dazu diese Option und geben sie die E-Mail-Adresse der Shared-Mailbox ein.

<figure><img src="/files/MeTjEpMe1HqePaytYSkM" alt="" width="264"><figcaption><p>Aktive Shared-Mailbox Option</p></figcaption></figure>

{% hint style="info" %}
Um eine Shared-Mailbox abzurufen, muss der Microsoft Graph API-Connector mit der Berechtigung `Mail.ReadWrite.Shared` erstellt worden sein.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://help.aiaibot.com/robot/connectoren/aktiv/exchange-online.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.