Přejít na obsah
Dokumentace

Průvodce

Přejděte z MailerSendu na Emailit. Namapujte domény, tokeny a uživatele SMTP, převeďte volání API a personalizaci, změňte nastavení SMTP a přesuňte webhooky, blokované adresy a šablony.

Aktualizováno 23. 10. 2026

Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy a šablony z MailerSendu na jejich ekvivalenty v Emailitu. 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

MailerSend Emailit
Účet Účet a workspace. Každý workspace má vlastní domény, klíče, členy a kredity.
Domains Odesílací domény
Sender identities Není dostupné. Každá adresa odesílatele musí být na ověřené doméně.
API tokens s oprávněními API klíče: Full Access, nebo Sending Only, volitelně omezený na jednu doménu
SMTP users Váš API klíč použitý jako heslo k SMTP
Testovací doména a režim sandbox Sdílená testovací doména neexistuje. Nové workspace jsou v režimu sandbox a mohou odesílat jen členům workspace.
Templates Šablony s aliasem a verzemi vykreslované jazykem Temple
Webhooky pro každou doménu Webhooky pro celý workspace
Inbound routes Příchozí e-maily s webhookem email.received, nebo automatizace Forward received email
Suppressions pro každou doménu: hard bounces, spam complaints, unsubscribes, blocklist Jeden seznam blokovaných adres pro každý workspace
On hold list Není potřeba. Emailit po dočasném nedoručení opakuje doručení a každý pokus hlásí jako email.attempted.
Activity Email APIEmails a Email APILogs
Tags meta
Email verification Ověřování e-mailů
Dedicated IPs Dedikované IP adresy na vyžádání

Upravte volání API

Z POST /v1/email v MailerSendu se stane POST /v2/emails. Oba přijímají bearer token a JSON, ale adresy jsou v Emailitu prosté řetězce místo objektů:

Před: MailerSend
curl https://api.mailersend.com/v1/email \
  -H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<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>"
  }'
MailerSend Emailit
Authorization: Bearer <token> Authorization: Bearer secret_…
from: { email, name } from: "Name <email>"
to[], cc[], bcc[] s email a name to, cc, bcc jako řetězec nebo pole, každé až 50 adres
reply_to: { email, name } reply_to
subject, text, html Stejně
headers: [{ "name": "…", "value": "…" }] headers: { "Name": "Value" }
list_unsubscribe headers s List-Unsubscribe a List-Unsubscribe-Post. Viz Hlavičky a metadata.
attachments[] s content, filename, disposition a id attachments[] s content, filename a content_type, nebo s url místo content. U vložených obrázků použijte content_id.
template_id template, ID nebo alias šablony
personalization: [{ "email": "…", "data": { … } }] variables, s jedním požadavkem na příjemce, když se hodnoty liší
tags meta, vrací se v událostech webhooků
send_at (unixový čas nebo ISO 8601) scheduled_at (ISO 8601 nebo běžná angličtina). Unixový čas nejdřív převeďte na ISO 8601.
settings.track_opens, settings.track_clicks tracking: { "loads": true, "clicks": true }
POST /v1/bulk-email Není dostupné. Odešlete jeden požadavek na zprávu.
202 Accepted s hlavičkou x-message-id a prázdným tělem 200 s tělem JSON: id (em_…), status: "accepted" a u více příjemců ids s jedním ID pro každého

Každý příjemce v požadavku Emailitu se stane samostatným e-mailem s vlastním ID. MailerSend odpoví 202, i když jsou všichni příjemci zablokovaní, a v těle uvede varování. Emailit příjemce s blokací typu recipient také přijme a každému z nich dá stav suppressed. Přidejte hlavičku Idempotency-Key, aby bylo opakování bezpečné. Viz Odeslání e-mailu.

Změňte nastavení SMTP

Nastavení MailerSend Emailit
Server smtp.mailersend.net smtp.emailit.com
Port 587 (STARTTLS) 587, 2587, 2525 nebo 25 (STARTTLS), 465 (TLS)
Uživatelské jméno Vygenerované uživatelské jméno uživatele SMTP emailit
Heslo Heslo uživatele SMTP Váš API klíč Emailitu

Emailit nečte hlavičku X-MailerSend-Tags. Odstraňte ji. Na rozdíl od MailerSendu Emailit vaše ostatní vlastní hlavičky doručí beze změny. Viz Nastavení SMTP.

Namapujte události webhooků

Událost MailerSendu Událost Emailitu
activity.sent email.accepted (jen API)
activity.delivered email.delivered
activity.deferred email.attempted
activity.soft_bounced email.attempted, dokud Emailit opakuje doručení, pak email.bounced, pokud selžou všechny pokusy
activity.hard_bounced email.bounced
activity.suppressed email.suppressed
activity.opened, activity.opened_unique email.loaded, posílá se při každém načtení
activity.clicked, activity.clicked_unique email.clicked, posílá se při každém prokliku
activity.spam_complaint email.complained
activity.unsubscribed email.unsubscribed, jen u e-mailů z kampaní
Inbound route, která přeposílá na webhook email.received, pak načtěte obsah přes GET /emails/{id}

Mění se formát požadavku:

  • MailerSend posílá jednu událost na požadavek. Emailit posílá pole JSON s až 100 událostmi, proto tělo procházejte ve smyčce.
  • Název události je u obou v type. E-mail je v Emailitu v data.object: místo data.message_id (data.email.message.id u webhooků verze 1) používejte data.object.id, ID em_ z odpovědi na odeslání, a místo data.recipient používejte data.object.to. Vaše hodnoty meta 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.
  • Hlavička Signature v MailerSendu je HMAC-SHA256 ze surového těla požadavku. Hlavička X-Emailit-Signature v Emailitu je HMAC-SHA256 z <timestamp>.<raw body>, jehož klíčem je váš tajný klíč whsec_, proto čtěte i X-Emailit-Timestamp. 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

  1. V MailerSendu vyexportujte Hard bounces, Spam complaints, Unsubscribes a Blocklist každé domény, ze stránek suppressions nebo přes API (/v1/suppressions/hard-bounces, /spam-complaints, /unsubscribes a /blocklist). On hold list je dočasný, takže ho můžete vynechat.

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

    CSV
    email,type,reason
    old-address@example.com,recipient,mailersend hard bounce
    angry@example.com,recipient,mailersend spam complaint

    Pro adresy, které nikdy nesmí dostat e-mail, použijte typ recipient. Blokuje odeslání přes API, SMTP i kampaně. Pro lidi, kteří se odhlásili jen z marketingových e-mailů, použijte typ unsubscribe, který zastaví kampaně, ale transakční e-maily propustí.

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

Emailit má jeden seznam blokovaných adres pro každý workspace, takže adresy ze všech vašich domén v MailerSendu půjdou do stejného seznamu. Blokace platí pro přesné adresy: vzory z blocklistu, například .*@example.com, nemají ekvivalent. Viz Správa blokovaných adres.

Přesuňte šablony

Zkopírujte HTML každé šablony z editoru MailerSendu a pak ho naimportujte v Email MarketingTemplates, nebo šablonu vytvořte přes API pro šablony. Dejte jí alias, například receipt, a odesílejte ji s "template": "receipt" a variables.

Personalizace v MailerSendu je omezená verze jazyka Twig. Temple pokrývá běžné části:

MailerSend Emailit (Temple)
{{ name }}, {{ user.name }} {{name}}, {{user.name}}
{{ name|default('there') }} {{name|"there"}}
{% if plan %}…{% else %}…{% endif %} {{#if plan}}…{{else}}…{{/if}}
{% if plan == "pro" %}, {% elseif %} Nepodporuje se. Předejte logickou hodnotu, například is_pro, a použijte {{#if is_pro}}.
{% for item in items %}…{% endfor %} Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou.
{{ name|upper }} a další filtry Nepodporuje se. Hodnotu naformátujte ve svém kódu.
personalization[].data variables

MailerSend z hodnot personalizace odstraňuje většinu HTML. Temple HTML nikdy neescapuje ani neodstraňuje, proto vstupy od uživatelů escapujte dřív, než je předáte. Viz Temple a Import a export šablon.

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 se záznamy DKIM MailerSendu ms1._domainkey a ms2._domainkey, s jeho CNAME záznamem return path mta ani s jeho CNAME záznamem pro měření email. Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.

Příchozí routing MailerSendu ve výchozím nastavení také používá subdoménu inbound. Pokud ji používá i ten váš, nastavte příchozí poště Emailitu jinou subdoménu přes inbound_key, nebo MX záznam přepněte, až budete příchozí poštu přesouvat. Viz Nastavení příchozích e-mailů.

Po přepnutí provozu odstraňte záznamy MailerSendu pro DKIM, return path a měření a ze záznamu SPF odeberte include:_spf.mailersend.net.

Další kroky

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

Děkujeme za zpětnou vazbu.

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