Leitfaden
Von ZeptoMail migrieren
Wechseln Sie von ZeptoMail (jetzt Zoho CPaaS) zu Emailit. Agents und Send Mail Tokens zuordnen, API-Aufrufe und Mustache-Vorlagen umwandeln, SMTP austauschen und Webhooks und Sperrungen umziehen.
Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Sperrungen und Vorlagen von ZeptoMail ihren Entsprechungen in Emailit zu. Im September 2026 wurde ZeptoMail in Zoho CPaaS umbenannt. Bestehende Tokens, Hosts und SMTP-Einstellungen funktionieren weiterhin, daher verwendet diese Anleitung die ZeptoMail-Namen, die Sie in Ihrem Code finden. Lesen Sie zuerst Zu Emailit migrieren für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.
Konzepte
| ZeptoMail (Zoho CPaaS) | Emailit |
|---|---|
| Konto | Konto |
| Agents (früher Mail Agents) | Workspaces oder ein Workspace mit mehreren Versanddomains |
| Send Mail Token eines Agents | API-Schlüssel mit Sending Only, optional auf eine Domain beschränkt |
| Zoho-OAuth-Tokens für die Management-APIs | API-Schlüssel mit Full Access. Dieselbe Art von Schlüssel sendet E-Mails und verwaltet Ihren Workspace. |
| Mit Agents verknüpfte Domains | Versanddomains |
| Sandbox-Agents | Neue Workspaces sind im Sandbox-Modus und stellen nur an Mitglieder des Workspace zu. Einen Modus, der E-Mails annimmt, ohne sie zuzustellen, gibt es nicht. |
| Vorlagen pro Agent, mit Schlüssel und Alias | Vorlagen pro Workspace, mit Alias und Versionen |
| Webhooks pro Agent | Webhooks pro Workspace |
| Sperrliste mit Einträgen für E-Mail-Adressen und Domains | Sperrliste aus E-Mail-Adressen |
| Verarbeitete E-Mails und E-Mail-Logs | Email APIEmails und Email APILogs |
client_reference |
meta |
| File Cache | Anhänge per url |
ZeptoMail sendet nur transaktionale E-Mails. In Emailit hat derselbe Workspace auch Kampagnen, Kontaktlisten und Automatisierungen, falls Sie auch Newsletter umziehen möchten.
API-Aufrufe anpassen
Aus POST /v1.1/email von ZeptoMail wird POST /v2/emails. Das Autorisierungsschema ändert sich, und Adressen werden zu einfachen Strings:
curl https://api.zeptomail.com/v1.1/email \
-H "Authorization: Zoho-enczapikey $ZEPTOMAIL_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": { "address": "hello@acme.com", "name": "Acme" },
"to": [{ "email_address": { "address": "ada@example.com" } }],
"subject": "Your receipt",
"textbody": "Thanks for your order.",
"htmlbody": "<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>"
}'| ZeptoMail | Emailit |
|---|---|
Authorization: Zoho-enczapikey <token> |
Authorization: Bearer secret_… |
Regionale Hosts wie api.zeptomail.eu oder cpaas.zoho.eu |
Ein Host, api.emailit.com |
from: { address, name } |
from: "Name <email>" |
to[], cc[], bcc[] mit email_address: { address, name } |
to, cc, bcc als String oder Array mit jeweils bis zu 50 |
reply_to: [{ address, name }] |
reply_to |
subject |
subject |
htmlbody, textbody |
html, text |
mime_headers |
headers |
attachments[] mit content, mime_type, name |
attachments[] mit content, content_type, filename |
attachments[] mit file_cache_key |
attachments[] mit einer url, die Emailit herunterlädt, oder dem Base64-kodierten content |
inline_images[] mit cid |
attachments[] mit einer content_id, im HTML als cid: referenziert |
client_reference |
meta, zum Beispiel meta: { "reference": "order-12345" }, in Webhook-Events zurückgegeben |
track_opens, track_clicks |
tracking: { "loads": true, "clicks": true } |
POST /v1.1/email/template mit template_key oder template_alias und merge_info |
Dasselbe POST /v2/emails mit template (ein Alias oder eine ID) und variables |
POST /v1.1/email/batch und /email/template/batch |
Nicht verfügbar. Senden Sie pro Empfänger eine Anfrage mit eigenen variables. |
Antwort mit request_id und eine email_reference pro E-Mail in Webhooks und Logs |
200 mit id (em_…), status: "accepted" und, bei mehreren Empfängern, ids mit einer ID pro Empfänger |
Emailit unterstützt außerdem Planung mit scheduled_at und sichere Wiederholungen mit einem Header Idempotency-Key, was ZeptoMail beim Senden nicht bietet. Siehe E-Mail senden.
SMTP-Einstellungen umstellen
| Einstellung | ZeptoMail | Emailit |
|---|---|---|
| Host | smtp.zeptomail.com oder ein regionaler Host |
smtp.emailit.com |
| Port | 587 (STARTTLS), 465 (TLS) |
587, 2587, 2525 oder 25 (STARTTLS), 465 (TLS) |
| Benutzername | emailapikey |
emailit |
| Passwort | Das Send Mail Token des Agents, ohne Zoho-enczapikey |
Ihr Emailit-API-Schlüssel |
Emailit liest keine X-TM-*-Header wie X-TM-CLIENT-REF, X-TM-OPEN-TRACK, X-TM-CLICK-TRACK oder X-TM-FILE-KEY. Entfernen Sie sie. Legen Sie das Tracking bei der Domain fest und nutzen Sie die API, wenn Sie Metadaten brauchen. Siehe SMTP-Einstellungen.
Webhook-Events zuordnen
| ZeptoMail-Event | Emailit-Event |
|---|---|
| Delivered | email.delivered |
Soft Bounce (softbounce) |
email.attempted, während Emailit es erneut versucht, dann email.bounced, wenn alle Wiederholungen fehlschlagen |
Hard Bounce (hardbounce) |
email.bounced |
Open (email_open), nur die erste Öffnung |
email.loaded, für jeden Ladevorgang gesendet |
Click (email_link_click) |
email.clicked, für jeden Klick gesendet |
Feedback-Loop (fbl_complaint) |
email.complained |
Emailit sendet außerdem Events, für die ZeptoMail keinen Webhook hat, etwa email.accepted, wenn die API eine E-Mail annimmt, und email.suppressed, wenn eine Sperrung vom Typ recipient eine Adresse blockiert. Siehe Event-Typen.
Das Anfrageformat ändert sich:
- ZeptoMail sendet
event_nameund eine Listeevent_message, mit der E-Mail inemail_infound den Details inevent_data. Emailit sendet ein JSON-Array mit bis zu 100 Events, jeweils mit dem Namen intypeund der E-Mail indata.object. - Verwenden Sie
data.object.id, dieem_-ID aus der Antwort auf den Versand, stattemail_referenceoderrequest_id. Jede E-Mail in Emailit hat einen Empfänger,data.object.to, daher brauchen Siebounced_recipientnicht. Ihremeta-Werte 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. - ZeptoMail signiert mit HMAC-SHA256 in einem Header
producer-signature, dertsund ein Base64-kodiertessenthält. Emailit sendetX-Emailit-Timestampin Sekunden undX-Emailit-Signature, den hexadezimal kodierten HMAC-SHA256 von<timestamp>.<raw body>, mit Ihremwhsec_-Secret als Schlüssel. 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 Sperrliste. Der Export im Dashboard umfasst die letzten 60 Tage mit bis zu 5.000 Einträgen pro Datei. Verwenden Sie für ältere Einträge daher die Suppressions-API (
GET /v1.1/suppressions/email). -
Erstellen Sie eine CSV-Datei mit den Spalten
email,type,reason:email,type,reason old-address@example.com,recipient,zeptomail hard bounce blocked@example.com,recipient,zeptomail suppressionVerwenden Sie den Typ
recipientfür Adressen mit der Aktionsuppressoderreject. Er blockiert Versände per API, SMTP und Kampagne. Für Einträge mitsuppress_trackinggibt es keine Entsprechung, lassen Sie sie also weg. -
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 exakte Adressen, Domain-Einträge wie example.com lassen sich daher nicht importieren. Siehe Sperrungen verwalten.
Vorlagen umziehen
Kopieren Sie das HTML jeder Vorlage aus dem Editor von ZeptoMail oder holen Sie es über die Vorlagen-API von ZeptoMail, die es in htmlbody zurückgibt. Importieren Sie es unter Email MarketingTemplates oder erstellen Sie die Vorlage mit der Vorlagen-API und verwenden Sie den Alias der ZeptoMail-Vorlage als Alias in Emailit, sofern er dem Alias-Format aus Kleinbuchstaben, Ziffern, - und _ entspricht.
ZeptoMail-Vorlagen verwenden Mustache. Temple deckt die üblichen Teile ab:
| ZeptoMail (Mustache) | Emailit (Temple) |
|---|---|
{{name}}, {{order.total}} |
Identisch |
{{{html_block}}} |
{{html_block}}. Temple maskiert HTML nie, maskieren Sie Benutzereingaben also selbst. |
{{#plan}}…{{/plan}} |
{{#if plan}}…{{/if}} |
{{^plan}}…{{/plan}} |
{{#if plan}}{{else}}…{{/if}} |
{{#items}}…{{/items}} über eine Liste |
Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable. |
| Kein eingebauter Standardwert | {{name|"there"}} fügt einen Ersatzwert hinzu |
merge_info |
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-Eintrag von ZeptoMail noch mit dessen Bounce-CNAME oder Tracking-CNAME. Behalten Sie Ihren DMARC-Eintrag. Siehe DNS-Einträge.
Entfernen Sie nach der Umstellung die DKIM-, Bounce- und Tracking-Einträge von ZeptoMail sowie include:zeptomail.net, falls Sie es Ihrem SPF-Eintrag hinzugefügt haben.
Nächste Schritte
- Go-live-Checkliste
- Webhook einrichten
- Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen