Přejít na obsah
Dokumentace

Průvodce

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ů.

Aktualizováno 23. 10. 2026

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:

Před: Mailjet
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>"
    }]
  }'
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>"
  }'
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 event do type a e-mail je v data.object. Místo MessageID nebo Message_GUID používejte data.object.id, ID em_ z odpovědi na odeslání, a místo email používejte data.object.to. Vaše hodnoty meta, které nahrazují CustomID a Payload, 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.
  • Mailjet své požadavky nepodepisuje. Emailit podepisuje každý: ověřujte X-Emailit-Signature vůči X-Emailit-Timestamp a vašemu tajnému klíči whsec_ a přístupové údaje pro základní autentizaci můžete z URL odebrat. 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

Mailjet nemá jeden seznam blokovaných adres, proto adresy posbírejte z několika míst:

  1. 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=true unsubscribe, který zastaví kampaně, ale transakční e-maily propustí, stejně jako exclusion list Mailjetu
    Spam complainers Kontakty s nastaveným IsSpamComplaining z GET /v3/REST/contact recipient
    Hard bounces Události bounce, které uložily vaše webhooky, nebo vaše reporty kampaní recipient
  2. Sestavte jedno CSV se sloupci email,type,reason:

    CSV
    email,type,reason
    excluded@example.com,unsubscribe,mailjet exclusion list
    angry@example.com,recipient,mailjet spam complaint

    Typ recipient blokuje odeslání přes API, SMTP i kampaně.

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

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.

  1. Připravte Emailit. Pro každou vlastnost kontaktu, kterou používáte, vytvořte vlastní pole a pro každý seznam seznam kontaktů.

  2. 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ů.

  3. 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 unsubscribe a kontakty, jejichž přihlášení ještě čeká na potvrzení, vynechte. Blokace typu unsubscribe zastaví 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

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.