# 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](/cs/docs/migrate/), přečtěte si ji jako první.

## Principy

| Mailjet | Emailit |
| --- | --- |
| Primary API key a API keys pro sub-accounts | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| Pár API klíčů (veřejný a tajný klíč) | [API klíč](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| Senders: jednotlivé adresy a celé domény | [Odesílací domény](/cs/docs/domains/). Jednotlivé adresy odesílatelů nejsou dostupné. |
| `SandboxMode` | Testovací režim neexistuje. Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a doručují jen členům workspace. |
| Templates a šablonovací jazyk Mailjetu | [Šablony](/cs/docs/templates/) s aliasem a verzemi vykreslované jazykem [Temple](/cs/docs/templates/temple/) |
| Event API, jedna URL pro každý typ události | [Webhooky](/cs/docs/webhooks/): jeden endpoint může přijímat všechny typy událostí |
| Parse API | [Příchozí e-maily](/cs/docs/inbound/) |
| Exclusion list, spam complainers a blocked addresses | [Blokované adresy](/cs/docs/suppressions/) |
| Contacts, contact lists a contact properties | [Kontakty](/cs/docs/contacts/), [seznamy kontaktů](/cs/docs/audiences/) a [vlastní pole](/cs/docs/contacts/custom-fields/) |
| Segments | V každé kampani vyberte zahrnuté a vyloučené seznamy kontaktů. [Segmenty](/cs/docs/segments/) jsou v alfaverzi a otevřené jen týmu Emailitu. |
| Campaigns a automations | [Kampaně](/cs/docs/campaigns/) a [automatizace](/cs/docs/automations/) (betaverze) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Statistics a message history | **Email API → Emails**, **Email API → Logs** a [reporty kampaní](/cs/docs/campaigns/reports/) |

## 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:

```bash title="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>"
    }]
  }'
```

```bash title="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 "` |
| `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](/cs/docs/email-api/send-email/).

## 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](/cs/docs/smtp/settings/).

## 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}`](/cs/docs/api-reference/emails/get/) |

Emailit navíc posílá `email.accepted`, když API e-mail přijme. Viz [Typy událostí](/cs/docs/webhooks/event-types/).

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](/cs/docs/webhooks/request-signature/).

```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 API → Suppressions** 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](/cs/docs/suppressions/manage/).

## 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](/cs/docs/contacts/custom-fields/) a pro každý seznam [seznam kontaktů](/cs/docs/audiences/).

2. **Naimportujte přihlášené členy.** V **Email Marketing → Contacts** 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ů](/cs/docs/contacts/import-export/).

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 Marketing → Campaigns** 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 Marketing → Templates**, nebo šablonu vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/), 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](/cs/docs/templates/temple/) a [Import a export šablon](/cs/docs/templates/import-export/).

## Změňte DNS

Přidejte doménu v **Email API → Domains** 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](/cs/docs/domains/dns-records/).

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í](/cs/docs/tracking/custom-tracking-domain/).

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](/cs/docs/inbound/set-up/) Emailitu.

## Další kroky

- [Kontrolní seznam před ostrým provozem](/cs/docs/get-started/go-live/)
- [Nastavení webhooku](/cs/docs/webhooks/set-up/)
- [Prioritní migrace](/cs/docs/programs/priority-migration/): nechte inženýry Emailitu provést přechod s vámi

---
Zdroj: https://emailit.com/cs/docs/migrate/mailjet/
