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

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.
• 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í nebo úpravě 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í:

[
  {
    "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ů.

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:

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:

{
  "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. 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.

Cena

Každý přijatý e-mail stojí 1 kredit, stejně jako jeden odeslaný. Viz Kredity.

Další kroky