> For the complete documentation index, see [llms.txt](https://help.aiaibot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aiaibot.com/robot/connectoren/aktiv/exchange-online.md).

# 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 %}