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.
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:
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>"
}'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
eventnachtype, und die E-Mail steht indata.object. Verwenden Siedata.object.id, dieem_-ID aus der Antwort auf den Versand, stattmessage-idunddata.object.tostattemail. Ihremeta-Werte, dietagsundX-Mailin-customersetzen, 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. - Brevo signiert Webhooks nicht; Sie schützen sie mit Zugangsdaten oder einem Token. Emailit signiert jede Anfrage: Verifizieren Sie
X-Emailit-Signatureanhand vonX-Emailit-Timestampund Ihremwhsec_-Secret. 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
Brevo führt zwei Blocklisten. Übernehmen Sie beide:
-
Blockierte Kontakte für transaktionale E-Mails. Exportieren Sie sie unter Settings > Transactional emails > Blocked or Unsubscribed contacts oder rufen Sie
GET /v3/smtp/blockedContactsSeite für Seite ab. Verwenden Sie für alle den Typrecipient. Brevo blockiert eine Adresse für einen Absender, Emailit blockiert sie für den gesamten Workspace. -
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 Typrecipientfür Hard Bounces und Spam-Beschwerden undunsubscribefür Abmeldungen. Der Typunsubscribestoppt 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. -
Erstellen Sie eine CSV-Datei mit den Spalten
email,type,reason:email,type,reason old-address@example.com,recipient,brevo hard bounce left@example.com,unsubscribe,brevo unsubscribed -
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
-
Eigene Felder erstellen. Erstellen Sie in Emailit für jedes Kontaktattribut von Brevo, das Sie nutzen, außer
EMAIL,FIRSTNAMEundLASTNAME, ein eigenes Feld. Schlüssel bestehen aus Kleinbuchstaben, ausCOMPANYwird alsocompany. -
Erstellen Sie Kontaktlisten, eine für jede Liste in Brevo, an die Sie Kampagnen senden.
-
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.
-
Datei importieren. Wählen Sie unter Email MarketingContacts die Option Import, ordnen Sie
EMAIL,FIRSTNAME,LASTNAMEund 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
- Go-live-Checkliste
- Kampagne erstellen
- Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen