# Přidání odesílací domény

> Přidejte doménu do Emailitu, publikujte DNS záznamy, které vygeneruje, v případě potřeby je pošlete vývojáři a doménu ověřte, abyste mohli odesílat.

Tento návod vás provede přidáním odesílací domény, publikováním jejích DNS záznamů a jejím ověřením. Zabere to pár minut práce plus dobu, kterou vašemu poskytovateli DNS trvá publikování záznamů.

## Než začnete

- Potřebujete přístup k nastavení DNS domény, nebo někoho, kdo ho má. Záznamy mu můžete [poslat e-mailem](#send-the-records-to-someone-else).
- Rozhodněte se, ze které domény budete odesílat. Subdoména jako `mail.acme.com` drží vaši reputaci odesílatele odděleně od hlavní domény. Viz [Hlavní doména, nebo subdoména?](/cs/docs/domains/#root-domain-or-subdomain)
- Zkontrolujte, že váš tarif umožňuje přidat další doménu. Viz [Limity domén](/cs/docs/domains/limits/).
- Pro API použijte API klíč s oprávněním **Full Access**. Klíče jen pro odesílání domény spravovat nemohou.

## Pravidla pro název domény

- Zadejte holou doménu: `acme.com` nebo `mail.acme.com`. Nezadávejte `http://`, `https://` ani předponu `www.`.
- Používejte písmena, číslice, spojovníky a tečky a doménu nejvyššího řádu s aspoň dvěma písmeny. Emailit název uloží malými písmeny.
- Subdomény jsou povolené v libovolné hloubce, například `eu.mail.acme.com`. Každá z nich je samostatná doména s vlastními záznamy.
- Název lze do workspace přidat jen jednou. Opakované přidání vrátí `409 Domain with this name already exists`.

## Přidejte doménu

**Webové rozhraní**

  1. **Otevřete Domains.** Otevřete **Email API → Domains** a vyberte **Add domain**.

     Pokud je tlačítko neaktivní, váš workspace dosáhl limitu domén. Označení vedle nadpisu stránky ukazuje, kolik jich využíváte.

  2. **Zadejte doménu.** Do pole **Name** napište doménu, ze které odesíláte, například `mail.acme.com`, a vyberte **Create**.

  3. **Zkontrolujte záznamy.** Emailit otevře stránku domény na kartě **DNS Setup**. Ta vypisuje každý záznam s typem, názvem, hodnotou, prioritou a TTL a u každé hodnoty tlačítko pro zkopírování.

**API**

  Zavolejte [Vytvoření domény](/cs/docs/api-reference/domains/create/) s názvem domény.

```bash
curl https://api.emailit.com/v2/domains \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'
```

  Odpověď `201` obsahuje `id` domény a pole `dns_records` se všemi záznamy, které je potřeba publikovat:

```json
{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}
```

  Úplná odpověď uvádí všech šest záznamů včetně DKIM, DMARC, měření a příchozí pošty. Při vytváření domény můžete nastavit i tato volitelná pole:

  | Pole | Výchozí hodnota | Popis |
  | --- | --- | --- |
  | `tracking_key` | `go` | Předpona subdomény pro CNAME záznam pro měření. Viz [Vlastní doména pro měření](/cs/docs/tracking/custom-tracking-domain/). |
  | `inbound_key` | `inbound` | Předpona subdomény pro příchozí MX záznam. |
  | `dmarc_reports` | `false` | Přidá do navrhovaného záznamu DMARC adresu Emailitu pro reporty. Jen v tarifech Pro, Business a Custom; jinak `403 plan_required`. |

  `track_loads` a `track_clicks` nelze při vytváření domény zapnout, protože měření nejdřív potřebuje ověřený CNAME záznam pro měření. Odeslání `true` vrátí `422`.

Samostatný přepínač pro odchozí nebo příchozí poštu neexistuje. Ověřená doména může odesílat a příchozí e-maily přijímá, jakmile je publikovaný její příchozí MX záznam. API kvůli kompatibilitě přijímá příznaky `outgoing` a `incoming`, ale ty chování domény nemění.

## Publikujte DNS záznamy

Přidejte záznamy u firmy, která hostuje DNS vaší domény. Často je to váš registrátor (GoDaddy, Namecheap), nebo služba DNS (Cloudflare, Amazon Route 53).

| Záznam | Typ | Název | Co udělat |
| --- | --- | --- | --- |
| Return path | MX | `emailit.<domain>` | Povinný. Priorita 10. |
| SPF | TXT | `emailit.<domain>` | Povinný. |
| DKIM | TXT | `emailit._domainkey.<domain>` | Povinný. Vložte celou hodnotu. |
| DMARC | TXT | `_dmarc.<domain>` | Doporučený. Pokud už doména záznam DMARC má, vynechte ho. |
| Měření | CNAME | `go.<domain>` | Jen pokud chcete měřit otevření a prokliky. |
| Příchozí pošta | MX | `inbound.<domain>` | Jen pokud chcete přijímat e-maily. Priorita 10. |

Většina poskytovatelů DNS chce do pole s názvem jen část před vaší doménou (`emailit`, ne `emailit.acme.com`). Přesné hodnoty, tipy pro jednotlivé poskytovatele a časté chyby najdete na stránce [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Pokud vaše doména používá DNS v Cloudflare, stránka domény nabízí **Set up with Cloudflare**, které záznamy vytvoří za vás. Viz [Nastavení DNS v Cloudflare](/cs/docs/domains/cloudflare/).

## Pošlete záznamy někomu jinému

Pokud vaše DNS spravuje někdo jiný, pošlete mu záznamy e-mailem z webového rozhraní.

1. **Otevřete doménu.** V **Email API → Domains** vyberte doménu.

2. **Vyberte Send to email.** Najdete ho v pravém horním rohu panelu **DNS Setup**.

3. **Zadejte jeho adresu.** Do pole **Recipient Email** napište adresu svého vývojáře nebo správce IT a vyberte **Send Instructions**.

Dostane od Emailitu e-mail se všemi záznamy a jejich hodnotami. Požádejte ho, aby vám dal vědět, až budou záznamy publikované, abyste mohli spustit kontrolu.

## Zkontrolujte DNS a ověřte doménu

**Webové rozhraní**

  Na stránce domény vyberte **Check DNS**. Emailit vyhledá všechny záznamy a u každého aktualizuje stav: **OK**, **Missing**, **Invalid** nebo **Not checked**. Když najedete myší na **Missing** nebo **Invalid**, uvidíte, co Emailit našel.

**API**

  Zavolejte [Ověření domény](/cs/docs/api-reference/domains/verify/). Můžete použít ID domény, nebo její název.

```bash
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Odpověď obsahuje aktualizovanou doménu. Zkontrolujte `verification_status` a u každé položky v `dns_records` hodnoty `status` a `error`.

> **Ověření proběhne, jen když o něj požádáte:** Emailit novou doménu sám neověřuje. Po publikování nebo opravě záznamů spusťte **Check DNS** znovu. Změny DNS se obvykle projeví během několika minut, ale u některých poskytovatelů to trvá až 48 hodin.

Doména je ověřená, když SPF, DKIM i return path ukazují **OK**. DMARC, měření a příchozí pošta jsou volitelné a na ověření nemají vliv.

## Ověřte, že vše funguje

- Doména má v **Email API → Domains** stav **Verified** a sloupce **SPF**, **DKIM** a **Return Path** ukazují **OK**.
- Odešlete testovací zprávu z adresy na této doméně. Na stránce **Emails** vyberte **Compose**, nebo zavolejte [Odeslání e-mailu](/cs/docs/api-reference/emails/send/).

Pokud doména ukazuje **Pending verification**, čeká na ruční kontrolu. Týká se domén v tarifu Pay as you go registrovaných před méně než 30 dny. Viz [Ověření domény](/cs/docs/domains/verification/#pending-verification).

> **Poznámka:** Ověřená doména neruší režim sandbox. Dokud váš workspace nemá produkční přístup, můžete odesílat jen na e-maily účtů členů workspace. Viz [Produkční přístup](/cs/docs/workspaces/production-access/).

## Řešení problémů

| Problém | Řešení |
| --- | --- |
| Tlačítko **Add domain** je neaktivní | Dosáhli jste limitu domén svého tarifu. Smažte nepoužívanou doménu, nebo si limit navyšte. Viz [Limity domén](/cs/docs/domains/limits/). |
| `The domain must be in apex format` | Odstraňte `http://`, `https://` nebo `www.` a ověřte, že název končí skutečnou doménou nejvyššího řádu. |
| Záznamy ukazují **Missing** i po hodině | Název je pravděpodobně zdvojený, například `emailit.acme.com.acme.com`. Do pole s názvem zadejte jen `emailit`. |
| DKIM ukazuje **Invalid** | Část hodnoty se usekla. Zkopírujte ji znovu tlačítkem pro zkopírování. |

Další případy popisuje stránka [Ověření domény](/cs/docs/domains/verification/#troubleshooting).

## Související

  - [DNS záznamy](/cs/docs/domains/dns-records/): Přehled všech záznamů, které Emailit generuje.
  - [Ověření domény](/cs/docs/domains/verification/): Stavy, ruční kontrola a denní kontroly.
  - [Vlastní doména pro měření](/cs/docs/tracking/custom-tracking-domain/): Nastavte měření otevření a prokliků.
  - [Nastavení příchozích e-mailů](/cs/docs/inbound/set-up/): Přijímejte e-maily na své doméně.

---
Zdroj: https://emailit.com/cs/docs/domains/add-a-domain/