# SMTP-Relay

> Senden Sie E-Mails aus jeder App, jedem Framework und jedem Gerät, das SMTP spricht. Verbindungsdaten, wie weitergeleitete E-Mails in Emailit erscheinen und wie sich SMTP von der API unterscheidet.

Das SMTP-Relay von Emailit nimmt E-Mails von allem an, was per SMTP senden kann, etwa einem CMS, dem Mailer eines Frameworks, einem Monitoring-Tool oder einem Scanner, und stellt sie über dieselbe Pipeline zu wie die [E-Mail-API](/de/docs/email-api/). Nutzen Sie es, wenn das Ändern von SMTP-Einstellungen einfacher ist als API-Code zu schreiben.

## Wann Sie SMTP nutzen

SMTP passt gut, wenn:

- Ihre Software nur SMTP unterstützt, etwa WordPress-Plugins, Helpdesks und Netzwerkgeräte.
- Sie von einem anderen Anbieter wechseln und nur Host und Zugangsdaten ändern möchten.
- Ihr Framework bereits einen SMTP-Mailer hat, wie Laravel, Django, Rails und Nodemailer.

Wählen Sie die API, wenn Sie [Vorlagen](/de/docs/templates/) mit Variablen, Planung, Metadaten, Idempotenzschlüssel oder Tracking-Einstellungen pro E-Mail brauchen. Einen vollständigen Vergleich finden Sie unter [API oder SMTP?](/de/docs/get-started/api-or-smtp/).

## So funktioniert es

1. Ihre Anwendung verbindet sich mit `smtp.emailit.com`, stuft die Verbindung auf TLS hoch und meldet sich mit einem API-Schlüssel an.
2. Sie sendet den Envelope-Absender, einen Empfängerbefehl pro Empfänger und die Nachricht.
3. Emailit prüft den Workspace, die Rate Limits, die Nachrichtengröße und die Domain im From-Header und antwortet dann mit `250 2.0.0 OK: queued as em_…`.
4. Jeder Empfänger wird zu einer eigenen E-Mail mit eigener `em_`-ID. Emailit signiert sie mit DKIM, führt Spam-Prüfungen durch, stellt sie zu und wiederholt vorübergehende Fehlschläge, genau wie bei E-Mails per API.

## Verbindungsdaten

| Einstellung | Wert |
| --- | --- |
| Host | `smtp.emailit.com` |
| Port | `587` mit STARTTLS. Außerdem `465` (implizites TLS) sowie `2525` oder `2587` (STARTTLS) für Netzwerke, die 587 blockieren. |
| Benutzername | `emailit` |
| Passwort | Ein [API-Schlüssel](/de/docs/developers/api-keys/), beginnend mit `secret_` |
| Authentifizierung | `PLAIN` oder `LOGIN` |

Die Seite jedes API-Schlüssels unter **Email API → API Keys** zeigt dieselben Angaben in der Karte **SMTP Info**. [SMTP-Einstellungen](/de/docs/smtp/settings/) behandelt alle Ports, die Regeln für die Absenderadresse und die Limits.

## Testnachricht senden

**cURL**

```bash
cat > message.txt <<'EOF'
From: Acme <hello@acme.com>
To: ada@example.com
Subject: SMTP test from Acme

It works.
EOF

curl --url "smtp://smtp.emailit.com:587" --ssl-reqd --crlf \
  --user "emailit:$EMAILIT_API_KEY" \
  --mail-from hello@acme.com \
  --mail-rcpt ada@example.com \
  --upload-file message.txt -v
```

**Node.js**

```javascript
import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtp.emailit.com',
  port: 587,
  secure: false, // STARTTLS on 587
  requireTLS: true,
  auth: { user: 'emailit', pass: process.env.EMAILIT_API_KEY },
});

const info = await transporter.sendMail({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'SMTP test from Acme',
  text: 'It works.',
});

console.log(info.response); // 250 2.0.0 OK: queued as em_…
```

**Python**

```python
import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "SMTP test from Acme"
msg.set_content("It works.")

with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
    smtp.starttls()
    smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
    smtp.send_message(msg)
```

**PHP**

```php
use PHPMailer\PHPMailer\PHPMailer;

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.emailit.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = 'emailit';
$mail->Password = getenv('EMAILIT_API_KEY');

$mail->setFrom('hello@acme.com', 'Acme');
$mail->addAddress('ada@example.com');
$mail->Subject = 'SMTP test from Acme';
$mail->Body = 'It works.';
$mail->send();
```

