# Von Brevo migrieren

> Wechseln Sie von Brevo (früher Sendinblue) zu Emailit. Aufrufe an smtp/email und die Template-Sprache umwandeln, SMTP-Schlüssel austauschen und Webhooks, Blocklisten, Kontakte, Kampagnen und Automatisierungen umziehen.

Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Blocklisten, Vorlagen, Kontakte und Automatisierungen von Brevo ihren Entsprechungen in Emailit zu. Brevo hieß bis 2023 Sendinblue, und einige seiner Hosts und Header tragen noch diesen Namen. Lesen Sie zuerst [Zu Emailit migrieren](/de/docs/migrate/) für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

## Konzepte

| Brevo | Emailit |
| --- | --- |
| Konto und Unterkonten | Konto und [Workspaces](/de/docs/workspaces/). Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits. |
| API-Schlüssel | [API-Schlüssel](/de/docs/developers/api-keys/): **Full Access** oder **Sending Only**, optional auf eine Domain beschränkt |
| SMTP-Login und SMTP-Schlüssel | Ihr API-Schlüssel, als SMTP-Passwort verwendet |
| Absender, einzeln oder über eine authentifizierte Domain verifiziert | [Versanddomains](/de/docs/domains/). Einzelne Absenderadressen sind nicht verfügbar. |
| Header `X-Sib-Sandbox` | Kein Testmodus. Neue Workspaces sind im [Sandbox-Modus](/de/docs/workspaces/production-access/) und stellen nur an Mitglieder des Workspace zu. |
| Vorlagen und die Template-Sprache von Brevo | [Vorlagen](/de/docs/templates/) mit Alias und Versionen, gerendert mit [Temple](/de/docs/templates/temple/) |
| Transaktionale, Marketing- und Inbound-Webhooks | [Webhooks](/de/docs/webhooks/) |
| Inbound Parsing | [Eingehende E-Mails](/de/docs/inbound/) |
| Blockierte Kontakte (transaktional) und Kontakte auf der Blocklist (Kampagnen) | [Sperrungen](/de/docs/suppressions/) |
| Kontakte, Attribute und Listen | [Kontakte](/de/docs/contacts/), [eigene Felder](/de/docs/contacts/custom-fields/) und [Kontaktlisten](/de/docs/audiences/) |
| Segmente | Wählen Sie in jeder Kampagne die einzuschließenden und auszuschließenden Kontaktlisten. [Segmente](/de/docs/segments/) sind in der Alpha und stehen nur dem Emailit-Team offen. |
| E-Mail-Kampagnen | [Kampagnen](/de/docs/campaigns/) |
| Automatisierungen | [Automatisierungen](/de/docs/automations/) (Beta) |
| Formulare | [Formulare](/de/docs/forms/) (Early Access) oder die [Anmelde-URL](/de/docs/audiences/subscribe-url/) einer Kontaktliste |
| `tags` und der Header `X-Mailin-custom` | `meta` |
| Dedizierte IPs | [Dedizierte IPs](/de/docs/deliverability/dedicated-ips/) auf Anfrage |

## API-Aufrufe anpassen

Aus `POST /v3/smtp/email` von Brevo wird `POST /v2/emails`. Der Schlüssel wandert vom Header `api-key` in `Authorization`, und die Feldnamen werden kürzer:

```bash title="Before: Brevo"
curl https://api.brevo.com/v3/smtp/email \
  -H "api-key: $BREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "textContent": "Thanks for your order.",
    "htmlContent": "<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>"
  }'
```

| Brevo | Emailit |
| --- | --- |
| Header `api-key: xkeysib-…` | `Authorization: Bearer secret_…` |
| `sender: { email, name }` oder `sender: { id }` | `from: "Name "` |
| `to`, `cc`, `bcc` mit `email` und `name` | `to`, `cc`, `bcc` als String oder Array mit jeweils bis zu 50 |
| `replyTo: { email, name }` | `reply_to` |
| `subject`, `htmlContent`, `textContent` | `subject`, `html`, `text` |
| `headers` | `headers` |
| `attachment[]` mit `content` und `name` oder `url` | `attachments[]` mit `content`, `filename` und `content_type` oder `url` |
| `templateId` und `params` | `template` (ein Alias oder eine ID) und `variables` |
| `tags`, `headers["X-Mailin-custom"]` | `meta`, in Webhook-Events zurückgegeben |
| `scheduledAt` (bis zu 72 Stunden im Voraus) | `scheduled_at` (ISO 8601 oder englischer Klartext) |
| `headers.idempotencyKey` (30 Minuten lang gespeichert) | Ein HTTP-Header `Idempotency-Key`, 24 Stunden lang gespeichert |
| `messageVersions[]` | Nicht verfügbar. Senden Sie pro Empfänger eine Anfrage mit eigenen `variables`. |
| `headers["X-Sib-Sandbox"]` | Nicht verfügbar |
| `201` mit `messageId` | `200` mit `id` (`em_…`), `status: "accepted"` und, bei mehreren Empfängern, `ids` mit einer ID pro Empfänger |

Brevo hat keine Tracking-Einstellung pro E-Mail. In Emailit überschreibt `tracking: { "loads": true, "clicks": true }` das Tracking der Domain für eine einzelne E-Mail. Siehe [E-Mail senden](/de/docs/email-api/send-email/).

## SMTP-Einstellungen umstellen

| Einstellung | Brevo | Emailit |
| --- | --- | --- |
| Host | `smtp-relay.brevo.com` | `smtp.emailit.com` |
| Port | `587` oder `2525` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` oder `25` (STARTTLS), `465` (TLS) |
| Benutzername | Ihr SMTP-Login, etwa `…@smtp-brevo.com` oder die E-Mail-Adresse Ihres Kontos | `emailit` |
| Passwort | Ein SMTP-Schlüssel | Ihr Emailit-API-Schlüssel |

Emailit liest die Header von Brevo nicht, etwa `X-Mailin-custom` oder `X-Mailin-Tag`. Entfernen Sie sie und nutzen Sie die API, wenn Sie Metadaten benötigen. Siehe [SMTP-Einstellungen](/de/docs/smtp/settings/).

## Webhook-Events zuordnen

| Brevo-Event | Emailit-Event |
| --- | --- |
| `request` (gesendet) | `email.accepted` (nur API) |
| `delivered` | `email.delivered` |
| `deferred` | `email.attempted` |
| `soft_bounce` | `email.attempted`, während Emailit es erneut versucht, dann `email.bounced`, wenn alle Wiederholungen fehlschlagen |
| `hard_bounce` | `email.bounced` |
| `invalid_email` | Ein Fehler in der API-Antwort bei einer fehlerhaften Adresse oder `email.bounced`, wenn die Adresse nicht existiert |
| `blocked` | `email.suppressed` |
| `error` | `email.failed` |
| `spam` | `email.complained` |
| `opened`, `unique_opened`, `proxy_open` | `email.loaded`, für jeden Ladevorgang gesendet |
| `click` | `email.clicked` |
| `unsubscribed`, `unsubscribe` | `email.unsubscribed`, nur für Kampagnen-E-Mails |
| `list_addition` | `subscriber.created` |
| `contact_updated`, `contact_deleted` | `contact.updated`, `contact.deleted` |
| `inboundEmailProcessed` | `email.received`, dann den Inhalt mit [`GET /emails/{id}`](/de/docs/api-reference/emails/get/) abrufen |

Das Anfrageformat ändert sich:

- Brevo sendet ein Event pro Anfrage oder bei aktivierter Bündelung Batches mit bis zu 500 Events. 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, statt `message-id` und `data.object.to` statt `email`. Ihre `meta`-Werte, die `tags` und `X-Mailin-custom` ersetzen, 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.
- Brevo signiert Webhooks nicht; Sie schützen sie mit Zugangsdaten oder einem Token. 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

Brevo führt zwei Blocklisten. Übernehmen Sie beide:

1. **Blockierte Kontakte für transaktionale E-Mails.** Exportieren Sie sie unter **Settings > Transactional emails > Blocked or Unsubscribed contacts** oder rufen Sie `GET /v3/smtp/blockedContacts` Seite für Seite ab. Verwenden Sie für alle den Typ `recipient`. Brevo blockiert eine Adresse für einen Absender, Emailit blockiert sie für den gesamten Workspace.

2. **Kampagnenkontakte auf der Blocklist.** Filtern Sie unter **CRM > Contacts** nach dem Abonnementstatus für E-Mail-Kampagnen **Blocklisted** und exportieren Sie das Ergebnis, oder verwenden Sie `POST /v3/contacts/export`. Verwenden Sie den Typ `recipient` für Hard Bounces und Spam-Beschwerden und `unsubscribe` für Abmeldungen. Der Typ `unsubscribe` stoppt jede Kampagne, lässt transaktionale E-Mails aber weiter durch. Fügen Sie ihn also nicht für Personen hinzu, die nur eine Liste verlassen haben und eine andere noch abonniert haben.

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

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

4. **Datei importieren.** 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.

Für blockierte Domains gibt es keine Entsprechung, weil Emailit genaue Adressen sperrt. Siehe [Sperrungen verwalten](/de/docs/suppressions/manage/).

## Kontakte umziehen

1. **Eigene Felder erstellen.** Erstellen Sie in Emailit für jedes Kontaktattribut von Brevo, das Sie nutzen, außer `EMAIL`, `FIRSTNAME` und `LASTNAME`, ein [eigenes Feld](/de/docs/contacts/custom-fields/). Schlüssel bestehen aus Kleinbuchstaben, aus `COMPANY` wird also `company`.

2. **Erstellen Sie Kontaktlisten**, eine für jede Liste in Brevo, an die Sie Kampagnen senden.

3. **Exportieren Sie jede Liste** unter **CRM > Contacts** mit **More actions > Export**, einschließlich der Attribute und des Abonnementstatus. Lassen Sie Kontakte auf der Blocklist und Personen weg, die sich von der Liste abgemeldet haben.

4. **Datei importieren.** Wählen Sie unter **Email Marketing → Contacts** die Option **Import**, ordnen Sie `EMAIL`, `FIRSTNAME`, `LASTNAME` und Ihre Attribute zu und wählen Sie die passende Kontaktliste. Teilen Sie Dateien in Teile mit bis zu 2.500 Zeilen auf. Siehe [Kontakte importieren und exportieren](/de/docs/contacts/import-export/).

Der Import fügt alle Personen in der Datei als angemeldet hinzu. Prüfen Sie die Datei daher vor dem Import auf Opt-outs.

## Vorlagen umziehen

Rufen Sie das HTML jeder Vorlage mit `GET /v3/smtp/templates/{templateId}` für transaktionale Vorlagen oder mit `GET /v3/emailCampaigns/{campaignId}` für Kampagnen ab. Beide liefern es in `htmlContent`. Importieren Sie es unter **Email Marketing → Templates** oder erstellen Sie die Vorlage mit der [Vorlagen-API](/de/docs/api-reference/templates/create/) und geben Sie ihr einen Alias, etwa `receipt`.

Wandeln Sie die Template-Sprache von Brevo in Temple um:

| Brevo | Emailit (Temple) |
| --- | --- |
| `{{ params.name }}`, `{{ params.order.total }}` | `{{name}}`, `{{order.total}}` |
| `{{ contact.FIRSTNAME }}`, `{{ contact.LASTNAME }}` | `{{first_name}}`, `{{last_name}}` in Kampagnen |
| `{{ contact.COMPANY }}` | `{{cf.company}}` in Kampagnen |
| `{{ params.name\|default:"there" }}` | `{{name\|"there"}}` |
| `{% if params.plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if params.plan == "pro" %}`, `{% elif %}` | Nicht unterstützt. Übergeben Sie einen Boolean wie `is_pro` und verwenden Sie `{{#if is_pro}}`. |
| `{% for item in params.items %}…{% endfor %}` | Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable. |
| Filter wie `upper` oder `date` | Nicht unterstützt. Formatieren Sie den Wert in Ihrem Code. |
| `{{ unsubscribe }}` | `{{unsubscribe_url}}` in Kampagnen |
| `{{ update_profile }}` | `{{manage_subscriptions_url}}` in Kampagnen |
| `{{ mirror }}` | `{{webview_url}}` in Kampagnen |

Brevo maskiert HTML, sofern Sie nicht `safe` hinzufügen. Temple maskiert HTML nie. Maskieren Sie Benutzereingaben daher, bevor Sie sie übergeben. Siehe [Temple](/de/docs/templates/temple/) und [Platzhalter](/de/docs/campaigns/merge-tags/).

## Kampagnen und Automatisierungen neu aufbauen

Erstellen Sie Ihre Kampagnen unter **Email Marketing → Campaigns** aus Ihren importierten Vorlagen. Bauen Sie jede Automatisierung von Brevo als [Automatisierung](/de/docs/automations/) in Emailit im Kontext **Contact** neu auf:

| Brevo-Trigger | Emailit-Trigger |
| --- | --- |
| Kontakt zu einer Liste hinzugefügt, aus einer Liste entfernt | **Added to audience**, **Removed from audience** |
| Jahrestag oder ein Datumsattribut | **Date anniversary**, **Date in contact field** |
| Formular abgeschickt | **Form submitted**, für [Emailit-Formulare](/de/docs/forms/) (Early Access) |
| E-Mail geöffnet, Link geklickt | **Email opened**, **Link clicked** |
| Von einer E-Mail-Liste abgemeldet | **Unsubscribed** |
| Eigenes Event | **Custom event**, in den Tarifen Business und Custom |

Starten Sie jede Automatisierung, bevor Sie Ihre Anmeldeformulare umziehen, damit neue Kontakte ihre E-Mails vom ersten Tag an erhalten.

## 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 TXT-Eintrag `brevo-code` von Brevo noch mit dessen DKIM-Einträgen (`brevo1._domainkey` und `brevo2._domainkey` oder `mail._domainkey` bei älteren Einrichtungen). Behalten Sie Ihren DMARC-Eintrag. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

Entfernen Sie nach der Umstellung die Einträge von Brevo für Code, DKIM und die Branded Subdomain sowie `include:spf.brevo.com` oder `include:spf.sendinblue.com`, falls Ihr SPF-Eintrag es enthält. Wenn Sie E-Mails mit Inbound Parsing von Brevo empfangen, verlagern Sie das zuerst auf eine [Inbound-Subdomain](/de/docs/inbound/set-up/) von Emailit.

## Nächste Schritte

- [Go-live-Checkliste](/de/docs/get-started/go-live/)
- [Kampagne erstellen](/de/docs/campaigns/create/)
- [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/brevo/
