Návod
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.
- Rozhodněte se, ze které domény budete odesílat. Subdoména jako
mail.acme.comdrží vaši reputaci odesílatele odděleně od hlavní domény. Viz Hlavní doména, nebo subdoména? - Zkontrolujte, že váš tarif umožňuje přidat další doménu. Viz Limity domén.
- 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.comnebomail.acme.com. Nezadávejtehttp://,https://ani předponuwww.. - 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
-
Otevřete Domains. Otevřete Email APIDomains 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.
-
Zadejte doménu. Do pole Name napište doménu, ze které odesíláte, například
mail.acme.com, a vyberte Create. -
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í.
Zavolejte Vytvoření domény s názvem domény.
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:
{
"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í. |
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.
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.
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í.
-
Otevřete doménu. V Email APIDomains vyberte doménu.
-
Vyberte Send to email. Najdete ho v pravém horním rohu panelu DNS Setup.
-
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
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.
Zavolejte Ověření domény. Můžete použít ID domény, nebo její název.
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.
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 APIDomains 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.
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.
Ř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. |
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.