Zum Inhalt springen
Doku

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.

Aktualisiert am 23. Okt. 2026

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:

Before: ZeptoMail
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>"
  }'
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>"
  }'
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_name und eine Liste event_message, mit der E-Mail in email_info und den Details in event_data. Emailit sendet ein JSON-Array mit bis zu 100 Events, jeweils mit dem Namen in type und der E-Mail in data.object.
  • Verwenden Sie data.object.id, die em_-ID aus der Antwort auf den Versand, statt email_reference oder request_id. Jede E-Mail in Emailit hat einen Empfänger, data.object.to, daher brauchen Sie bounced_recipient nicht. Ihre meta-Werte 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.
  • ZeptoMail signiert mit HMAC-SHA256 in einem Header producer-signature, der ts und ein Base64-kodiertes s enthält. Emailit sendet X-Emailit-Timestamp in Sekunden und X-Emailit-Signature, den hexadezimal kodierten HMAC-SHA256 von <timestamp>.<raw body>, mit Ihrem whsec_-Secret als Schlüssel. Siehe Anfragesignatur.
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 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).

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

    CSV
    email,type,reason
    old-address@example.com,recipient,zeptomail hard bounce
    blocked@example.com,recipient,zeptomail suppression

    Verwenden Sie den Typ recipient für Adressen mit der Aktion suppress oder reject. Er blockiert Versände per API, SMTP und Kampagne. Für Einträge mit suppress_tracking gibt es keine Entsprechung, lassen Sie sie also weg.

  3. 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

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.