# Řešení problémů se SMTP

> Všechny kódy odpovědí, které může SMTP relay Emailitu vrátit, s příčinou a řešením, a k tomu blokované porty, chyby TLS, vypršení časového limitu a přijatá pošta, která se nedoručí.

Tuto stránku použijte, když SMTP relay zprávu odmítne, nebo se váš klient nemůže připojit. Chyby jsou seskupené podle fáze SMTP komunikace, ve které nastávají, a u každé je uvedená příčina a řešení.

## Najděte kód odpovědi

- **Ve vaší aplikaci.** Poštovní knihovny uvádějí odpověď serveru v chybě, například `Error: Invalid login: 535 Authentication failed` v Nodemaileru nebo `SMTPAuthenticationError: (535, b'Authentication failed')` v Pythonu.
- **V Emailitu.** **Email API → Logs** zaznamenává každou odeslanou zprávu se zdrojem **SMTP** a kódem odpovědi a také odmítnutí kvůli limitu rychlosti a neúspěšná přihlášení klíči, které Emailit dokáže identifikovat. Filtrujte podle **Status code** nebo **API key**.
- **Ručním testem.** Spusťte příkaz cURL ze sekce [Pošlete testovací zprávu](/cs/docs/smtp/#send-a-test-message) s `-v` a uvidíte celou komunikaci.

Kódy začínající na `4` jsou dočasné: slušně se chovající klienti je později zopakují. Kódy začínající na `5` jsou trvalé: než odešlete znovu, odstraňte příčinu.

## Rychlý přehled

| Kód a zpráva | Fáze | Sekce |
| --- | --- | --- |
| `535 Authentication failed` | AUTH | [Chyby přihlášení](#login-errors) |
| `454 Temporary authentication failure` | AUTH | [Chyby přihlášení](#login-errors) |
| `452 4.4.5 Messages per second limit exceeded` | MAIL FROM | [Chyby limitu rychlosti](#rate-limit-errors) |
| `452 4.5.3 Daily message limit exceeded` | MAIL FROM | [Chyby limitu rychlosti](#rate-limit-errors) |
| `451 Temporary local error in processing` | Kterákoli | [Dočasné chyby](#temporary-errors) |
| `501 Invalid RCPT TO` | RCPT TO | [Chyby příjemců](#recipient-errors) |
| `530 Authentication required` | RCPT TO | [Chyby příjemců](#recipient-errors) |
| `535 Mail server has been suspended` | RCPT TO | [Chyby příjemců](#recipient-errors) |
| `550 Unverified workspaces can only send to…` | RCPT TO | [Chyby příjemců](#recipient-errors) |
| `552 Message too large` | DATA | [Chyby zprávy](#message-errors) |
| `530 From/Sender domain is not verified for this workspace` | DATA | [Chyby zprávy](#message-errors) |
| `530 API key is restricted to sending domain` | DATA | [Chyby zprávy](#message-errors) |
| `550 Sending from this domain is paused` | DATA | [Chyby zprávy](#message-errors) |
| `550 Loop detected` | DATA | [Chyby zprávy](#message-errors) |
| `550 Message processing failed` | DATA | [Chyby zprávy](#message-errors) |
| `452 Insufficient credits to receive inbound email` | DATA | [Chyby příchozí pošty](#inbound-errors) |

## Chyby přihlášení

Nastávají, když klient pošle `AUTH`.

### 535 Authentication failed

**Příčina.** Heslo není platný API klíč žádného workspace. Klíč může obsahovat překlep nebo nadbytečné mezery, mohl být smazán nebo znovu vygenerován, nebo jde o starý klíč, který jste nahradili.

**Řešení.** Zkopírujte klíč znovu z místa, kam jste ho při vytvoření uložili. Emailit klíče zobrazuje jen jednou, takže pokud ho už nemáte, vytvořte nový klíč v **Email API → API Keys**. Jako uživatelské jméno použijte `emailit` a jako heslo celý klíč začínající na `secret_`. Viz [Proč SMTP vrací 535 Authentication failed?](/cs/docs/kb/smtp-535-authentication-failed/).

### 454 Temporary authentication failure

**Příčina.** Emailit nemohl klíč zkontrolovat kvůli interní chybě.

**Řešení.** Chvíli počkejte a zkuste to znovu. Pokud to trvá déle než pár minut, zkontrolujte [status.emailit.com](https://status.emailit.com) a kontaktujte podporu.

## Chyby limitu rychlosti

Nastávají, když klient pošle `MAIL FROM` a začíná tak zprávu.

### 452 4.4.5 Messages per second limit exceeded

**Příčina.** Váš workspace za poslední sekundu odeslal víc zpráv, než povoluje jeho limit za sekundu, který je ve výchozím stavu 2. Limit je společný s API a každou SMTP transakci počítá jako jednu zprávu. Čísla v závorce ukazují aktuální počet a limit.

**Řešení.** Většina klientů `452` opakuje automaticky. Pokud se tomu chcete vyhnout, odesílejte přes frontu s omezeným souběhem, nebo používejte jedno spojení a zprávy posílejte jednu po druhé. Pokud potřebujete vyšší rychlost, použijte **Request Increase** v panelu **Sending Limits** na úvodní stránce webového rozhraní. Viz [Limity a kvóty](/cs/docs/limits/).

### 452 4.5.3 Daily message limit exceeded

**Příčina.** Workspace dosáhl denního limitu, který je ve výchozím stavu 5 000 zpráv a je společný s API.

**Řešení.** Odesílání pokračuje po půlnoci UTC. O vyšší denní limit požádejte v panelu **Sending Limits** na úvodní stránce webového rozhraní. Workspace s tarifem Pro a Business navíc dostávají automatická navýšení, když mají dobrou kondici odesílání.

## Dočasné chyby

### 451 Temporary local error in processing

**Příčina.** Emailit narazil při zpracování příkazu na interní chybu. Může k tomu dojít v kterékoli fázi.

**Řešení.** Zkuste to později znovu. Poštovní servery a většina knihoven to u odpovědí `4xx` dělají automaticky. Pokud chyba přetrvává, kontaktujte podporu a uveďte čas pokusu.

## Chyby příjemců

Nastávají, když klient pro každého příjemce pošle `RCPT TO`.

### 501 Invalid RCPT TO

**Příčina.** Adresa příjemce má chybný formát, například nemá `@`, nebo před ním či za ním nic není. Celá zpráva je `Invalid RCPT TO format` nebo `Invalid RCPT TO`.

**Řešení.** Před odesláním adresy validujte. Hledejte prázdné hodnoty a zobrazovaná jména předaná tam, kde se očekává jen adresa.

### 530 Authentication required

**Příčina.** Klient se nepřihlásil, nebo se přihlášení nezdařilo a klient přesto pokračoval. Bez přihlášení relay přijímá poštu jen pro vlastní příchozí adresy a adresy pro nedoručené zprávy Emailitu.

**Řešení.** Zapněte v klientovi autentizaci SMTP a nastavte uživatelské jméno a heslo. Zkontrolujte, jestli ve stejné relaci dřív nepřišla odpověď `535`.

### 535 Mail server has been suspended

**Příčina.** Workspace je zablokovaný, obvykle kvůli vysoké míře nedoručení. Viz [Kondice odesílání](/cs/docs/deliverability/sending-health/).

**Řešení.** Kontaktujte podporu na support@emailit.com. Odesílání bude pokračovat po zrušení blokace.

### 550 Unverified workspaces can only send to workspace members' account emails

**Příčina.** Workspace je v režimu sandbox a příjemce není e-mail účtu člena workspace. Zpráva končí zablokovanou adresou.

**Řešení.** Testujte s e-mailem účtu některého člena, nebo [požádejte o produkční přístup](/cs/docs/workspaces/production-access/). Viz [Jak otestovat odesílání, než je můj workspace ověřený?](/cs/docs/kb/test-sending-before-production-access/).

## Chyby zprávy

Nastávají poté, co klient pošle zprávu příkazem `DATA`.

### 552 Message too large (maximum size 40MB)

**Příčina.** Zpráva včetně zakódovaných příloh je větší než 40 MB. Kódování Base64 zvětší přílohy zhruba o třetinu oproti souborům.

**Řešení.** Posílejte menší přílohy, nebo velké soubory nahrajte do vlastního úložiště a vložte odkaz.

### 530 From/Sender domain is not verified for this workspace

**Příčina.** Adresa v hlavičce `From` není na ověřené odesílací doméně workspace, kterému patří klíč. Časté důvody: doména ještě není ověřená nebo čeká na ruční kontrolu, adresa odesílatele je na subdoméně, kterou jste nepřidali, klíč patří jinému workspace, nebo zpráva nemá hlavičku `From`. Adresa `MAIL FROM` v obálce nehraje roli.

**Řešení.** Zkontrolujte stav domény v **Email API → Domains**, zajistěte, aby adresa odesílatele přesně odpovídala ověřené doméně, a použijte klíč ze stejného workspace. Viz [Proč SMTP vrací 530 From domain not verified?](/cs/docs/kb/smtp-530-from-domain-not-verified/).

### 530 API key is restricted to sending domain

**Příčina.** Klíč je klíč **Sending Only** omezený na jednu doménu a adresa odesílatele je na jiné doméně. Zpráva uvádí povolenou doménu.

**Řešení.** Odesílejte z povolené domény, nebo použijte klíč bez omezení na doménu.

### 550 Sending from this domain is paused

**Příčina.** Emailit pozastavil doménu odesílatele, protože její míra nedoručení přesáhla 5 %.

**Řešení.** Najděte zdroj nedoručení a vyčistěte seznam. Viz [Kondice odesílání](/cs/docs/deliverability/sending-health/) a [Nedoručení a stížnosti](/cs/docs/deliverability/bounces-and-complaints/).

### 550 Loop detected

**Příčina.** Zpráva už prošla přes relay Emailitu víc než čtyřikrát, obvykle proto, že ji pravidla přeposílání posílají sem a tam.

**Řešení.** Najděte a přerušte smyčku přeposílání mezi vašimi systémy nebo schránkami.

### 550 Message processing failed

**Příčina.** Emailit data přijal, ale zprávu nedokázal uložit.

**Řešení.** Zprávu odešlete znovu. Pokud to znovu selže, kontaktujte podporu a uveďte čas pokusu a adresy From a To.

## Chyby příchozí pošty

### 452 Insufficient credits to receive inbound email

**Příčina.** Zpráva byla odeslána na některou z vašich adres pro [příchozí e-maily](/cs/docs/inbound/), ale workspace už nemá žádné kredity. Přijetí e-mailu stojí 1 kredit. Odesílající server dostane tuto dočasnou chybu a později to zkusí znovu.

**Řešení.** Dokupte [kredity](/cs/docs/billing/credits/), nebo zapněte [automatické dobíjení](/cs/docs/billing/auto-refill/). Pošta, kterou odesílatel zkusí poslat znovu, dorazí, jakmile budou kredity k dispozici.

## Problémy s připojením

| Příznak | Pravděpodobná příčina | Řešení |
| --- | --- | --- |
| Připojení vyprší, nebo je odmítnuto | Váš poskytovatel připojení, hostingu nebo cloudu port blokuje. Port 25 je blokovaný na většině cloudových platforem a některé blokují i 587. | Použijte `587`, pak `2525` nebo `2587`. Viz [Proč vyprší časový limit připojení k SMTP?](/cs/docs/kb/smtp-connection-timeout-port-25/). |
| `wrong version number`, nebo se spojení po připojení zasekne | Režim TLS neodpovídá portu: implicitní TLS na portu 587, nebo STARTTLS na portu 465. | Na portech 587, 2525, 2587 a 25 používejte STARTTLS a implicitní TLS jen na portu 465. |
| Neodpovídá název v certifikátu | Připojujete se přes IP adresu, nebo přes vlastní název hostitele. | Připojujte se k `smtp.emailit.com`. |
| Navázání spojení selže na starém systému | Klient neumí vyjednat moderní verzi TLS, nebo má zastaralé certifikáty CA. | Aktualizujte běhové prostředí, OpenSSL a sadu certifikátů CA. |

Podrobnosti najdete na stránce [Proč při připojení k SMTP dostávám chyby TLS?](/cs/docs/kb/smtp-tls-errors/).

## Přijato, ale nedoručeno

Odpověď `250` znamená, že Emailit zprávu přijal, ne že dorazila do schránky. Otevřete e-mail v **Email API → Emails** podle ID z odpovědi a zkontrolujte jeho stav:

- **Held:** workspace došly kredity, doména byla pozastavena, nebo zpráva v [kontrolách spamu](/cs/docs/deliverability/spam-checks/) získala skóre 7 nebo vyšší. Odstraňte příčinu a pak e-mail [odešlete znovu](/cs/docs/email-api/retry-and-forward/). Viz [Proč je můj e-mail zadržený?](/cs/docs/kb/email-status-held/).
- **Suppressed:** příjemce je na vašem [seznamu blokovaných adres](/cs/docs/suppressions/).
- **Attempted:** server příjemce vrátil dočasnou chybu. Emailit to zkouší znovu asi 21 hodin.
- **Bounced** nebo **Failed:** podrobnosti o doručení ukazují odpověď přijímajícího serveru. Viz [Nedoručení a stížnosti](/cs/docs/deliverability/bounces-and-complaints/).

Úplný kontrolní seznam najdete na stránce [Proč můj e-mail nedorazil?](/cs/docs/kb/email-not-delivered-checklist/).

## Stále si nevíte rady?

Napište na support@emailit.com, nebo se zeptejte na [Discordu](https://discord.emailit.com). Uveďte čas pokusu, port, svou poštovní knihovnu a celou odpověď serveru.

---
Zdroj: https://emailit.com/cs/docs/smtp/troubleshooting/