# Von SMTP2GO migrieren

> Wechseln Sie von SMTP2GO zu Emailit. SMTP-Benutzer und Hosts austauschen, Aufrufe an email/send und Vorlagen umwandeln und Webhooks, Sperrungen und Absenderdomains umziehen.

Diese Anleitung ordnet Konzepte, SMTP-Einstellungen, API-Aufrufe, Webhooks, Sperrungen und Vorlagen von SMTP2GO ihren Entsprechungen in Emailit zu. Lesen Sie zuerst [Zu Emailit migrieren](/de/docs/migrate/) für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

## Konzepte

| SMTP2GO | Emailit |
| --- | --- |
| Hauptkonto und Unterkonten | Konto und [Workspaces](/de/docs/workspaces/). Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits. |
| SMTP-Benutzer | Ihr API-Schlüssel, als SMTP-Passwort verwendet. Erstellen Sie einen Schlüssel pro App oder Server. |
| API-Schlüssel mit Berechtigungen pro Endpunkt | [API-Schlüssel](/de/docs/developers/api-keys/): **Full Access** oder **Sending Only**, optional auf eine Domain beschränkt |
| Authentifizierung über IP und Adresse | Nicht verfügbar. Jede SMTP-Verbindung authentifiziert sich mit einem API-Schlüssel. |
| Absenderdomains | [Versanddomains](/de/docs/domains/) |
| Single Sender Emails | Nicht verfügbar. Jede Absenderadresse muss auf einer verifizierten Domain liegen. |
| Sandbox-Status eines SMTP-Benutzers oder API-Schlüssels | Neue Workspaces sind im [Sandbox-Modus](/de/docs/workspaces/production-access/) und stellen nur an Mitglieder des Workspace zu. |
| Einstellungen für Tracking und Abmelde-Footer pro SMTP-Benutzer oder API-Schlüssel | [Tracking](/de/docs/tracking/) pro Versanddomain. Emailit fügt E-Mails per API oder SMTP keinen Abmelde-Footer hinzu. |
| Vorlagen | [Vorlagen](/de/docs/templates/) mit Alias und Versionen, gerendert mit [Temple](/de/docs/templates/temple/) |
| Webhooks | [Webhooks](/de/docs/webhooks/) |
| Sperrungen von Adressen und Domains | [Sperrungen](/de/docs/suppressions/) von Adressen |
| Berichte und Aktivität | **Email API → Emails** und **Email API → Logs** |
| Dedizierte IPs und IP-Pools | [Dedizierte IPs](/de/docs/deliverability/dedicated-ips/) auf Anfrage |

