Leitfaden
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 für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.
Konzepte
| SMTP2GO | Emailit |
|---|---|
| Hauptkonto und Unterkonten | Konto und 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: 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 |
| 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 und stellen nur an Mitglieder des Workspace zu. |
| Einstellungen für Tracking und Abmelde-Footer pro SMTP-Benutzer oder API-Schlüssel | Tracking pro Versanddomain. Emailit fügt E-Mails per API oder SMTP keinen Abmelde-Footer hinzu. |
| Vorlagen | Vorlagen mit Alias und Versionen, gerendert mit Temple |
| Webhooks | Webhooks |
| Sperrungen von Adressen und Domains | Sperrungen von Adressen |
| Berichte und Aktivität | Email APIEmails und Email APILogs |
| Dedizierte IPs und IP-Pools | Dedizierte 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 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.
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 und SMTP-Header und -Antworten.
API-Aufrufe anpassen
Aus POST /v3/email/send von SMTP2GO wird POST /v2/emails. Adressen bleiben Strings, aber die Feldnamen ändern sich:
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>"
}'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 |
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.
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
eventnachtype, und die E-Mail steht indata.object. Verwenden Siedata.object.id, dieem_-ID aus der Antwort auf den Versand oder aus der SMTP-Antwort, stattemail_idunddata.object.tostattrcpt. Werte, die Sie inmetaübergeben haben, stehen indata.object.meta. - Bei
email.loadedundemail.clickedistdata.objectder Ladevorgang oder der Klick. Verwenden Siedata.object.email_idfür die ID der E-Mail sowiedata.object.email.rcpt_tounddata.object.email.metafür den Empfänger und Ihremeta-Werte. - SMTP2GO signiert Webhooks nicht. Emailit signiert jede Anfrage: Verifizieren Sie
X-Emailit-Signatureanhand vonX-Emailit-Timestampund Ihremwhsec_-Secret. Siehe Anfragesignatur.
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
-
Exportieren Sie Ihre Sperrungen unter Reports > Suppressions mit Export oder rufen Sie
POST /v3/suppression/viewSeite für Seite ab. Die API liefert etwa die letzten 30 Tage, sofern Siestart_datenicht setzen. Setzen Sie es daher so, dass es Ihren gesamten Verlauf abdeckt. -
Erstellen Sie eine CSV-Datei mit den Spalten
email,type,reason:Grund in SMTP2GO Typ in Emailit bounce,spam,manualrecipient, der Versände per API, SMTP und Kampagne blockiertunsubscribeunsubscribe, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt. Verwenden Sierecipient, wenn sich die Person von allem abgemeldet hat, was Sie senden.email,type,reason old-address@example.com,recipient,smtp2go bounce left@example.com,unsubscribe,smtp2go unsubscribe -
Wählen Sie unter Email APISuppressions 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.
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 MarketingTemplates oder erstellen Sie die Vorlage mit der Vorlagen-API 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 und Vorlagen importieren und exportieren.
DNS ändern
Fügen Sie Ihre Domain unter Email APIDomains 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.
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
- SMTP-Fehlerbehebung
- Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen