Průvodce
Přechod z Mandrillu
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.
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:
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>"
}
}'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
typea e-mail vdata.object. Místo_idpoužívejtedata.object.id, IDem_z odpovědi na odeslání, a místomsg.emailpoužívejtedata.object.to. Vaše hodnotymetajsou 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. - 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ěřujteX-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
-
Vyexportujte celý rejection denylist tlačítkem Export Full Denylist na stránce Rejection Denylist v Mandrillu, nebo voláním API
/exports/rejects./rejects/listvrací nejvýše 1 000 záznamů, proto ho k tomu nepoužívejte. Export je soubor ZIP srejects.csva pokrývá všechny subaccounts. -
Sestavte jedno CSV se sloupci
email,type,reason. Záznamy, které už vypršely, přeskočte a typ zvolte podle sloupcereason:Důvod v Mandrillu Typ v Emailitu hard-bounce,spam,customrecipientunsubunsubscribe, který zastaví kampaně, ale transakční e-maily propustí. Pokud chcete blokovat všechny e-maily jako Mandrill, použijterecipient.soft-bounceVynechte je. Tyto záznamy vyprší po jednom dni. email,type,reason old-address@example.com,recipient,mandrill hard-bounce angry@example.com,recipient,mandrill spamTyp
recipientblokuje 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. -
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
- Kontrolní seznam před ostrým provozem
- Nastavení webhooku
- Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi