Průvodce
Přechod z Breva
Přejděte z Breva (dříve Sendinblue) na Emailit. Převeďte volání API smtp/email a šablonovací jazyk, vyměňte klíče SMTP a přesuňte webhooky, blokované adresy, kontakty, kampaně a automatizace.
Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy, šablony, kontakty a automatizace z Breva na jejich ekvivalenty v Emailitu. Brevo se do roku 2023 jmenovalo Sendinblue a některé jeho servery a hlavičky tento název stále používají. Celkové pořadí a souběžný provoz obou poskytovatelů popisuje stránka Přechod na Emailit, přečtěte si ji jako první.
Principy
| Brevo | Emailit |
|---|---|
| Účet a sub-accounts | Účet a workspace. Každý workspace má vlastní domény, klíče, členy a kredity. |
| API keys | API klíče: Full Access, nebo Sending Only, volitelně omezený na jednu doménu |
| Přihlašovací jméno SMTP a klíče SMTP | Váš API klíč použitý jako heslo k SMTP |
| Senders ověřené jednotlivě nebo přes ověřenou doménu | Odesílací domény. Jednotlivé adresy odesílatelů nejsou dostupné. |
Hlavička X-Sib-Sandbox |
Testovací režim neexistuje. Nové workspace jsou v režimu sandbox a doručují jen členům workspace. |
| Templates a šablonovací jazyk Breva | Šablony s aliasem a verzemi vykreslované jazykem Temple |
| Transakční, marketingové a příchozí webhooky | Webhooky |
| Inbound parsing | Příchozí e-maily |
| Blocked contacts (transakční e-maily) a blocklisted contacts (kampaně) | Blokované adresy |
| Contacts, attributes a lists | Kontakty, vlastní pole a seznamy kontaktů |
| Segments | V každé kampani vyberte zahrnuté a vyloučené seznamy kontaktů. Segmenty jsou v alfaverzi a otevřené jen týmu Emailitu. |
| Email campaigns | Kampaně |
| Automations | Automatizace (betaverze) |
| Forms | Formuláře (předběžný přístup), nebo URL pro přihlášení seznamu kontaktů |
tags a hlavička X-Mailin-custom |
meta |
| Dedicated IPs | Dedikované IP adresy na vyžádání |
Upravte volání API
Z POST /v3/smtp/email v Brevu se stane POST /v2/emails. Klíč se přesune z hlavičky api-key do Authorization a názvy polí se zkrátí:
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 |
|---|---|
Hlavička api-key: xkeysib-… |
Authorization: Bearer secret_… |
sender: { email, name } nebo sender: { id } |
from: "Name <email>" |
to, cc, bcc s email a name |
to, cc, bcc jako řetězec nebo pole, každé až 50 adres |
replyTo: { email, name } |
reply_to |
subject, htmlContent, textContent |
subject, html, text |
headers |
headers |
attachment[] s content a name, nebo s url |
attachments[] s content, filename a content_type, nebo s url |
templateId a params |
template (alias nebo ID) a variables |
tags, headers["X-Mailin-custom"] |
meta, vrací se v událostech webhooků |
scheduledAt (nejvýše 72 hodin dopředu) |
scheduled_at (ISO 8601 nebo běžná angličtina) |
headers.idempotencyKey (uchovává se 30 minut) |
Hlavička HTTP Idempotency-Key, uchovává se 24 hodin |
messageVersions[] |
Není dostupné. Pro každého příjemce odešlete samostatný požadavek s vlastními variables. |
headers["X-Sib-Sandbox"] |
Není dostupné |
201 s messageId |
200 s id (em_…), status: "accepted" a u více příjemců ids s jedním ID pro každého |
Brevo nemá nastavení měření pro jednotlivé e-maily. V Emailitu tracking: { "loads": true, "clicks": true } přepíše nastavení měření domény pro jeden e-mail. Viz Odeslání e-mailu.
Změňte nastavení SMTP
| Nastavení | Brevo | Emailit |
|---|---|---|
| Server | smtp-relay.brevo.com |
smtp.emailit.com |
| Port | 587 nebo 2525 (STARTTLS), 465 (TLS) |
587, 2587, 2525 nebo 25 (STARTTLS), 465 (TLS) |
| Uživatelské jméno | Vaše přihlašovací jméno SMTP, například …@smtp-brevo.com, nebo e-mailová adresa vašeho účtu |
emailit |
| Heslo | Klíč SMTP | Váš API klíč Emailitu |
Emailit nečte hlavičky Breva, například X-Mailin-custom nebo X-Mailin-Tag. Odstraňte je, a když potřebujete metadata, použijte API. Viz Nastavení SMTP.
Namapujte události webhooků
| Událost Breva | Událost Emailitu |
|---|---|
request (odesláno) |
email.accepted (jen API) |
delivered |
email.delivered |
deferred |
email.attempted |
soft_bounce |
email.attempted, dokud Emailit opakuje doručení, pak email.bounced, pokud selžou všechny pokusy |
hard_bounce |
email.bounced |
invalid_email |
Chyba v odpovědi API u chybně zapsané adresy, nebo email.bounced, pokud adresa neexistuje |
blocked |
email.suppressed |
error |
email.failed |
spam |
email.complained |
opened, unique_opened, proxy_open |
email.loaded, posílá se při každém načtení |
click |
email.clicked |
unsubscribed, unsubscribe |
email.unsubscribed, jen u e-mailů z kampaní |
list_addition |
subscriber.created |
contact_updated, contact_deleted |
contact.updated, contact.deleted |
inboundEmailProcessed |
email.received, pak načtěte obsah přes GET /emails/{id} |
Mění se formát požadavku:
- Brevo posílá jednu událost na požadavek, nebo při zapnutém dávkování dávky až 500 událostí. Emailit posílá pole JSON s až 100 událostmi, proto tělo procházejte ve smyčce.
- Název události se přesune z
eventdotypea e-mail je vdata.object. Místomessage-idpoužívejtedata.object.id, IDem_z odpovědi na odeslání, a místoemailpoužívejtedata.object.to. Vaše hodnotymeta, které nahrazujítagsaX-Mailin-custom, jsou vdata.object.meta. - U událostí
email.loadedaemail.clickedje vdata.objectnačtení nebo proklik. Jako ID e-mailu používejtedata.object.email_ida pro příjemce a vaše hodnotymetapoužívejtedata.object.email.rcpt_toadata.object.email.meta. - Brevo webhooky nepodepisuje, chráníte je přístupovými údaji nebo tokenem. Emailit podepisuje každý požadavek: ověřujte
X-Emailit-SignaturevůčiX-Emailit-Timestampa vašemu tajnému klíčiwhsec_. Viz Podpis požadavku.
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);
}Přesuňte blokované adresy
Brevo vede dva seznamy blokovaných adres. Přeneste oba:
-
Blokované kontakty pro transakční e-maily. Vyexportujte je z Settings > Transactional emails > Blocked or Unsubscribed contacts, nebo je načtěte po stránkách přes
GET /v3/smtp/blockedContacts. Pro všechny použijte typrecipient. Brevo blokuje adresu pro jednoho odesílatele, Emailit ji blokuje pro celý workspace. -
Kontakty blokované pro kampaně. V CRM > Contacts vyfiltrujte u odběru e-mailových kampaní stav Blocklisted a vyexportujte je, nebo použijte
POST /v3/contacts/export. Pro trvalá nedoručení a stížnosti na spam použijte typrecipienta pro odhlášení typunsubscribe. Typunsubscribezastaví všechny kampaně, ale transakční e-maily propustí, proto ho nepřidávejte lidem, kteří opustili jen jeden seznam a k jinému jsou stále přihlášení. -
Sestavte jedno CSV se sloupci
email,type,reason:email,type,reason old-address@example.com,recipient,brevo hard bounce left@example.com,unsubscribe,brevo unsubscribed -
Naimportujte ho. V Email APISuppressions vyberte Import a nahrajte soubor. Každý soubor může mít až 10 000 řádků a nejvýše 8 MB. Duplicity se přeskočí.
Blokované domény nemají ekvivalent, protože Emailit blokuje přesné adresy. Viz Správa blokovaných adres.
Přesuňte kontakty
-
Vytvořte vlastní pole. Pro každý atribut kontaktu z Breva, který používáte, kromě
EMAIL,FIRSTNAMEaLASTNAME, vytvořte v Emailitu vlastní pole. Klíče se píšou malými písmeny, takže zCOMPANYse stanecompany. -
Vytvořte seznamy kontaktů, jeden pro každý seznam v Brevu, kterému posíláte kampaně.
-
Vyexportujte každý seznam z CRM > Contacts přes More actions > Export, včetně atributů a stavu odběru. Vynechte blokované kontakty a lidi, kteří se ze seznamu odhlásili.
-
Naimportujte ho. V Email MarketingContacts vyberte Import, namapujte
EMAIL,FIRSTNAME,LASTNAMEa své atributy a zvolte odpovídající seznam kontaktů. Soubory rozdělte na části nejvýše po 2 500 řádcích. Viz Import a export kontaktů.
Import přidá všechny lidi v souboru jako přihlášené odběratele, proto soubor před importem zkontrolujte, jestli neobsahuje odhlášené.
Přesuňte šablony
HTML každé šablony získáte přes GET /v3/smtp/templates/{templateId} u transakčních šablon, nebo přes GET /v3/emailCampaigns/{campaignId} u kampaní. Oba endpointy ho vracejí v htmlContent. Naimportujte ho v Email MarketingTemplates, nebo šablonu vytvořte přes API pro šablony, a dejte jí alias, například receipt.
Převeďte šablonovací jazyk Breva na Temple:
| Brevo | Emailit (Temple) |
|---|---|
{{ params.name }}, {{ params.order.total }} |
{{name}}, {{order.total}} |
{{ contact.FIRSTNAME }}, {{ contact.LASTNAME }} |
{{first_name}}, {{last_name}} v kampaních |
{{ contact.COMPANY }} |
{{cf.company}} v kampaních |
{{ params.name|default:"there" }} |
{{name|"there"}} |
{% if params.plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if params.plan == "pro" %}, {% elif %} |
Nepodporuje se. Předejte logickou hodnotu, například is_pro, a použijte {{#if is_pro}}. |
{% for item in params.items %}…{% endfor %} |
Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
Filtry, například upper nebo date |
Nepodporuje se. Hodnotu naformátujte ve svém kódu. |
{{ unsubscribe }} |
{{unsubscribe_url}} v kampaních |
{{ update_profile }} |
{{manage_subscriptions_url}} v kampaních |
{{ mirror }} |
{{webview_url}} v kampaních |
Brevo escapuje HTML, pokud nepřidáte safe. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte dřív, než je předáte. Viz Temple a Slučovací značky.
Znovu vytvořte kampaně a automatizace
Kampaně vytvořte v Email MarketingCampaigns z naimportovaných šablon. Každou automatizaci z Breva vytvořte znovu jako automatizaci Emailitu v kontextu Contact:
| Spouštěč Breva | Spouštěč Emailitu |
|---|---|
| Contact added to list, removed from list | Added to audience, Removed from audience |
| Anniversary nebo datový atribut | Date anniversary, Date in contact field |
| Form submitted | Form submitted, pro formuláře Emailitu (předběžný přístup) |
| Email opened, link clicked | Email opened, Link clicked |
| Unsubscribed from email list | Unsubscribed |
| Custom event | Custom event, v tarifech Business a Custom |
Každou automatizaci zapněte dřív, než přesunete přihlašovací formuláře, aby nové kontakty dostávaly své e-maily od prvního dne.
Změňte DNS
Přidejte doménu v Email APIDomains a publikujte záznamy Emailitu. Používají vlastní názvy (emailit._domainkey, emailit.<domain> a volitelně go a inbound), takže nejsou v konfliktu s TXT záznamem Breva brevo-code ani s jeho záznamy DKIM (brevo1._domainkey a brevo2._domainkey, nebo mail._domainkey u starších nastavení). Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.
Po přepnutí provozu odstraňte záznamy Breva pro kód, DKIM a brandovanou subdoménu a ze záznamu SPF odeberte include:spf.brevo.com nebo include:spf.sendinblue.com, pokud ho obsahuje. Pokud přijímáte poštu přes inbound parsing v Brevu, přesuňte ji nejdřív na příchozí subdoménu Emailitu.
Další kroky
- Kontrolní seznam před ostrým provozem
- Vytvoření kampaně
- Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi