# IMAP

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/imap/

_Benötigt Symcon >= 2.2_

Das IMAP-Modul kann über die Konfigurationsseite innerhalb des [Objektbaums](../components/management-console.md) der [Verwaltungskonsole](../components/management-console.md) konfiguriert werden. Die Parameter für Host und Port können der Anleitung des jeweiligen Mail-Providers entnommen werden. Der Benutzername und das Passwort sind die Logindaten des E-Mail Accounts.

> **Achtung:** Seit Oktober 2022 wird die Verbindung zu Microsoft 365 (outlook.office365.com) nicht mehr unterstützt, da Microsoft nur noch OAuth2 als Authentifizierung erlaubt.

Damit die E-Mails in der Visualisierung angezeigt werden, muss das Intervall eingestellt werden. Dieses bestimmt die zyklische Abfrage des Posteingangs des Postfachs. Dabei werden nur die Betreffzeilen abgefragt. Die komplette E-Mail wird erst geladen, wenn die Visualisierung diese anfordert.

Über die Variable "Letzte Nachricht" kann ermittelt werden, ob und wann neue Mails eingetroffen sind. Falls keine E-Mails im Postfach sind, hat die Variable den Wert 0. Die Variable "Ungelesene Nachrichten" gibt die Anzahl der ungelesen Nachrichten zurück.

![IMAP Konfiguration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/benachrichtigungen/imap/a0df9e66e1-1790424938/imap-config.png)

| Eigenschaft               | Bedeutung                                                                                                                                       |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Host                      | Servername oder IP zum Mail-Provider                                                                                                            |
| Port                      | Port, auf dem der Server arbeitet                                                                                                               |
| Benutze SSL               | Gibt an, ob SSL genutzt werden soll                                                                                                             |
| Überprüfe Peer            | Verifiziere, dass das SSL Zertifikat des Hosts korrekt ist (nur sichtbar falls Benutze SSL aktiv ist)                                           |
| Überprüfe Host            | Verifiziere, dass die Host URL aus dem SSL Zertifikat mit dem Host aus der Eigenschaft übereinstimmt (nur sichtbar falls Benutze SSL aktiv ist) |
| Benutze Authentifizierung | Gibt an, ob ein Benutzername/Passwort erforderlich ist                                                                                          |
| Benutzername              | Benutzername                                                                                                                                    |
| Passwort                  | Passwort                                                                                                                                        |
| Intervall                 | Anzahl Sekunden, in der das Postfach abgefragt wird                                                                                             |

> **Hinweis:** Eine Übersicht zu Host, Port und Authentifizierung für viele Provider kann hier gefunden werden: [Tabelle](https://www.arclab.com/en/kb/email/list-of-smtp-and-imap-servers-mailserver-list.html)

## IMAP_DeleteMail

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/imap/imap-deletemail/

`bool IMAP_DeleteMail(int $InstanzID, string $UID)`

_Benötigt Symcon >= 5.0_

löscht eine Mail mit einer bestimmten E-Mail(UID)

**Parameter**

- `$InstanzID` (int): ID der IMAP-Instanz
- `$UID` (string): UID der zu löschenden E-Mail

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

UID der zu löschenden E-Mail

**Beispiel**

```php
// Löscht die Mail mit der E-Mail(UID) 1234
IMAP_DeleteMail(12345, "1234"));
```

## IMAP_GetCachedMails

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/imap/imap-getcachedmails/

`array IMAP_GetCachedMails(int $InstanzID)`

_Benötigt Symcon >= 2.2_

gibt ein Array zu den gecachten E-Mails zurück

**Parameter**

- `$InstanzID` (int): ID der IMAP-Instanz

**Rückgabewert** (array): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis ein Array mit Daten zu den gecacheten E-Mails, andernfalls ein Boolean mit dem Wert __FALSE__.

ID der IMAP-Instanz

**Beispiel**

```php
print_r(IMAP_GetCachedMails(12345));

/* liefert z.B.:
Array
(
    [0] => Array
    (
        [Date] => 1295756412
        [Flags] => SEEN
        [Recipient] => recipient@test.test
        [SenderAddress] => sender@test.test
        [SenderName] => Test Sender
        [Subject] => 3 2 1 Test
        [UID] => 1234
    )
)
*/
```

## IMAP_GetMailEx

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/imap/imap-getmailex/

`array IMAP_GetMailEx(int $InstanzID, string $UID)`

_Benötigt Symcon >= 2.2_

liefert ein Array mit Informationen zu einer bestimmten E-Mail(UID) wieder

**Parameter**

- `$InstanzID` (int): ID der IMAP-Instanz
- `$UID` (string): UID der zu ladenden E-Mail

**Rückgabewert** (array): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis ein Array mit Daten zu den gecacheten E-Mails, andernfalls ein Boolean mit dem Wert __FALSE__.

UID der zu ladenden E-Mail

**Beispiel**

```php
print_r(IMAP_GetMailEx(12345, "1234"));

/* liefert z.B.:
Array
(
    [ContentType] => text/plain
    [Date] => 1295756412
    [Flags] => SEEN
    [Recipient] => ips@test.test
    [SenderAddress] => sender@test.test
    [SenderName] => Test Sender
    [Subject] => 3 2 1 Test
    [Text] => This is a test!
    [UID] => 1234
)
*/
```