# SMTP
> 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/smtp/
_Benötigt Symcon >= 2.2_
SMTP ist ein Modul von IP-Symcon, welches E-Mails verschicken kann. Das Modul wird als Instanz in IP-Symcon eingerichtet. Es ist unter Hersteller "None" und "E-Mail senden (SMTP)" zu finden. Der Tabelle können die einzelnen Eigenschaften entnommen werden.
> **Hinweis:** Um an eine andere oder mehrere E-Mail Adressen eine Nachricht zu senden muss die Funktion [SMTP_SendMailEx](smtp.md) genutzt werden.
> **Hinweis:** Die Emails können nicht speziell formatiert werden. /n /r sind funktional aber jegliche Formatierung wie z.B. bold, kursiv etc funktionieren nicht. Dazu muss z.B. dann ein PHPMailer genutzt werden.
| Eigenschaft | Bedeutung |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Host | Servername oder IP zum Mail-Provider |
| Port | Port, auf dem der Server arbeitet |
| SSL | Gibt an, ob SSL genutzt werden soll |
| Authentifizierung | Gibt an, ob ein Benutzername/Passwort erforderlich ist |
| Benutzername | Benutzername (Details gibt es beim Mail-Provider) |
| Passwort | Passwort |
| Absender-Name | Der Name, der beim Empfänger sichtbar ist |
| Absender-Adresse | Die Adresse, die beim Empfänger sichtbar ist. Je nach Provider muss die Absender-Adresse der eigenen Adresse entsprechen. |
| Empfänger | Nur erforderlich für die [SMTP_SendMail](smtp.md) Funktion, die automatisch an den Empfänger dieses Feldes sendet. |
> **Hinweis:** Eine Übersicht zu Host, Port und Authentifizierung für viele Provider können hier eingesehen werden: [Tabelle](https://www.arclab.com/en/kb/email/list-of-smtp-and-imap-servers-mailserver-list.html)
### Beispiel mit Gmail
GoogleMail lässt einen direkten Zugriff mit dem Benutzernamen und Passwort nicht ohne weitere Einstellung zu. Bei diesen Einstellungen kommt es darauf an, ob man eine Zwei-Faktor Authentifizierung aktiviert hat.
#### Ohne Zwei-Faktor Authentifizierung
Für die Nutzung ohne Zwei-Faktor Authentifizierung muss in der Verwaltung des Google Kontos unter "Sicherheit" der "Zugriff durch weniger sichere Apps" aktiviert werden. Ein Direktlink wäre [https://myaccount.google.com/lesssecureapps](https://myaccount.google.com/lesssecureapps) .
Wenn der Zugriff aktiviert ist, sieht es wie folgt aus. Es kann sich nun mit Benutzername und Passwort eingeloggt werden.
#### Mit Zwei-Faktor Authentifizierung
Bei der Nutzung mit Zwei-Faktor Authentifizierung muss in der Verwaltung des Google Kontos unter "Sicherheit" im Abschnitt "Bei Google anmelden" ein App-Passwort vergeben werden.
Hier auf die Zeile "App-Passwörter" klicken.
In der Überischt kann ein neues Passwort mit einem individuellen Namen generiert werden.
Das generierte Passwort muss dann in IP-Symcon eingetragen werden.
## SMTP_SendMail
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmail/
`bool SMTP_SendMail(int $InstanzID, string $Betreff, string $Inhalt)`
_Benötigt Symcon >= 2.2_
versendet eine E-Mail an die Standardadresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
**Beispiel**
```php
SMTP_SendMail(12345, "Alarm!", "Die Heizung ist ausgefallen!");
```
## SMTP_SendMailAttachment
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmailattachment/
`bool SMTP_SendMailAttachment(int $InstanzID, string $Betreff, string $Inhalt, string $Dateipfad)`
_Benötigt Symcon >= 2.2_
versendet eine E-Mail mit Anhang an die Standardadresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
- `$Dateipfad` (string): Pfad zur Datei
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
Pfad zur Datei
**Beispiel**
```php
SMTP_SendMailAttachment(12345, "Alarm!", "Die Heizung ist ausgefallen!", "media/webcam.jpg");
```
## SMTP_SendMailAttachmentEx
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmailattachmentex/
`bool SMTP_SendMailAttachmentEx(int $InstanzID, string $Empfänger, string $Betreff, string $Inhalt, string $Dateipfad)`
_Benötigt Symcon >= 2.2_
versendet eine E-Mail mit Anhang an eine beliebige Adresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Empfänger` (string): E-Mail Adresse des Empfängers
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
- `$Dateipfad` (string): Pfad zur Datei
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
Pfad zur Datei
**Beispiel**
```php
SMTP_SendMailAttachmentEx(12345, "me@example.com", "Alarm!", "Die Heizung ist ausgefallen!", "media/webcam.jpg");
```
## SMTP_SendMailEx
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmailex/
`bool SMTP_SendMailEx(int $InstanzID, string $Empfänger, string $Betreff, string $Inhalt)`
_Benötigt Symcon >= 2.2_
versendet eine E-Mail an eine beliebige Adresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Empfänger` (string): E-Mail Adresse des Empfängers
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
**Beispiel**
```php
//Eine Nachricht an einen Empfänger versenden, welche anders sein kann als die Eingestellte.
SMTP_SendMailEx(12345, "ich@provider.com", "Alarm!", "Die Heizung ist ausgefallen!");
//Eine Nachricht an mehrere Empfängern versenden.
$empfaengerListe = Array("ich@provider.com", "meinpartner@provider.com", "meinhausmeister@provider.com");
foreach($empfaengerListe as $empfaenger) {
SMTP_SendMailEx(12345, $empfaenger, "Alarm!", "Die Heizung ist ausgefallen!");
}
```
## SMTP_SendMailMedia
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmailmedia/
`bool SMTP_SendMailMedia(int $InstanzID, string $Betreff, string $Inhalt, int $MedienID)`
_Benötigt Symcon >= 4.0_
versendet eine E-Mail mit Anhang eines Medienobjekts vom Typ "Bild/Ton" an die Standardadresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
- `$MedienID` (int): ID des Medienobjekts (nur Bild/Ton und Dokument)
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
ID des Medienobjekts (nur Bild/Ton und Dokument)
**Beispiel**
```php
SMTP_SendMailMedia(12345, "Alarm!", "Da hat jemand an der Tür geklingelt, aber du bist leider nicht da!", 23456);
```
## SMTP_SendMailMediaEx
Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/smtp/smtp-sendmailmediaex/
`bool SMTP_SendMailMediaEx(int $InstanzID, string $Empfänger, string $Betreff, string $Inhalt, int $MedienID)`
_Benötigt Symcon >= 4.0_
versendet eine E-Mail mit Anhang eines Medienobjekts vom Typ "Bild/Ton" an eine beliebige Adresse
**Parameter**
- `$InstanzID` (int): ID der SMTP Instanz
- `$Empfänger` (string): E-Mail Adresse des Empfängers
- `$Betreff` (string): Betreff der E-Mail
- `$Inhalt` (string): Inhalt der E-Mail. Wird als HTML versendet (seit 7.0), sofern und gefunden wird, ansonsten als Text
- `$MedienID` (int): ID des Medienobjekts (nur Bild/Ton und Dokument)
**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.
ID des Medienobjekts (nur Bild/Ton und Dokument)
**Beispiel**
```php
SMTP_SendMailMediaEx(12345, "me@example.com", "Alarm!", "Da hat jemand an der Tür geklingelt, aber du bist leider nicht da!", 23456);
```