# Přechod z Breva

> Přejděte z Breva (dříve Sendinblue) na Emailit. Převeďte volání API smtp/email a šablonovací jazyk, vyměňte klíče SMTP a přesuňte webhooky, blokované adresy, kontakty, kampaně a automatizace.

Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy, šablony, kontakty a automatizace z Breva na jejich ekvivalenty v Emailitu. Brevo se do roku 2023 jmenovalo Sendinblue a některé jeho servery a hlavičky tento název stále používají. 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

| Brevo | Emailit |
| --- | --- |
| Účet a sub-accounts | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| API keys | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| Přihlašovací jméno SMTP a klíče SMTP | Váš API klíč použitý jako heslo k SMTP |
| Senders ověřené jednotlivě nebo přes ověřenou doménu | [Odesílací domény](/cs/docs/domains/). Jednotlivé adresy odesílatelů nejsou dostupné. |
| Hlavička `X-Sib-Sandbox` | 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 Breva | [Šablony](/cs/docs/templates/) s aliasem a verzemi vykreslované jazykem [Temple](/cs/docs/templates/temple/) |
| Transakční, marketingové a příchozí webhooky | [Webhooky](/cs/docs/webhooks/) |
| Inbound parsing | [Příchozí e-maily](/cs/docs/inbound/) |
| Blocked contacts (transakční e-maily) a blocklisted contacts (kampaně) | [Blokované adresy](/cs/docs/suppressions/) |
| Contacts, attributes a lists | [Kontakty](/cs/docs/contacts/), [vlastní pole](/cs/docs/contacts/custom-fields/) a [seznamy kontaktů](/cs/docs/audiences/) |
| 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. |
| Email campaigns | [Kampaně](/cs/docs/campaigns/) |
| Automations | [Automatizace](/cs/docs/automations/) (betaverze) |
| Forms | [Formuláře](/cs/docs/forms/) (předběžný přístup), nebo [URL pro přihlášení](/cs/docs/audiences/subscribe-url/) seznamu kontaktů |
| `tags` a hlavička `X-Mailin-custom` | `meta` |
| Dedicated IPs | [Dedikované IP adresy](/cs/docs/deliverability/dedicated-ips/) na vyžádání |

## Upravte volání API

Z `POST /v3/smtp/email` v Brevu se stane `POST /v2/emails`. Klíč se přesune z hlavičky `api-key` do `Authorization` a názvy polí se zkrátí:

```bash title="Před: Brevo"
curl https://api.brevo.com/v3/smtp/email \
  -H "api-key: $BREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "textContent": "Thanks for your order.",
    "htmlContent": "<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>"
  }'
```

| Brevo | Emailit |
| --- | --- |
| Hlavička `api-key: xkeysib-…` | `Authorization: Bearer secret_…` |
| `sender: { email, name }` nebo `sender: { id }` | `from: "Name "` |
| `to`, `cc`, `bcc` s `email` a `name` | `to`, `cc`, `bcc` jako řetězec nebo pole, každé až 50 adres |
| `replyTo: { email, name }` | `reply_to` |
| `subject`, `htmlContent`, `textContent` | `subject`, `html`, `text` |
| `headers` | `headers` |
| `attachment[]` s `content` a `name`, nebo s `url` | `attachments[]` s `content`, `filename` a `content_type`, nebo s `url` |
| `templateId` a `params` | `template` (alias nebo ID) a `variables` |
| `tags`, `headers["X-Mailin-custom"]` | `meta`, vrací se v událostech webhooků |
| `scheduledAt` (nejvýše 72 hodin dopředu) | `scheduled_at` (ISO 8601 nebo běžná angličtina) |
| `headers.idempotencyKey` (uchovává se 30 minut) | Hlavička HTTP `Idempotency-Key`, uchovává se 24 hodin |
| `messageVersions[]` | Není dostupné. Pro každého příjemce odešlete samostatný požadavek s vlastními `variables`. |
| `headers["X-Sib-Sandbox"]` | Není dostupné |
| `201` s `messageId` | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

Brevo nemá nastavení měření pro jednotlivé e-maily. V Emailitu `tracking: { "loads": true, "clicks": true }` přepíše nastavení měření domény pro jeden e-mail. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Změňte nastavení SMTP

