Zum Inhalt springen
Doku

Leitfaden

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.

Aktualisiert am 23. Okt. 2026

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 für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

Konzepte

Brevo Emailit
Konto und Unterkonten Konto und Workspaces. Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits.
API-Schlüssel API-Schlüssel: 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. Einzelne Absenderadressen sind nicht verfügbar.
Header X-Sib-Sandbox Kein Testmodus. Neue Workspaces sind im Sandbox-Modus und stellen nur an Mitglieder des Workspace zu.
Vorlagen und die Template-Sprache von Brevo Vorlagen mit Alias und Versionen, gerendert mit Temple
Transaktionale, Marketing- und Inbound-Webhooks Webhooks
Inbound Parsing Eingehende E-Mails
Blockierte Kontakte (transaktional) und Kontakte auf der Blocklist (Kampagnen) Sperrungen
Kontakte, Attribute und Listen Kontakte, eigene Felder und Kontaktlisten
Segmente Wählen Sie in jeder Kampagne die einzuschließenden und auszuschließenden Kontaktlisten. Segmente sind in der Alpha und stehen nur dem Emailit-Team offen.
E-Mail-Kampagnen Kampagnen
Automatisierungen Automatisierungen (Beta)
Formulare Formulare (Early Access) oder die Anmelde-URL einer Kontaktliste
tags und der Header X-Mailin-custom meta
Dedizierte IPs Dedizierte 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:

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>"
  }'
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 <email>"
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.

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.

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

Für blockierte Domains gibt es keine Entsprechung, weil Emailit genaue Adressen sperrt. Siehe Sperrungen verwalten.

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

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 MarketingTemplates oder erstellen Sie die Vorlage mit der Vorlagen-API 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 und Platzhalter.

Kampagnen und Automatisierungen neu aufbauen

Erstellen Sie Ihre Kampagnen unter Email MarketingCampaigns aus Ihren importierten Vorlagen. Bauen Sie jede Automatisierung von Brevo als Automatisierung 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 (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 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 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.

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 von Emailit.

Nächste Schritte

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.