# POP3 / IMAP

Mit dem E-Mail-Connector vom Typ POP3/IMAP können Sie eine Mailbox in regelmässigen Abständen auf neue E-Mails prüfen. Wird in der Mailbox eine neue E-Mail erkannt, startet der zugehörige Workflow und die E-Mail kann verarbeitet werden.

## Voraussetzungen

Damit eine Verbindung zur gewünschten Mailbox hergestellt werden kann, muss diese für das Protokoll POP3 oder IMAP eingerichtet sein. Folgende Informationen sind erforderlich:

* Servername
* Port
* Benutzername der Mailbox
* Passwort der Mailbox
* Nur bei IMAP: Name des Ordners, in dem nach neuen E-Mails gesucht werden soll.

{% hint style="info" %}
Sollte die Mailbox von einer Firewall geschützt sein, muss eine Ausnahmeregel für unsere IP-Adresse eingerichtet werden. Diese erfahren Sie von Ihrem Ansprechpartner bei uns.
{% endhint %}

## Erstellen eines POP3/IMAP-Connectors

Um einen neuen POP3/IMAP-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 POP3 oder IMAP Connector</p></figcaption></figure>

Im nächsten Schritt wählen Sie das Protokoll - **POP3** oder **IMAP** - mit dem sich Robot mit der Mailbox verbinden soll.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F1SzUqfTmKj5wUoqSPAVQ%2Fconnector-pop3imap-03.png?alt=media&#x26;token=76cc0658-4d71-4ab1-9896-80cec554c0ab" alt="" width="335"><figcaption></figcaption></figure>

## POP3 Connector

Der POP3-Connector prüft in regelmässigen Abständen, ob es am Server ungelesene E-Mails gibt. Befinden sich ungelesene E-Mails in der Mailbox, werden diese abgerufen und der Status wird auf **gelesen** gesetzt. Anhand des Status **ungelesen** bzw. **gelesen** wird die Entscheidung getroffen, ob die E-Mail zu verarbeiten ist oder nicht.

Für die Einrichtung eines POP3 Connectors werden folgende Daten benötigt:

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F8W07zVM2jixeuRUoZyY8%2Fconnector-pop3imap-04.png?alt=media&#x26;token=2ada422f-030e-42a8-bc16-0bb81aa49464" alt="" width="563"><figcaption><p>Parameter für POP3-Connector</p></figcaption></figure>

### Wiederholte Verarbeitung

Wenn diese Option aktiv ist, werden E-Mails erneut verarbeitet, wenn Sie am Server wieder auf den Status **ungelesen** gesetzt werden.

### Server und Port

Geben Sie den Namen des Servers sowie den Port ein. Typische Ports für POP3 sind 110 oder 995.

### Benutzer und Passwort

Hier geben Sie den Benutzernamen und das Passwort der Mailbox ein. Es ist nicht möglich, das Passwort anzuzeigen.

{% hint style="info" %}
Das Passwort wird mit einer zusätzlichen Verschlüsselung in unserer Datenbank abgelegt.
{% endhint %}

### Verschlüsselung

Der Zugriff auf die Mailbox kann unverschlüsselt erfolgen. Wir raten eindringlich davon ab, diese Option zu nutzen.

Der gesicherte Zugriff kann entweder über SSL oder TLS erfolgen. Wählen Sie die entsprechende Option aus, die vom Server unterstützt wird.

### Timeouts

Das *Verbindungs-Timeout* gibt an, wie lange der Aufbau der Verbindung zum Mailserver maximal dauern darf. Das *Abruf-Timeout* besagt, wie lange der Abruf von E-Mails maximal dauern darf. Bei Überschreitung der Timeouts wird dies mit einer entsprechenden Meldung im Protokoll festgehalten.

### 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.

E-Mails werden in unserer Datenbank zwischengespeichert. Mit dem Parameter *Aufbewahrungsdauer (Tage)* 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.

{% hint style="info" %}
Der POP3-Connector löscht keine E-Mails in der Mailbox am Server.
{% endhint %}

## IMAP Connector

Der IMAP-Connector überprüft regelmässig, ob neue E-Mails auf dem Server vorliegen, die verarbeitet werden sollen. Im Vergleich zum POP3-Protokoll bietet IMAP mehr Flexibilität beim Auffinden neuer E-Mails. Der Hauptunterschied besteht darin, dass Sie bei IMAP einen bestimmten Ordner auf dem Mailserver angeben müssen, der überwacht werden soll. Es gibt drei Strategien, um neue E-Mails zu erkennen, die Sie mit dem Parameter [*Verarbeitung*](#verarbeitung) auswählen.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FrYhcgb8z9w4vaemfAa0L%2Fconnector-pop3imap-05.png?alt=media&#x26;token=2a5bfb5f-e2c7-4bfd-bb73-4ea9181e8fcd" alt="" width="563"><figcaption><p>Parameter für IMAP-Connector</p></figcaption></figure>

### Wiederholte Verarbeitung

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

### Server und Port

Geben Sie den Namen des Servers sowie den Port ein. Typische Ports für IMAP sind 143 oder 993.

### Benutzer und Passwort

Hier geben Sie den Benutzernamen und das Passwort der Mailbox ein. Es ist nicht möglich, das Passwort anzuzeigen.

{% hint style="info" %}
Das Passwort wird mit einer zusätzlichen Verschlüsselung in unserer Datenbank abgelegt.
{% endhint %}

### Verschlüsselung

Der Zugriff auf die Mailbox kann unverschlüsselt erfolgen. Wir raten eindringlich davon ab, diese Option zu nutzen.

Der gesicherte Zugriff kann entweder über SSL oder TLS erfolgen. Wählen Sie die entsprechende Option aus, die vom Server unterstützt wird.

### Timeouts

Das *Verbindungs-Timeout* gibt an, wie lange der Aufbau der Verbindung zum Mailserver maximal dauern darf. Das *Abruf-Timeout* besagt, wie lange der Abruf von E-Mails maximal dauern darf. Bei Überschreitung der Timeouts wird dies mit einer entsprechenden Meldung im Protokoll festgehalten.

### Abzurufender Ordner

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

### 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 *Aufbewahrungsdauer (Tage)* 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.