Neue Workspaces sind im Sandbox-Modus und können nur an die Konto-E-Mail-Adressen der Workspace-Mitglieder senden. [Beantragen Sie den Produktionszugang](/de/docs/workspaces/production-access/), bevor Sie an andere Personen senden.

## Wie E-Mails per SMTP in Emailit erscheinen

- **Eine E-Mail pro Empfänger.** Eine Nachricht mit drei Empfängern erzeugt drei E-Mails, jede mit eigener `em_`-ID, eigenem Status und eigenen Events.
- **IDs in der Antwort.** Die Antwort `250` nach der Nachricht listet die neuen IDs auf, zum Beispiel `250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa`. Es sind dieselben IDs, die API, Weboberfläche und Webhooks verwenden. Siehe [SMTP-Header und -Antworten](/de/docs/smtp/headers/#the-250-reply).
- **E-Mail-Liste.** Die E-Mails erscheinen unter **Email API → Emails**. Filtern Sie nach **API key**, um die E-Mails einer einzelnen Anwendung zu sehen.
- **Logs.** Jede eingereichte Nachricht erscheint unter **Email API → Logs** mit der Quelle **SMTP** und ihrem Antwortcode, zusammen mit Ablehnungen wegen Rate Limits und fehlgeschlagenen Anmeldungen. Siehe [Anfrage-Logs](/de/docs/logs/request-logs/).
- **Webhooks.** E-Mails per SMTP lösen dieselben Zustell- und Engagement-Events aus wie E-Mails per API, aber nicht `email.accepted`. Das erste Event ist meist `email.delivered`.

## Wie sich SMTP von der E-Mail-API unterscheidet

| Funktion | E-Mail-API | SMTP-Relay |
| --- | --- | --- |
| Vorlagen und Temple-Variablen | Ja | Nein. Die Nachricht wird so gesendet, wie Sie sie erstellt haben. |
| Geplanter Versand | Ja, mit `scheduled_at` | Nein |
| Metadaten | Ja, mit `meta` | Nein |
| Öffnungs- und Klick-Tracking | Domaineinstellungen oder pro E-Mail mit `tracking` | Nur die Einstellungen **Track loads** und **Track clicks** der Versanddomain |
| Idempotenzschlüssel | Ja | Nein |
| Event `email.accepted` | Ja | Nein |
| Empfänger pro Nachricht | Jeweils bis zu 50 in `to`, `cc` und `bcc` | Kein festes Limit |
| Wann Credits berechnet werden | Wenn die Anfrage angenommen wird. Bei zu wenigen Credits wird `402` zurückgegeben. | Wenn jede E-Mail verarbeitet wird. Bei zu wenigen Credits wird die E-Mail zurückgehalten. |
| Was ein Rate Limit zählt | Jeden Empfänger | Jede SMTP-Transaktion (eine Nachricht) |
| Maximale Nachrichtengröße | 40 MB | 40 MB |

Emailit liest in SMTP-Nachrichten keine Steuer-Header `X-Emailit-*`. Siehe [SMTP-Header](/de/docs/smtp/headers/).

## Limits

| Limit | Wert |
| --- | --- |
| Nachrichtengröße | 40 MB |
| Senderate (Standard) | 2 Nachrichten pro Sekunde und 5.000 Nachrichten pro Tag pro Workspace, gemeinsam mit der API |
| Tägliches Zurücksetzen | Mitternacht UTC |
| Credits | 1 pro Empfänger |

Workspaces mit Pro oder Business erhalten automatische Limiterhöhungen auf Basis der Versandgesundheit, und jeder Workspace kann über die Karte **Sending Limits** auf der Startseite der Weboberfläche mehr beantragen. Siehe [Limits](/de/docs/limits/).

## Nächste Schritte

  - [SMTP-Einstellungen](/de/docs/smtp/settings/): Ports, TLS, Authentifizierung, Regeln für die Absenderadresse und Limits.
  - [Header und Antworten](/de/docs/smtp/headers/): Was Emailit hinzufügt, umschreibt und entfernt.
  - [Fehlerbehebung](/de/docs/smtp/troubleshooting/): Jeder SMTP-Antwortcode mit seiner Lösung.
  - [Schnellstart mit SMTP](/de/docs/quickstart/smtp/): Ihre erste Nachricht Schritt für Schritt senden.

---
Quelle: https://emailit.com/de/docs/smtp/