| Nastavení | Brevo | Emailit |
| --- | --- | --- |
| Server | `smtp-relay.brevo.com` | `smtp.emailit.com` |
| Port | `587` nebo `2525` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | Vaše přihlašovací jméno SMTP, například `…@smtp-brevo.com`, nebo e-mailová adresa vašeho účtu | `emailit` |
| Heslo | Klíč SMTP | Váš API klíč Emailitu |

Emailit nečte hlavičky Breva, například `X-Mailin-custom` nebo `X-Mailin-Tag`. Odstraňte je, a když potřebujete metadata, použijte API. Viz [Nastavení SMTP](/cs/docs/smtp/settings/).

## Namapujte události webhooků

| Událost Breva | Událost Emailitu |
| --- | --- |
| `request` (odesláno) | `email.accepted` (jen API) |
| `delivered` | `email.delivered` |
| `deferred` | `email.attempted` |
| `soft_bounce` | `email.attempted`, dokud Emailit opakuje doručení, pak `email.bounced`, pokud selžou všechny pokusy |
| `hard_bounce` | `email.bounced` |
| `invalid_email` | Chyba v odpovědi API u chybně zapsané adresy, nebo `email.bounced`, pokud adresa neexistuje |
| `blocked` | `email.suppressed` |
| `error` | `email.failed` |
| `spam` | `email.complained` |
| `opened`, `unique_opened`, `proxy_open` | `email.loaded`, posílá se při každém načtení |
| `click` | `email.clicked` |
| `unsubscribed`, `unsubscribe` | `email.unsubscribed`, jen u e-mailů z kampaní |
| `list_addition` | `subscriber.created` |
| `contact_updated`, `contact_deleted` | `contact.updated`, `contact.deleted` |
| `inboundEmailProcessed` | `email.received`, pak načtěte obsah přes [`GET /emails/{id}`](/cs/docs/api-reference/emails/get/) |

Mění se formát požadavku:

