# 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](https://help.aiaibot.com/robot/connectoren/konfiguration/microsoft-graph-api).

## 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FOd2lmULy1GFVQ4yPs7wU%2Fprojekte-plus-symbol.png?alt=media&#x26;token=9941d613-faf3-446a-be0d-a46c684b4e2a" alt="" data-size="line"> Symbol.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FxydmZuzfeNSLExAZLpYf%2Fconnector-pop3imap-01.png?alt=media&#x26;token=24231de8-3fb4-4857-b213-9299d4cd7641" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FUxRwD4n2dzfCaMNbNhAn%2Fconnector-pop3imap-02.png?alt=media&#x26;token=922a4379-483c-4dc1-b0ee-0f164c0141ae" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F0C0GP0uhDA66Z3obbAAP%2Fconnector-exchange-fetcher-02.png?alt=media&#x26;token=8724e750-0d96-4ffd-970f-c460bc90979e" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FZdIbWDSoWHmk0sjHSHat%2Fconnector-exchange-fetcher-03.png?alt=media&#x26;token=c2684904-ac4e-4a4f-bea4-30236a898d97" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FrAl0hTVwfnFuePyMafyI%2Fconnector-exchange-fetcher-04.png?alt=media&#x26;token=12f2c092-0be0-4b9c-8ee7-6e060ee36e78" 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](https://help.aiaibot.com/robot/workflows/workflow-protokoll) 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FNPps9XmokdhjnZbpeUbc%2Fconnector-exchange-fetcher-05.png?alt=media&#x26;token=7898a5bb-0595-4021-a860-e654be5f5855" 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 %}