Wenn Sie sich bei Newslettern auf den Abmelde-Footer von SMTP2GO verlassen, fügen Sie Ihren eigenen Abmeldelink und `List-Unsubscribe`-Header hinzu oder senden Sie die Newsletter als [Kampagnen](/de/docs/campaigns/) von Emailit, die die Header für Sie hinzufügen. Fügen Sie in Kampagnen den sichtbaren Link mit `{{unsubscribe_url}}` ein. Siehe [SMTP-Header](/de/docs/smtp/headers/#add-list-unsubscribe-yourself).

## SMTP-Einstellungen umstellen

| Einstellung | SMTP2GO | Emailit |
| --- | --- | --- |
| Host | `mail.smtp2go.com` oder ein regionaler Host wie `mail-eu.smtp2go.com` | `smtp.emailit.com` |
| Port | `2525`, `587`, `25`, `8025` oder `80` (STARTTLS), `465`, `8465` oder `443` (TLS) | `587`, `2587`, `2525` oder `25` (STARTTLS), `465` (TLS) |
| Benutzername | Der Benutzername des SMTP-Benutzers | `emailit` |
| Passwort | Das Passwort des SMTP-Benutzers | Ihr Emailit-API-Schlüssel |

Emailit nimmt auf den Ports `80`, `443`, `8025` und `8465` keine Verbindungen an. Wenn Ihr Netzwerk `25` und `587` blockiert, verwenden Sie `2525` oder `2587`. Jeder Empfänger wird in Emailit zu einer eigenen E-Mail, und die Antwort `250` listet ihre IDs auf, bei vielen Empfängern nur die erste ID. Siehe [SMTP-Einstellungen](/de/docs/smtp/settings/) und [SMTP-Header und -Antworten](/de/docs/smtp/headers/).

## API-Aufrufe anpassen

Aus `POST /v3/email/send` von SMTP2GO wird `POST /v2/emails`. Adressen bleiben Strings, aber die Feldnamen ändern sich:

```bash title="Before: SMTP2GO"
curl https://api.smtp2go.com/v3/email/send \
  -H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Your receipt",
    "text_body": "Thanks for your order.",
    "html_body": "<p>Thanks for your order.</p>"
  }'
```

```bash title="After: Emailit"
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<p>Thanks for your order.</p>"
  }'
```

| SMTP2GO | Emailit |
| --- | --- |
| Header `X-Smtp2go-Api-Key`, `api_key` im Body oder `Authorization: Bearer api-…` | `Authorization: Bearer secret_…` |
| `sender` | `from` |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc`, jeweils bis zu 50 |
| `custom_headers` mit `Reply-To` | `reply_to` |
| `custom_headers: [{ "header": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `subject` | `subject` |
| `text_body`, `html_body` | `text`, `html` |
| `attachments[]` mit `filename`, `fileblob` oder `url` und `mimetype` | `attachments[]` mit `filename`, `content` oder `url` und `content_type` |
| `inlines[]` | `attachments[]` mit einer `content_id`, im HTML als `cid:` referenziert |
| `template_id` und `template_data` | `template` (ein Alias oder eine ID) und `variables` |
| `schedule` (bis zu 3 Tage im Voraus) | `scheduled_at` (ISO 8601 oder englischer Klartext) |
| `fastaccept` | Nicht nötig. Emailit stellt jede E-Mail zur Zustellung in die Warteschlange und antwortet, ohne auf die Zustellung zu warten. |
| `POST /v3/email/batch` (bis zu 1.000 E-Mails) | Nicht verfügbar. Senden Sie eine Anfrage pro Nachricht. |
| `POST /v3/email/mime` | Senden Sie die MIME-Nachricht über das [SMTP-Relay](/de/docs/smtp/) |
| `200` mit `email_id`, `succeeded`, `failed` und `failures` | `200` mit `id` (`em_…`), `status: "accepted"` und, bei mehreren Empfängern, `ids` mit einer ID pro Empfänger. Fehler verwenden HTTP-Statuscodes. |

SMTP2GO hat keine Metadaten oder Tracking-Einstellungen pro E-Mail. Fügen Sie in Emailit `meta` hinzu, um Ihre eigenen Werte in Webhook-Events zurückzubekommen, und `tracking: { "loads": true, "clicks": true }`, um das Tracking der Domain zu überschreiben. Fügen Sie einen Header `Idempotency-Key` hinzu, damit Wiederholungen sicher sind. Siehe [E-Mail senden](/de/docs/email-api/send-email/).

## Webhook-Events zuordnen

| SMTP2GO-Event | Emailit-Event |
| --- | --- |
| `processed` | `email.accepted` (nur API) |
| `delivered` | `email.delivered` |
| `bounce` mit `bounce` `soft` | `email.attempted`, während Emailit es erneut versucht, dann `email.bounced`, wenn alle Wiederholungen fehlschlagen |
| `bounce` mit `bounce` `hard` | `email.bounced` |
| `reject` | `email.suppressed`, wenn die Adresse eine Sperrung vom Typ `recipient` hat. Andere Ablehnungen, etwa ein nicht verifizierter Absender, sind Fehler in der API-Antwort oder der SMTP-Antwort. |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, nur für Kampagnen-E-Mails |

Das Anfrageformat ändert sich:

- SMTP2GO sendet ein Event pro Anfrage, standardmäßig als Formularfelder oder als flaches JSON. Emailit sendet ein JSON-Array mit bis zu 100 Events. Iterieren Sie also über den Body.
- Der Event-Name wandert von `event` nach `type`, und die E-Mail steht in `data.object`. Verwenden Sie `data.object.id`, die `em_`-ID aus der Antwort auf den Versand oder aus der SMTP-Antwort, statt `email_id` und `data.object.to` statt `rcpt`. Werte, die Sie in `meta` übergeben haben, stehen in `data.object.meta`.
- Bei `email.loaded` und `email.clicked` ist `data.object` der Ladevorgang oder der Klick. Verwenden Sie `data.object.email_id` für die ID der E-Mail sowie `data.object.email.rcpt_to` und `data.object.email.meta` für den Empfänger und Ihre `meta`-Werte.
- SMTP2GO signiert Webhooks nicht. Emailit signiert jede Anfrage: Verifizieren Sie `X-Emailit-Signature` anhand von `X-Emailit-Timestamp` und Ihrem `whsec_`-Secret. Siehe [Anfragesignatur](/de/docs/webhooks/request-signature/).

```javascript
for (const event of req.body) {
  const email = event.data.object;
  if (event.type === 'email.bounced') markBounced(email.to, email.id);
  if (event.type === 'email.complained') unsubscribe(email.to);
}
```

## Sperrungen umziehen

1. Exportieren Sie Ihre Sperrungen unter **Reports > Suppressions** mit **Export** oder rufen Sie `POST /v3/suppression/view` Seite für Seite ab. Die API liefert etwa die letzten 30 Tage, sofern Sie `start_date` nicht setzen. Setzen Sie es daher so, dass es Ihren gesamten Verlauf abdeckt.

2. Erstellen Sie eine CSV-Datei mit den Spalten `email,type,reason`:

   | Grund in SMTP2GO | Typ in Emailit |
   | --- | --- |
   | `bounce`, `spam`, `manual` | `recipient`, der Versände per API, SMTP und Kampagne blockiert |
   | `unsubscribe` | `unsubscribe`, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt. Verwenden Sie `recipient`, wenn sich die Person von allem abgemeldet hat, was Sie senden. |

```csv
email,type,reason
old-address@example.com,recipient,smtp2go bounce
left@example.com,unsubscribe,smtp2go unsubscribe
```

3. Wählen Sie unter **Email API → Suppressions** die Option **Import** und laden Sie die Datei hoch. Jede Datei darf bis zu 10.000 Zeilen haben und höchstens 8 MB groß sein. Duplikate werden übersprungen.

Emailit sperrt genaue Adressen, daher lassen sich Domain-Sperrungen nicht importieren. Wiederholen Sie den Export für jedes Unterkonto und importieren Sie ihn in den passenden Workspace. Siehe [Sperrungen verwalten](/de/docs/suppressions/manage/).

## Vorlagen umziehen

Rufen Sie das HTML jeder Vorlage mit `POST /v3/template/view` ab, das `html_body`, `text_body` und `subject` zurückgibt, oder kopieren Sie es unter **Settings > Templates**. Importieren Sie es unter **Email Marketing → Templates** oder erstellen Sie die Vorlage mit der [Vorlagen-API](/de/docs/api-reference/templates/create/) und verwenden Sie die Vorlagen-ID von SMTP2GO als Alias, sofern sie dem Alias-Format aus Kleinbuchstaben, Ziffern, `-` und `_` entspricht.

SMTP2GO ignoriert `subject`, wenn Sie eine Vorlage senden. Emailit verwendet den Betreff der Vorlage, sofern die Anfrage keinen enthält. Lassen Sie `subject` daher weg, um den Betreff der Vorlage beizubehalten.

SMTP2GO-Vorlagen verwenden Handlebars. Temple deckt die üblichen Teile ab:

| SMTP2GO (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{ username }}`, `{{ user.name }}` | `{{username}}`, `{{user.name}}` |
| `{{{ html_block }}}` | `{{html_block}}`. Temple maskiert HTML nie, maskieren Sie Benutzereingaben also selbst. |
| `{{#if plan}}…{{else}}…{{/if}}` | Identisch |
| `{{#each items}}…{{/each}}` | Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable. |
| Kein eingebauter Standardwert | `{{username\|"there"}}` fügt einen Ersatzwert hinzu |
| `template_data` | `variables` |

Siehe [Temple](/de/docs/templates/temple/) und [Vorlagen importieren und exportieren](/de/docs/templates/import-export/).

## DNS ändern

Fügen Sie Ihre Domain unter **Email API → Domains** hinzu und legen Sie die Einträge von Emailit an. Sie verwenden eigene Namen (`emailit._domainkey`, `emailit.<domain>` und optional `go` und `inbound`) und kollidieren daher weder mit dem DKIM-CNAME `s<number>._domainkey` von SMTP2GO noch mit dessen Return-Path-CNAME `em<number>` oder Tracking-CNAME `link`. Behalten Sie Ihren DMARC-Eintrag. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

Entfernen Sie nach der Umstellung die CNAMEs von SMTP2GO sowie `include:spf.smtp2go.com`, falls Ihr SPF-Eintrag es noch enthält.

## Nächste Schritte

- [Go-live-Checkliste](/de/docs/get-started/go-live/)
- [SMTP-Fehlerbehebung](/de/docs/smtp/troubleshooting/)
- [Priority migration](/de/docs/programs/priority-migration/): Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen

---
Quelle: https://emailit.com/de/docs/migrate/smtp2go/