- Brevo posílá jednu událost na požadavek, nebo při zapnutém dávkování dávky až 500 událostí. 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 `event` do `type` a e-mail je v `data.object`. Místo `message-id` 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í `tags` a `X-Mailin-custom`, 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`.
- Brevo webhooky nepodepisuje, chráníte je přístupovými údaji nebo tokenem. Emailit podepisuje každý požadavek: ověřujte `X-Emailit-Signature` vůči `X-Emailit-Timestamp` a vašemu tajnému klíči `whsec_`. 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

Brevo vede dva seznamy blokovaných adres. Přeneste oba:

1. **Blokované kontakty pro transakční e-maily.** Vyexportujte je z **Settings > Transactional emails > Blocked or Unsubscribed contacts**, nebo je načtěte po stránkách přes `GET /v3/smtp/blockedContacts`. Pro všechny použijte typ `recipient`. Brevo blokuje adresu pro jednoho odesílatele, Emailit ji blokuje pro celý workspace.

2. **Kontakty blokované pro kampaně.** V **CRM > Contacts** vyfiltrujte u odběru e-mailových kampaní stav **Blocklisted** a vyexportujte je, nebo použijte `POST /v3/contacts/export`. Pro trvalá nedoručení a stížnosti na spam použijte typ `recipient` a pro odhlášení typ `unsubscribe`. Typ `unsubscribe` zastaví všechny kampaně, ale transakční e-maily propustí, proto ho nepřidávejte lidem, kteří opustili jen jeden seznam a k jinému jsou stále přihlášení.

3. **Sestavte jedno CSV** se sloupci `email,type,reason`:

```csv
email,type,reason
old-address@example.com,recipient,brevo hard bounce
left@example.com,unsubscribe,brevo unsubscribed
```

4. **Naimportujte ho.** 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čí.

Blokované domény nemají ekvivalent, protože Emailit blokuje přesné adresy. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte kontakty

1. **Vytvořte vlastní pole.** Pro každý atribut kontaktu z Breva, který používáte, kromě `EMAIL`, `FIRSTNAME` a `LASTNAME`, vytvořte v Emailitu [vlastní pole](/cs/docs/contacts/custom-fields/). Klíče se píšou malými písmeny, takže z `COMPANY` se stane `company`.

2. **Vytvořte seznamy kontaktů**, jeden pro každý seznam v Brevu, kterému posíláte kampaně.

3. **Vyexportujte každý seznam** z **CRM > Contacts** přes **More actions > Export**, včetně atributů a stavu odběru. Vynechte blokované kontakty a lidi, kteří se ze seznamu odhlásili.

4. **Naimportujte ho.** V **Email Marketing → Contacts** vyberte **Import**, namapujte `EMAIL`, `FIRSTNAME`, `LASTNAME` a své atributy 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/).

Import přidá všechny lidi v souboru jako přihlášené odběratele, proto soubor před importem zkontrolujte, jestli neobsahuje odhlášené.

## Přesuňte šablony

HTML každé šablony získáte přes `GET /v3/smtp/templates/{templateId}` u transakčních šablon, nebo přes `GET /v3/emailCampaigns/{campaignId}` u kampaní. Oba endpointy ho vracejí v `htmlContent`. 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 Breva na Temple:

| Brevo | Emailit (Temple) |
| --- | --- |
| `{{ params.name }}`, `{{ params.order.total }}` | `{{name}}`, `{{order.total}}` |
| `{{ contact.FIRSTNAME }}`, `{{ contact.LASTNAME }}` | `{{first_name}}`, `{{last_name}}` v kampaních |
| `{{ contact.COMPANY }}` | `{{cf.company}}` v kampaních |
| `{{ params.name\|default:"there" }}` | `{{name\|"there"}}` |
| `{% if params.plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if params.plan == "pro" %}`, `{% elif %}` | Nepodporuje se. Předejte logickou hodnotu, například `is_pro`, a použijte `{{#if is_pro}}`. |
| `{% for item in params.items %}…{% endfor %}` | Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
| Filtry, například `upper` nebo `date` | Nepodporuje se. Hodnotu naformátujte ve svém kódu. |
| `{{ unsubscribe }}` | `{{unsubscribe_url}}` v kampaních |
| `{{ update_profile }}` | `{{manage_subscriptions_url}}` v kampaních |
| `{{ mirror }}` | `{{webview_url}}` v kampaních |

Brevo escapuje HTML, pokud nepřidáte `safe`. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte dřív, než je předáte. Viz [Temple](/cs/docs/templates/temple/) a [Slučovací značky](/cs/docs/campaigns/merge-tags/).

## Znovu vytvořte kampaně a automatizace

Kampaně vytvořte v **Email Marketing → Campaigns** z naimportovaných šablon. Každou automatizaci z Breva vytvořte znovu jako [automatizaci](/cs/docs/automations/) Emailitu v kontextu **Contact**:

| Spouštěč Breva | Spouštěč Emailitu |
| --- | --- |
| Contact added to list, removed from list | **Added to audience**, **Removed from audience** |
| Anniversary nebo datový atribut | **Date anniversary**, **Date in contact field** |
| Form submitted | **Form submitted**, pro [formuláře Emailitu](/cs/docs/forms/) (předběžný přístup) |
| Email opened, link clicked | **Email opened**, **Link clicked** |
| Unsubscribed from email list | **Unsubscribed** |
| Custom event | **Custom event**, v tarifech Business a Custom |

Každou automatizaci zapněte dřív, než přesunete přihlašovací formuláře, aby nové kontakty dostávaly své e-maily od prvního dne.

## 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 s TXT záznamem Breva `brevo-code` ani s jeho záznamy DKIM (`brevo1._domainkey` a `brevo2._domainkey`, nebo `mail._domainkey` u starších nastavení). Záznam DMARC ponechte. Viz [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Po přepnutí provozu odstraňte záznamy Breva pro kód, DKIM a brandovanou subdoménu a ze záznamu SPF odeberte `include:spf.brevo.com` nebo `include:spf.sendinblue.com`, pokud ho obsahuje. Pokud přijímáte poštu přes inbound parsing v Brevu, 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/)
- [Vytvoření kampaně](/cs/docs/campaigns/create/)
- [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/brevo/
