# Příjem prvního příchozího e-mailu

> Přidejte příchozí MX záznam, pošlete testovací zprávu na příchozí subdoménu, najděte ji ve webovém rozhraní a zpracujte ji webhookem email.received a přes API.

Tento rychlý začátek nastaví doménu pro příjem e-mailů, aby vaše aplikace mohla zpracovávat odpovědi, žádosti o podporu nebo přeposlané zprávy. Přidáte jeden DNS záznam, pošlete testovací zprávu, pak ji přijmete webhookem a celý její obsah načtete přes API.

## Než začnete

- Ověřená odesílací doména, například `acme.com`. Příchozí e-maily fungují jen na doménách, které jsou ve vašem workspace ověřené. Viz [Přidání odesílací domény](/cs/docs/domains/add-a-domain/).
- Kredity ve workspace. Každý přijatý e-mail stojí 1 kredit.

## Jak fungují příchozí adresy

Emailit přijímá poštu na subdoméně vaší odesílací domény, ve výchozím stavu `inbound`. Funguje jakákoli adresa na této subdoméně, takže `support@inbound.acme.com` i `reply-4821@inbound.acme.com` dorazí do stejného workspace. MX záznamy vaší hlavní domény, například pro Google Workspace nebo Microsoft 365, zůstanou beze změny.

## Přidejte příchozí MX záznam

1. **Otevřete doménu.** Přejděte do **Email API → Domains** a otevřete `acme.com`. MX záznam pro `inbound.acme.com` je uvedený spolu s ostatními DNS záznamy. Je volitelný, takže doména zůstane ověřená i bez něj.

2. **Přidejte záznam u svého poskytovatele DNS.**

   | Typ | Název | Hodnota | Priorita |
   | --- | --- | --- | --- |
   | MX | `inbound.acme.com` | `inbound.emailitmail.com` | 10 |

   Někteří poskytovatelé DNS chtějí do pole s názvem jen `inbound`, jiní celý název.

3. **Zkontrolujte DNS.** Na stránce domény vyberte **Check DNS** a počkejte, až příchozí záznam ukáže **OK**. Změny DNS se obvykle projeví za několik minut, ale může to trvat až 48 hodin.

Pokud chcete přijímat na jiné subdoméně, například `replies.acme.com`, nastavte při [vytvoření](/cs/docs/api-reference/domains/create/) nebo [úpravě](/cs/docs/api-reference/domains/update/) domény přes API `inbound_key` na `replies` a pak místo toho zveřejněte MX záznam pro tento název. Webové rozhraní příchozí subdoménu zobrazuje, ale nedovolí ji změnit.

## Pošlete testovací e-mail

Ze své osobní schránky pošlete e-mail na jakoukoli adresu na příchozí subdoméně, například `hello@inbound.acme.com`.

Otevřete **Email API → Emails** a kartu **Incoming**. Zpráva se zobrazí se stavem **received**. Když ji otevřete, uvidíte odesílatele, hlavičky, obsah a případné přílohy.

Pokud nedorazí, zkontrolujte, že MX záznam ukazuje **OK** a že je doména ověřená. Pokud workspace nemá žádné kredity, Emailit zprávu odmítne s dočasnou chybou a server odesílatele to zkusí později znovu.

## Nechte se upozornit webhookem

Pokud chcete příchozí e-maily zpracovávat ve své aplikaci, odebírejte událost `email.received`.

1. **Vytvořte webhook.** Otevřete **Email API → Webhooks**, vyberte **Add webhook** a zadejte název a svůj HTTPS endpoint, například `https://acme.com/webhooks/emailit`. Zkopírujte tajný klíč webhooku. Budete ho potřebovat k ověřování podpisů.

2. **Zvolte událost.** Nový webhook dostává všechny události. Otevřete kartu **Settings** webhooku a vyberte jen `email.received`, nebo ponechte všechny události a filtrujte je v kódu.

3. **Pošlete další testovací e-mail** na `hello@inbound.acme.com`.

Emailit pošle na váš endpoint podepsaný `POST`. Tělo je pole JSON, protože jeden požadavek může obsahovat až 100 událostí:

```json
[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]
```

Událost obsahuje odesílatele, příjemce a předmět, ale ne tělo. Než požadavku začnete věřit, ověřte hlavičku `X-Emailit-Signature`. Viz [Ověření podpisu webhooků](/cs/docs/webhooks/request-signature/).

## Načtěte celý e-mail

Pomocí `id` z události načtěte zprávu s API klíčem s oprávněním **Full Access**:

```bash
curl https://api.emailit.com/v2/emails/em_2pXb7Kq4NvL8mWc3RtB9yZd \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Odpověď obsahuje zpracované hlavičky, tělo v prostém textu a HTML a přílohy:

```json
{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}
```

Pokud místo toho chcete původní zprávu, zavolejte [`GET /emails/{id}/raw`](/cs/docs/api-reference/emails/raw/). Obsah zpráv se uchovává po dobu uchovávání podle vašeho tarifu, proto ho načtěte brzy po příchodu události. Viz [Uchovávání dat](/cs/docs/data-retention/).

## Cena

Každý přijatý e-mail stojí 1 kredit, stejně jako jeden odeslaný. Viz [Kredity](/cs/docs/billing/credits/).

## Další kroky

  - [Zpracování příchozích e-mailů webhooky](/cs/docs/inbound/process-with-webhooks/): Směrujte odpovědi, zpracovávejte přílohy a párujte vlákna.
  - [Přeposílání automatizacemi](/cs/docs/inbound/forward-with-automations/): Přeposílejte přijaté e-maily do schránky bez kódu.
  - [Nastavení příchozích e-mailů](/cs/docs/inbound/set-up/): Vlastní subdomény a DNS podrobně.
  - [email.received](/cs/docs/webhooks/events/email/received/): Úplná reference události.

---
Zdroj: https://emailit.com/cs/docs/quickstart/inbound/