Přejít na obsah
Dokumentace

Řešení problémů

Ř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čí.

Aktualizováno 1. 10. 2026

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 APILogs 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 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í
454 Temporary authentication failure AUTH Chyby přihlášení
452 4.4.5 Messages per second limit exceeded MAIL FROM Chyby limitu rychlosti
452 4.5.3 Daily message limit exceeded MAIL FROM Chyby limitu rychlosti
451 Temporary local error in processing Kterákoli Dočasné chyby
501 Invalid RCPT TO RCPT TO Chyby příjemců
530 Authentication required RCPT TO Chyby příjemců
535 Mail server has been suspended RCPT TO Chyby příjemců
550 Unverified workspaces can only send to… RCPT TO Chyby příjemců
552 Message too large DATA Chyby zprávy
530 From/Sender domain is not verified for this workspace DATA Chyby zprávy
530 API key is restricted to sending domain DATA Chyby zprávy
550 Sending from this domain is paused DATA Chyby zprávy
550 Loop detected DATA Chyby zprávy
550 Message processing failed DATA Chyby zprávy
452 Insufficient credits to receive inbound email DATA Chyby příchozí pošty

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 APIAPI 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?.

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

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í.

Ř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. Viz Jak otestovat odesílání, než je můj workspace ověřený?.

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 APIDomains, 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?.

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í a Nedoručení a stížnosti.

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, 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, nebo zapněte automatické dobíjení. 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?.
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?.

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 APIEmails podle ID z odpovědi a zkontrolujte jeho stav:

Úplný kontrolní seznam najdete na stránce Proč můj e-mail nedorazil?.

Stále si nevíte rady?

Napište na support@emailit.com, nebo se zeptejte na Discordu. Uveďte čas pokusu, port, svou poštovní knihovnu a celou odpověď serveru.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.