Riešenie problémov

Začnite kódom chyby: každá chyba API obsahuje code a docs_url a stránka Kódy chýb vysvetľuje každú z nich. História ukazuje každú prijatú správu s časovou osou, odpoveďou poskytovateľa a vykresleným obsahom.

Požiadavka zlyhá

403 origin_not_allowed – Pridajte doménu svojho webu do Zabezpečenie → Povolené weby (a na vývoj aj localhost). Skontrolujte presný host vrátane www.. Pri details.reason: "no_origin" požiadavka nemala žiadny Origin (natívna aplikácia, skript na serveri): pre aplikácie zapnite Povoliť mobilné aplikácie, na serveroch použite súkromný kľúč. Pozrite si Povolené domény.

403 private_key_in_browser – Súkromný kľúč bol použitý z webovej stránky. V prehliadači používajte verejný kľúč a súkromný kľúč nechajte na serveri. Pozrite si Kľúče.

403 captcha_required / captcha_failed – Šablóna vyžaduje Turnstile. Vykreslite widget vo formulári alebo odovzdajte turnstileToken; po každom pokuse widget resetujte, pretože tokeny sú jednorazové. captcha_failed s hostname_mismatch znamená, že widget bol vyriešený na hoste, ktorý nie je originom požiadavky – pridajte do svojho widgetu Turnstile všetky hosty svojho webu. Pozrite si Turnstile.

403 captcha_not_configured – Šablóna vyžaduje CAPTCHA, ale vaša organizácia ešte nepridala vlastné kľúče Turnstile. Vytvorte si v Cloudflare bezplatný widget a jeho site key a secret key vložte do Zabezpečenie → Ochrana pred botmi (Turnstile), alebo v šablóne CAPTCHA vypnite.

422 invalid_template_params – Pozrite sa do details.issues: každý problém uvádza param a pravidlo. Časté príčiny: povinné pole je prázdne, parameter email dostal meno, parameter number dostal "12 ks", parameter list dostal reťazec, ktorý nie je JSON.

403 dynamic_recipient_not_allowed – To/CC/BCC šablóny používa parameter. Na potvrdenia použite automatickú odpoveď alebo v šablóne v Nastavenia → Ochrana zapnite Povoliť dynamického príjemcu.

429 rate_limited – Prekročili ste limit tarifu, IP adresy alebo kľúča. SDK už počkalo a pokus zopakovalo. Na hromadné odosielanie zo servera použite dávkové odosielanie.

Chyba CORS v konzole prehliadača – Zvyčajne ide o inú chybu v prestrojení: požiadavku zablokovala Content-Security-Policy (connect-src), blokovač reklám, alebo išla na nesprávne apiUrl. Frontmail API posiela hlavičky CORS pre všetky originy; prístup riadia povolené domény.

Požiadavka prejde, ale e-mail nepríde

1. Nájdite správu v Histórii.
   • held – minuli sa vám kredity. Kúpte balík (Kúpiť kredity) alebo počkajte na obnovenie; správa sa odošle automaticky. Nájdete ju aj v Pozdržaných správach. Pozrite si Fronta pozdržaných e-mailov.
   • held_service_error – prístupové údaje vašej služby prestali fungovať. Otvorte E-mailové služby a službu opravte alebo znova pripojte; pozdržané správy sa potom odošlú automaticky.
   • failed – otvorte správu: chyba poskytovateľa je na časovej osi. Typické príčiny sú neoverená doména odosielateľa alebo neplatný príjemca.
   • sent – poskytovateľ ju prijal. Pokračujte nižšie.
2. Skontrolujte spam. Ak je tam, nastavte SPF, DKIM a DMARC pre doménu odosielateľa podľa návodu k poskytovateľovi a použite adresu odosielateľa na tejto doméne (nie adresu @gmail.com cez poskytovateľa transakčných e-mailov).
3. Skontrolujte zoznam blokovaných adries. Odoslanie na blokované adresy zlyhá s 451, ale ak ste adresu po nedoručení zo zoznamu odstránili, schránka stále nemusí existovať.
4. Nastavte webhooky, aby ste namiesto hádania videli udalosti delivered / bounced.

Služba opakovane prestáva fungovať

• Gmail: Google zneplatňuje refresh tokeny pri zmene hesla, keď používateľ aplikácii odoberie prístup, alebo po 6 mesiacoch nepoužívania. Pripojte službu znova.
• API poskytovatelia: kľúč bol vymenený alebo mu boli obmedzené oprávnenia. Vytvorte kľúč s oprávnením send a aktualizujte službu.
• SMTP: zmenilo sa heslo k schránke alebo poskytovateľ pri zapnutom 2FA vyžaduje heslo aplikácie.

Pridajte záložnú službu, aby nefunkčná služba nezastavila vaše formuláre, kým ju opravujete.

E-maily vyzerajú zle

• V Gmaile alebo Outlooku chýbajú štýly → v Nastaveniach šablóny zapnite Pri uložení vložiť CSS do atribútov.
• Text je orezaný s „Zobraziť celú správu“ → e-mail má viac ako ~100 kB; odstráňte vložené obrázky alebo rozsiahle štýly.
• V e-maile je doslova <b> → hodnota bola escapovaná. Ak naozaj potrebujete značky, použite parameter typu html (pozrite si escapovanie).
• Dátumy v nesprávnom jazyku alebo časovom pásme → nastavte jazyk šablóny a časové pásmo organizácie alebo odovzdajte timeZone= do formatDate.

Stále si neviete rady?

Napíšte na support@frontmail.dev a uveďte message_id (alebo code a čas chyby). Nikdy neposielajte svoj súkromný kľúč.