Průvodce
Přechod z MailerSendu
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.
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ů:
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>"
}'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 vdata.object: místodata.message_id(data.email.message.idu webhooků verze 1) používejtedata.object.id, IDem_z odpovědi na odeslání, a místodata.recipientpouží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. - Hlavička
Signaturev MailerSendu je HMAC-SHA256 ze surového těla požadavku. HlavičkaX-Emailit-Signaturev Emailitu je HMAC-SHA256 z<timestamp>.<raw body>, jehož klíčem je váš tajný klíčwhsec_, proto čtěte iX-Emailit-Timestamp. 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
-
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,/unsubscribesa/blocklist). On hold list je dočasný, takže ho můžete vynechat. -
Sestavte jedno CSV se sloupci
email,type,reason:email,type,reason old-address@example.com,recipient,mailersend hard bounce angry@example.com,recipient,mailersend spam complaintPro 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 typunsubscribe, který zastaví kampaně, ale transakční e-maily propustí. -
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
- Kontrolní seznam před ostrým provozem
- Nastavení webhooku
- Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi