Přejít na obsah
Dokumentace

Průvodce

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.

Aktualizováno 23. 10. 2026

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í:

Před: 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>"
  }'
Po: 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
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 event do type a e-mail je v data.object. Místo message-id používejte data.object.id, ID em_ z odpovědi na odeslání, a místo email používejte data.object.to. Vaše hodnoty meta, které nahrazují tags a X-Mailin-custom, jsou v data.object.meta.
  • U událostí email.loaded a email.clicked je v data.object načtení nebo proklik. Jako ID e-mailu používejte data.object.email_id a pro příjemce a vaše hodnoty meta používejte data.object.email.rcpt_to a data.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-Signature vůči X-Emailit-Timestamp a vašemu tajnému klíči whsec_. Viz Podpis požadavku.
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);
}

Přesuňte blokované adresy

Brevo vede dva seznamy blokovaných adres. Přeneste oba:

  1. 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 typ recipient. Brevo blokuje adresu pro jednoho odesílatele, Emailit ji blokuje pro celý workspace.

  2. 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 typ recipient a pro odhlášení typ unsubscribe. Typ unsubscribe zastaví 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í.

  3. Sestavte jedno CSV se sloupci email,type,reason:

    CSV
    email,type,reason
    old-address@example.com,recipient,brevo hard bounce
    left@example.com,unsubscribe,brevo unsubscribed
  4. 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

  1. Vytvořte vlastní pole. Pro každý atribut kontaktu z Breva, který používáte, kromě EMAIL, FIRSTNAME a LASTNAME, vytvořte v Emailitu vlastní pole. Klíče se píšou malými písmeny, takže z COMPANY se stane company.

  2. Vytvořte seznamy kontaktů, jeden pro každý seznam v Brevu, kterému posíláte kampaně.

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

  4. Naimportujte ho. V Email MarketingContacts vyberte Import, namapujte EMAIL, FIRSTNAME, LASTNAME a 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

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.