Průvodce
Přechod ze SMTP2GO
Přejděte ze SMTP2GO na Emailit. Vyměňte uživatele SMTP a servery, převeďte volání API email/send a šablony a přesuňte webhooky, blokované adresy a domény odesílatelů.
Tento průvodce mapuje pojmy, nastavení SMTP, volání API, webhooky, blokované adresy a šablony ze SMTP2GO 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
| SMTP2GO | Emailit |
|---|---|
| Master account a subaccounts | Účet a workspace. Každý workspace má vlastní domény, klíče, členy a kredity. |
| SMTP users | Váš API klíč použitý jako heslo k SMTP. Pro každou aplikaci nebo server vytvořte jeden klíč. |
| API keys s oprávněními pro endpointy | API klíče: Full Access, nebo Sending Only, volitelně omezený na jednu doménu |
| Autentizace podle IP a adresy | Není dostupné. Každé připojení SMTP se autentizuje API klíčem. |
| Sender domains | Odesílací domény |
| Single sender emails | Není dostupné. Každá adresa odesílatele musí být na ověřené doméně. |
| Stav sandbox u uživatele SMTP nebo API klíče | Nové workspace jsou v režimu sandbox a doručují jen členům workspace. |
| Nastavení měření a patičky pro odhlášení u každého uživatele SMTP nebo API klíče | Měření pro každou odesílací doménu. Emailit nepřidává patičku pro odhlášení do e-mailů z API ani SMTP. |
| Templates | Šablony s aliasem a verzemi vykreslované jazykem Temple |
| Webhooks | Webhooky |
| Suppressions adres a domén | Blokace adres |
| Reports a activity | Email APIEmails a Email APILogs |
| Dedicated IPs a IP pools | Dedikované IP adresy na vyžádání |
Pokud u newsletterů spoléháte na patičku pro odhlášení ze SMTP2GO, přidejte vlastní odkaz pro odhlášení a hlavičky List-Unsubscribe, nebo je odesílejte jako kampaně Emailitu, které hlavičky přidají za vás. V kampaních přidejte viditelný odkaz pomocí {{unsubscribe_url}}. Viz Hlavičky a odpovědi SMTP.
Změňte nastavení SMTP
| Nastavení | SMTP2GO | Emailit |
|---|---|---|
| Server | mail.smtp2go.com, nebo regionální server, například mail-eu.smtp2go.com |
smtp.emailit.com |
| Port | 2525, 587, 25, 8025 nebo 80 (STARTTLS), 465, 8465 nebo 443 (TLS) |
587, 2587, 2525 nebo 25 (STARTTLS), 465 (TLS) |
| Uživatelské jméno | Uživatelské jméno uživatele SMTP | emailit |
| Heslo | Heslo uživatele SMTP | Váš API klíč Emailitu |
Emailit nenaslouchá na portech 80, 443, 8025 ani 8465. Pokud vaše síť blokuje 25 a 587, použijte 2525 nebo 2587. Každý příjemce se v Emailitu stane samostatným e-mailem a odpověď 250 uvádí jejich ID, nebo při velkém počtu příjemců jen první ID. Viz Nastavení SMTP a Hlavičky a odpovědi SMTP.
Upravte volání API
Z POST /v3/email/send v SMTP2GO se stane POST /v2/emails. Adresy zůstávají řetězci, ale mění se názvy polí:
curl https://api.smtp2go.com/v3/email/send \
-H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender": "Acme <hello@acme.com>",
"to": ["ada@example.com"],
"subject": "Your receipt",
"text_body": "Thanks for your order.",
"html_body": "<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>"
}'| SMTP2GO | Emailit |
|---|---|
Hlavička X-Smtp2go-Api-Key, api_key v těle nebo Authorization: Bearer api-… |
Authorization: Bearer secret_… |
sender |
from |
to, cc, bcc |
to, cc, bcc, každé až 50 |
custom_headers s Reply-To |
reply_to |
custom_headers: [{ "header": "…", "value": "…" }] |
headers: { "Name": "Value" } |
subject |
subject |
text_body, html_body |
text, html |
attachments[] s filename, fileblob nebo url a mimetype |
attachments[] s filename, content nebo url a content_type |
inlines[] |
attachments[] s content_id, na který v HTML odkazujete jako cid: |
template_id a template_data |
template (alias nebo ID) a variables |
schedule (nejvýše 3 dny dopředu) |
scheduled_at (ISO 8601 nebo běžná angličtina) |
fastaccept |
Není potřeba. Emailit každý e-mail zařadí do fronty k doručení a odpoví, aniž by na doručení čekal. |
POST /v3/email/batch (až 1 000 e-mailů) |
Není dostupné. Odešlete jeden požadavek na zprávu. |
POST /v3/email/mime |
Odešlete zprávu MIME přes SMTP relay |
200 s email_id, succeeded, failed a failures |
200 s id (em_…), status: "accepted" a u více příjemců ids s jedním ID pro každého. Chyby používají stavové kódy HTTP. |
SMTP2GO nemá metadata ani nastavení měření pro jednotlivé e-maily. V Emailitu přidejte meta, aby se vám vlastní hodnoty vracely v událostech webhooků, a tracking: { "loads": true, "clicks": true }, pokud chcete přepsat nastavení měření domény. Přidejte hlavičku Idempotency-Key, aby bylo opakování bezpečné. Viz Odeslání e-mailu.
Namapujte události webhooků
| Událost SMTP2GO | Událost Emailitu |
|---|---|
processed |
email.accepted (jen API) |
delivered |
email.delivered |
bounce, kde bounce je soft |
email.attempted, dokud Emailit opakuje doručení, pak email.bounced, pokud selžou všechny pokusy |
bounce, kde bounce je hard |
email.bounced |
reject |
email.suppressed, když má adresa blokaci typu recipient. Jiná odmítnutí, například neověřený odesílatel, jsou chyby v odpovědi API nebo v odpovědi SMTP. |
spam |
email.complained |
open |
email.loaded |
click |
email.clicked |
unsubscribe |
email.unsubscribed, jen u e-mailů z kampaní |
Mění se formát požadavku:
- SMTP2GO posílá jednu událost na požadavek, ve výchozím nastavení jako pole formuláře, nebo jako plochý JSON. 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
eventdotypea e-mail je vdata.object. Místoemail_idpoužívejtedata.object.id, IDem_z odpovědi na odeslání nebo z odpovědi SMTP, a místorcptpoužívejtedata.object.to. Hodnoty, které jste předali vmeta, jsou 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. - SMTP2GO webhooky nepodepisuje. Emailit podepisuje každý požadavek: ověřujte
X-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 blokované adresy z Reports > Suppressions přes Export, nebo je načtěte po stránkách přes
POST /v3/suppression/view. Pokud nenastavítestart_date, API vrací zhruba posledních 30 dní, proto ho nastavte tak, aby pokrylo celou vaši historii. -
Sestavte jedno CSV se sloupci
email,type,reason:Důvod v SMTP2GO Typ v Emailitu bounce,spam,manualrecipient, který blokuje odeslání přes API, SMTP i kampaněunsubscribeunsubscribe, který zastaví kampaně, ale transakční e-maily propustí. Pokud se člověk odhlásil ze všeho, co posíláte, použijterecipient.email,type,reason old-address@example.com,recipient,smtp2go bounce left@example.com,unsubscribe,smtp2go unsubscribe -
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 blokuje přesné adresy, takže blokace domén naimportovat nelze. Export zopakujte pro každý podúčet a naimportujte ho do odpovídajícího workspace. Viz Správa blokovaných adres.
Přesuňte šablony
HTML každé šablony získáte přes POST /v3/template/view, který vrací html_body, text_body a subject, nebo ho zkopírujte z Settings > Templates. Naimportujte ho v Email MarketingTemplates, nebo šablonu vytvořte přes API pro šablony, a jako alias použijte ID šablony ze SMTP2GO, pokud odpovídá formátu aliasu: malá písmena, číslice, - a _.
SMTP2GO při odeslání šablony ignoruje subject. Emailit použije předmět šablony, pokud ho požadavek neobsahuje, proto subject vynechte, pokud chcete zachovat předmět šablony.
Šablony SMTP2GO používají Handlebars. Temple pokrývá běžné části:
| SMTP2GO (Handlebars) | Emailit (Temple) |
|---|---|
{{ username }}, {{ user.name }} |
{{username}}, {{user.name}} |
{{{ html_block }}} |
{{html_block}}. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte sami. |
{{#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. |
| Bez vestavěné výchozí hodnoty | {{username|"there"}} přidá náhradní hodnotu |
template_data |
variables |
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 s CNAME záznamem DKIM SMTP2GO s<number>._domainkey, s jeho CNAME záznamem return path em<number> ani s jeho CNAME záznamem pro měření link. Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.
Po přepnutí provozu odstraňte CNAME záznamy SMTP2GO a ze záznamu SPF odeberte include:spf.smtp2go.com, pokud ho ještě obsahuje.
Další kroky
- Kontrolní seznam před ostrým provozem
- Řešení problémů se SMTP
- Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi