Přejít na obsah
Dokumentace

Průvodce

Přejděte z Mandrillu (Mailchimp Transactional) na Emailit. Namapujte API klíče a subaccounts, převeďte volání messages/send, vyměňte nastavení SMTP a hlavičky X-MC, ověřujte webhooky a přesuňte rejection denylist.

Aktualizováno 23. 10. 2026

Tento průvodce mapuje pojmy, volání API, webhooky, rejection denylist a šablony z Mandrillu (Mailchimp Transactional Email) 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í. Pokud z Mailchimpu posíláte i kampaně, viz Přechod z Mailchimpu.

Principy

Mandrill Emailit
Tarif Mailchimpu Standard nebo Premium s bloky transakčních e-mailů Účet v Emailitu. K odesílání transakčních e-mailů nepotřebujete marketingový tarif.
Subaccounts Workspace, každý s vlastními doménami, klíči, limity a kredity
API keys API klíče: Full Access, nebo Sending Only, volitelně omezený na jednu doménu
Test API keys Testovací režim neexistuje. Nové workspace jsou v režimu sandbox a mohou odesílat jen členům workspace.
Sending domains a ověření DKIM/SPF Odesílací domény
Tracking domains Subdoména pro měření, například go.acme.com
Templates s oblastmi mc:edit Šablony s aliasem a verzemi vykreslované jazykem Temple
Webhooks Webhooky
Inbound domains a routes Příchozí e-maily
Rejection denylist Blokované adresy
Rejection allowlist Není dostupné
Merge languages: Mailchimp a Handlebars Temple
Tags a metadata meta
Outbound activity Email APIEmails a Email APILogs
Dedicated IPs a IP pools Dedikované IP adresy na vyžádání

Upravte volání API

POST /messages/send v Mandrillu přijímá API klíč v těle JSON a e-mail vnořuje do message. POST /v2/emails v Emailitu přijímá bearer token a ploché tělo:

Před: Mandrill
curl https://mandrillapp.com/api/1.0/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "key": "'"$MANDRILL_API_KEY"'",
    "message": {
      "from_email": "hello@acme.com",
      "from_name": "Acme",
      "to": [{ "email": "ada@example.com", "type": "to" }],
      "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>"
  }'
Mandrill Emailit
key v těle požadavku Hlavička Authorization: Bearer secret_…
message.from_email a from_name from: "Name <email>"
message.to[] s type to, cc nebo bcc to, cc, bcc, každé až 50
message.headers["Reply-To"] reply_to
message.subject, html, text subject, html, text
message.headers headers
message.attachments[] s type, name, content attachments[] s content_type, filename, content
message.images[] pro vložené obrázky attachments[] s content_id, na které se v HTML odkazujete přes cid:
message.metadata, message.tags meta, objekt s řetězcovými hodnotami, který se vrací v událostech webhooků
message.track_opens, track_clicks tracking: { "loads": true, "clicks": true }
message.global_merge_vars variables
message.merge_vars (pro každého příjemce) Jeden požadavek na příjemce, každý s vlastními variables
message.subaccount Použijte API klíč z odpovídajícího workspace
send_at scheduled_at (ISO 8601 nebo běžná angličtina)
async Není potřeba. Emailit každý e-mail zařadí do fronty k doručení a odpoví, aniž by na doručení čekal.
POST /messages/send-template s template_name Stejný POST /v2/emails s template (alias nebo ID) a variables
Odpověď: pole s email, status a _id pro každého příjemce 200 s id (em_…), status: "accepted" a u více příjemců ids s jedním ID pro každého

Mandrill hlásí problémy v odpovědi pro každého příjemce zvlášť, se stavy jako rejected nebo invalid. Emailit validuje celý požadavek a na neplatný vstup vrací chybu HTTP. Příjemci s blokací typu recipient se přijmou a pak dostanou stav suppressed. Přidejte hlavičku Idempotency-Key, aby bylo opakování bezpečné. Viz Odeslání e-mailu.

Změňte nastavení SMTP

Nastavení Mandrill Emailit
Server smtp.mandrillapp.com smtp.emailit.com
Port 587, 2525 nebo 25 (STARTTLS), 465 (TLS) 587, 2587, 2525 nebo 25 (STARTTLS), 465 (TLS)
Uživatelské jméno Libovolná hodnota emailit
Heslo API klíč Mandrillu Váš API klíč Emailitu

Emailit nečte hlavičky X-MC-*, například X-MC-Template, X-MC-MergeVars, X-MC-Tags, X-MC-Metadata nebo X-MC-Track. Odstraňte je. Měření nastavte na doméně, a když potřebujete šablony nebo metadata, použijte API. Viz Nastavení SMTP.

Namapujte události webhooků

Událost Mandrillu Událost Emailitu
send email.accepted (jen API)
delivered email.delivered
deferral email.attempted
hard_bounce email.bounced
soft_bounce email.attempted, dokud Emailit opakuje doručení, pak email.bounced, pokud selžou všechny pokusy
open email.loaded
click email.clicked
spam email.complained
unsub email.unsubscribed, jen u e-mailů z kampaní
reject email.suppressed, když má adresa blokaci typu recipient. Jiné důvody odmítnutí, například unsigned, jsou v Emailitu chyby API.
Události synchronizace rejection denylistu suppression.created, suppression.deleted u blokací, které přidáte nebo odeberete
inbound email.received, pak načtěte obsah přes GET /emails/{id}

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

  • Mandrill posílá pole formuláře mandrill_events, které obsahuje pole JSON s až 1 000 událostmi. Emailit posílá pole JSON jako tělo požadavku, s až 100 událostmi.
  • Název události je v type a e-mail v data.object. Místo _id používejte data.object.id, ID em_ z odpovědi na odeslání, a místo msg.email 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.
  • Mandrill podepisuje URL a pole formuláře pomocí HMAC-SHA1 v kódování base64 v hlavičce X-Mandrill-Signature. Emailit podepisuje <timestamp>.<raw body> pomocí HMAC-SHA256: 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

  1. Vyexportujte celý rejection denylist tlačítkem Export Full Denylist na stránce Rejection Denylist v Mandrillu, nebo voláním API /exports/rejects. /rejects/list vrací nejvýše 1 000 záznamů, proto ho k tomu nepoužívejte. Export je soubor ZIP s rejects.csv a pokrývá všechny subaccounts.

  2. Sestavte jedno CSV se sloupci email,type,reason. Záznamy, které už vypršely, přeskočte a typ zvolte podle sloupce reason:

    Důvod v Mandrillu Typ v Emailitu
    hard-bounce, spam, custom recipient
    unsub unsubscribe, který zastaví kampaně, ale transakční e-maily propustí. Pokud chcete blokovat všechny e-maily jako Mandrill, použijte recipient.
    soft-bounce Vynechte je. Tyto záznamy vyprší po jednom dni.
    CSV
    email,type,reason
    old-address@example.com,recipient,mandrill hard-bounce
    angry@example.com,recipient,mandrill spam

    Typ recipient blokuje odeslání přes API, SMTP i kampaně. Pokud jste používali subaccounts, rozdělte soubor podle sloupce se subaccount a každou část naimportujte do odpovídajícího workspace.

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

Rejection allowlist z Mandrillu nemá ekvivalent. Viz Správa blokovaných adres.

Přesuňte šablony

Získejte kód šablon z Mandrillu: jedno volání /templates/list vrátí všechny šablony s jejich slug a publikovaným HTML v publish_code. Pak každou naimportujte v Email MarketingTemplates, nebo ji vytvořte přes API pro šablony. Jako alias použijte slug z Mandrillu, pokud odpovídá formátu aliasu: malá písmena, číslice, - a _.

Šablony s oblastmi mc:edit, které vyplňoval template_content, potřebují tyto oblasti převést na proměnné. Názvy slučovacích proměnných v Mandrillu nerozlišují velká a malá písmena, v Temple ano: {{FNAME}} odpovídá jen proměnné s názvem FNAME. Převeďte slučovací značky do jazyka Temple:

Mandrill Emailit (Temple)
*|FNAME|* (merge language Mailchimp) {{FNAME}}, nebo ji přejmenujte na {{first_name}}
{{fname}} (merge language Handlebars) {{fname}}
*|IF:FNAME|*…*|ELSE:|*…*|END:IF|* {{#if FNAME}}…{{else}}…{{/if}}
*|IF:PLAN=pro|* nebo porovnání uvnitř {{#if}} v Handlebars Nepodporuje se. Předejte logickou hodnotu, například is_pro, a použijte {{#if is_pro}}.
*|DATE:d/m/y|*, *|CURRENT_YEAR|*, helpery jako {{upper name}} Nepodporuje se. Hodnotu naformátujte ve svém kódu a předejte ji.
*|UNSUB:https://…|*, {{unsub "…"}} Vlastní odkaz pro odhlášení. Viz Odhlášení.
{{#if plan}}…{{else}}…{{/if}} Stejně
{{#each items}}…{{/each}} Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou.
<div mc:edit="body">…</div> s template_content {{body}}, předaná ve variables
global_merge_vars variables

Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte dřív, než je předáte. Chybějící hodnota se vykreslí jako prázdný řetězec, pokud nepřidáte výchozí hodnotu, například {{name|"there"}}. Viz Temple.

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 CNAME záznamy mte1._domainkey a mte2._domainkey Mandrillu ani s jeho TXT záznamem mandrill_verify. Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.

Po přepnutí provozu odstraňte záznamy DKIM a ověřovací záznamy Mandrillu, případné vlastní CNAME záznamy pro měření nebo return path a include:spf.mandrillapp.com, pokud ho váš záznam SPF obsahuje. Pokud přijímáte poštu přes inbound routes v Mandrillu, 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.