# 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](/de/docs/migrate/) für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

## Konzepte

| ZeptoMail (Zoho CPaaS) | Emailit |
| --- | --- |
| Konto | Konto |
| Agents (früher Mail Agents) | [Workspaces](/de/docs/workspaces/) oder ein Workspace mit mehreren Versanddomains |
| Send Mail Token eines Agents | [API-Schlüssel](/de/docs/developers/api-keys/) 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](/de/docs/domains/) |
| Sandbox-Agents | Neue Workspaces sind im [Sandbox-Modus](/de/docs/workspaces/production-access/) 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](/de/docs/templates/) pro Workspace, mit Alias und Versionen |
| Webhooks pro Agent | [Webhooks](/de/docs/webhooks/) pro Workspace |
| Sperrliste mit Einträgen für E-Mail-Adressen und Domains | [Sperrliste](/de/docs/suppressions/) aus E-Mail-Adressen |
| Verarbeitete E-Mails und E-Mail-Logs | **Email API → Emails** und **Email API → Logs** |
| `client_reference` | `meta` |
| File Cache | Anhänge per `url` |

ZeptoMail sendet nur transaktionale E-Mails. In Emailit hat derselbe Workspace auch [Kampagnen](/de/docs/campaigns/), [Kontaktlisten](/de/docs/audiences/) und [Automatisierungen](/de/docs/automations/), 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:

```bash title="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>"
  }'
```

```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>"
  }'
```

| 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 "` |
| `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](/de/docs/email-api/send-email/).

## 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](/de/docs/smtp/settings/).

## 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](/de/docs/webhooks/event-types/).

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](/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 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 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 exakte Adressen, Domain-Einträge wie `example.com` lassen sich daher nicht importieren. Siehe [Sperrungen verwalten](/de/docs/suppressions/manage/).

## 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 Marketing → Templates** oder erstellen Sie die Vorlage mit der [Vorlagen-API](/de/docs/api-reference/templates/create/) 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](/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-Eintrag von ZeptoMail noch mit dessen Bounce-CNAME oder Tracking-CNAME. Behalten Sie Ihren DMARC-Eintrag. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

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](/de/docs/get-started/go-live/)
- [Webhook einrichten](/de/docs/webhooks/set-up/)
- [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/zeptomail/
