Průvodce
Přechod z Mailjetu
Přejděte z Mailjetu na Emailit. Namapujte páry API klíčů a odesílatele, převeďte volání Send API v3.1 a šablonovací jazyk, změňte nastavení SMTP a přesuňte webhooky, vyloučené adresy a seznamy kontaktů.
Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy, šablony a kontakty z Mailjetu 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
| Mailjet | Emailit |
|---|---|
| Primary API key a API keys pro sub-accounts | Účet a workspace. Každý workspace má vlastní domény, klíče, členy a kredity. |
| Pár API klíčů (veřejný a tajný klíč) | API klíč: Full Access, nebo Sending Only, volitelně omezený na jednu doménu |
| Senders: jednotlivé adresy a celé domény | Odesílací domény. Jednotlivé adresy odesílatelů nejsou dostupné. |
SandboxMode |
Testovací režim neexistuje. Nové workspace jsou v režimu sandbox a doručují jen členům workspace. |
| Templates a šablonovací jazyk Mailjetu | Šablony s aliasem a verzemi vykreslované jazykem Temple |
| Event API, jedna URL pro každý typ události | Webhooky: jeden endpoint může přijímat všechny typy událostí |
| Parse API | Příchozí e-maily |
| Exclusion list, spam complainers a blocked addresses | Blokované adresy |
| Contacts, contact lists a contact properties | Kontakty, seznamy kontaktů a vlastní pole |
| Segments | V každé kampani vyberte zahrnuté a vyloučené seznamy kontaktů. Segmenty jsou v alfaverzi a otevřené jen týmu Emailitu. |
| Campaigns a automations | Kampaně a automatizace (betaverze) |
CustomID, EventPayload, CustomCampaign |
meta |
| Statistics a message history | Email APIEmails, Email APILogs a reporty kampaní |
Upravte volání API
POST /v3.1/send v Mailjetu přijímá základní autentizaci a seznam Messages s poli v PascalCase. POST /v2/emails v Emailitu přijímá bearer token a jednu zprávu s poli psanými malými písmeny:
curl https://api.mailjet.com/v3.1/send \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
-H "Content-Type: application/json" \
-d '{
"Messages": [{
"From": { "Email": "hello@acme.com", "Name": "Acme" },
"To": [{ "Email": "ada@example.com" }],
"Subject": "Your receipt",
"TextPart": "Thanks for your order.",
"HTMLPart": "<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>"
}'| Mailjet (Send API v3.1) | Emailit |
|---|---|
| Základní autentizace veřejným a tajným klíčem | Authorization: Bearer secret_… |
api.mailjet.com, nebo api.us.mailjet.com pro účty v USA |
Jeden server, api.emailit.com |
Messages[], až 50 na volání |
Jedna zpráva na požadavek |
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 |
ReplyTo |
reply_to |
Subject, TextPart, HTMLPart |
subject, text, html |
Headers |
headers |
Attachments[] s ContentType, Filename, Base64Content |
attachments[] s content_type, filename, content |
InlinedAttachments[] s ContentID |
attachments[] s content_id, na který v HTML odkazujete jako cid: |
CustomID, EventPayload, CustomCampaign |
meta, například meta: { "custom_id": "order-123" }, vrací se v událostech webhooků |
TemplateID, TemplateLanguage: true a Variables |
template (alias nebo ID) a variables |
TrackOpens, TrackClicks |
tracking: { "loads": true, "clicks": true } |
URLTags |
Přidejte do svých odkazů UTM parametry. Kampaně je přidávají za vás. |
Globals |
Není dostupné. Sdílená pole opakujte v každém požadavku. |
Odpověď s MessageUUID a MessageID 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 |
ID v Emailitu jsou řetězce, takže už nemusíte ošetřovat velká celá čísla v MessageID Mailjetu. Emailit navíc podporuje plánování přes scheduled_at a bezpečné opakování požadavků s hlavičkou Idempotency-Key. Viz Odeslání e-mailu.
Změňte nastavení SMTP
| Nastavení | Mailjet | Emailit |
|---|---|---|
| Server | in-v3.mailjet.com |
smtp.emailit.com |
| Port | 587, 588, 2525, 25 nebo 80 (STARTTLS), 465 (TLS) |
587, 2587, 2525 nebo 25 (STARTTLS), 465 (TLS) |
| Uživatelské jméno | Váš veřejný API klíč | emailit |
| Heslo | Váš tajný API klíč | Váš API klíč Emailitu |
Emailit nečte hlavičky Mailjetu, například X-Mailjet-Campaign, X-MJ-CustomID, X-MJ-EventPayload, X-Mailjet-TrackOpen, X-Mailjet-TrackClick, X-MJ-TemplateID nebo X-MJ-Vars. 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 Mailjetu | Událost Emailitu |
|---|---|
sent |
email.delivered |
bounce |
email.bounced. Emailit navíc posílá email.attempted pro každý neúspěšný pokus, který opakuje. |
blocked |
email.suppressed, když má adresa blokaci typu recipient |
spam |
email.complained |
open |
email.loaded |
click |
email.clicked |
unsub |
email.unsubscribed, jen u e-mailů z kampaní |
| Route v Parse API | email.received, pak načtěte obsah přes GET /emails/{id} |
Emailit navíc posílá email.accepted, když API e-mail přijme. Viz Typy událostí.
Mění se formát požadavku:
- Mailjet potřebuje pro každý typ události jednu URL a posílá jednu událost na požadavek, pokud události neseskupíte. Webhook Emailitu může odebírat mnoho typů událostí a 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ístoMessageIDneboMessage_GUIDpoužívejtedata.object.id, IDem_z odpovědi na odeslání, a místoemailpoužívejtedata.object.to. Vaše hodnotymeta, které nahrazujíCustomIDaPayload, 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. - Mailjet své požadavky nepodepisuje. Emailit podepisuje každý: ověřujte
X-Emailit-SignaturevůčiX-Emailit-Timestampa vašemu tajnému klíčiwhsec_a přístupové údaje pro základní autentizaci můžete z URL odebrat. 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
Mailjet nemá jeden seznam blokovaných adres, proto adresy posbírejte z několika míst:
-
Shromážděte adresy, které Mailjet blokuje:
Mailjet Jak vyexportovat Typ v Emailitu Exclusion list Stažení exclusion listu v ovládacím panelu, nebo GET /v3/REST/contact?IsExcludedFromCampaigns=trueunsubscribe, který zastaví kampaně, ale transakční e-maily propustí, stejně jako exclusion list MailjetuSpam complainers Kontakty s nastaveným IsSpamComplainingzGET /v3/REST/contactrecipientHard bounces Události bounce, které uložily vaše webhooky, nebo vaše reporty kampanírecipient -
Sestavte jedno CSV se sloupci
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintTyp
recipientblokuje odeslání přes API, SMTP i kampaně. -
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čí.
Pokud jste používali několik API klíčů Mailjetu, zopakujte to pro každý z nich. Viz Správa blokovaných adres.
Přesuňte kontakty
Vyexportujte každý seznam kontaktů z Contacts v Mailjetu, nebo přes GET /v3/REST/listrecipient?ContactsList={id}, který u každého člena uvádí příznak IsUnsubscribed. Vlastnosti kontaktů získáte z GET /v3/REST/contactdata.
-
Připravte Emailit. Pro každou vlastnost kontaktu, kterou používáte, vytvořte vlastní pole a pro každý seznam seznam kontaktů.
-
Naimportujte přihlášené členy. V Email MarketingContacts vyberte Import, namapujte sloupce a zvolte odpovídající seznam kontaktů. Soubory rozdělte na části nejvýše po 2 500 řádcích. Viz Import a export kontaktů.
-
Zbytek zablokujte. Import přidá všechny lidi v souboru jako přihlášené odběratele, proto odhlášené členy do souboru nedávejte. Místo toho je přidejte do souboru s blokovanými adresami s typem
unsubscribea kontakty, jejichž přihlášení ještě čeká na potvrzení, vynechte. Blokace typuunsubscribezastaví všechny kampaně, proto ji nepřidávejte lidem, kteří jsou stále přihlášení k jinému seznamu, který přesouváte.
Kampaně a automatizace znovu vytvořte v Email MarketingCampaigns a Automations a vyjděte přitom z naimportovaných šablon.
Přesuňte šablony
HTML každé šablony získáte přes GET /v3/REST/template/{id}/detailcontent, který vrací Html-part a Text-part, nebo ho zkopírujte z editoru Mailjetu. Naimportujte ho v Email MarketingTemplates, nebo šablonu vytvořte přes API pro šablony, a dejte jí alias, například receipt.
Převeďte šablonovací jazyk Mailjetu na Temple:
| Mailjet | Emailit (Temple) |
|---|---|
{{var:name}}, {{var:order.total}} |
{{name}}, {{order.total}} |
{{var:name:"there"}} |
{{name|"there"}} |
{{data:firstname}} (vlastnost kontaktu) |
{{first_name}} nebo {{cf.<key>}} v kampaních. Při odesílání přes API předejte hodnotu ve variables. |
{% if var:plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if var:plan == "pro" %}, {% elseif %} |
Nepodporuje se. Předejte logickou hodnotu, například is_pro, a použijte {{#if is_pro}}. |
{% for item in var:items %}…{% endfor %} |
Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
Funkce, například Upper() nebo FormatNumber() |
Nepodporuje se. Hodnotu naformátujte ve svém kódu. |
{{mj:unsub_link}} |
{{unsubscribe_url}} v kampaních |
Variables |
variables |
Temple nikdy neescapuje HTML, 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áznamem DKIM Mailjetu mailjet._domainkey ani s jeho TXT záznamem pro ověření vlastnictví. Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.
Pokud už vaše vlastní doména pro měření v Mailjetu používá název go, zvolte pro doménu Emailitu jiný název přes tracking_key. Viz Nastavení vlastní domény pro měření.
Po přepnutí provozu odstraňte záznamy Mailjetu pro DKIM, ověření vlastnictví, měření a return path a ze záznamu SPF odeberte include:spf.mailjet.com. Pokud přijímáte poštu přes Parse API na vlastní doméně, 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