Skip to main content
Chyby ve SmsManageru se objevují na dvou místech: jako HTTP status kódy vrácené přímo z odpovědí API a jako pole result a result_info doručená na vaši webhook callback URL poté, co byla zpráva odeslána. Pochopení obou povrchů vám pomůže rozlišit mezi selháními na úrovni požadavku (kde se nic neodeslalo) a selháními na úrovni doručení (kde byla zpráva přijata, ale nedosáhla příjemce).

​
HTTP status kódy

Následující tabulka pokrývá všechny HTTP status kódy, které můžete obdržet z SmsManager API. Odpověď 200 znamená, že server přijal váš požadavek — ale stále byste měli zkontrolovat pole rejected v těle odpovědi pro zachycení případných selhání jednotlivých příjemců.
Odpověď 200 z /message nebo /messages nezaručuje, že každý příjemce zprávu obdržel. Vždy kontrolujte pole rejected v těle odpovědi a sledujte webhook callbacky pro finální výsledky doručení.

​
Hodnoty result zprávy

Po odeslání zprávy SmsManager doručí jeden nebo více webhook callbacků na vaši nakonfigurovanou callback URL. Každý callback obsahuje pole result, které odráží aktuální stav doručení zprávy. Můžete obdržet více callbacků pro stejnou zprávu, jak se její stav vyvíjí (například sending → sent → delivered).
Výsledek rejected znamená, že zpráva nebyla nikdy odeslána operatérovi. Zkontrolujte kreditní zůstatek účtu a ověřte formát telefonního čísla příjemce před opakováním.

​
Kódy result_info

Pole result_info v webhook payloadech poskytuje dodatečné detaily o výsledku doručení. Sleduje formát [kód] Popis, kde obě části jsou volitelné — můžete obdržet pouze kód, pouze popis, nebo obojetě.
  • Kód — číselný identifikátor v hranatých závorkách, např. [307]
  • Popis — čitelné vysvětlení, např. Insufficient credit
Běžné příklady, s nimiž se setkáte:
WhatsApp chybové kódy (jako 131042) sledují WhatsApp error code referenci Mety. Ohledně úplného seznamu specifických WhatsApp kódů a jejich významu se podívejte na dokumentaci Mety.

​
Běžné chyby a jejich řešení

Váš požadavek byl odmítnut, protože API klíč chybí, je poškozený nebo neodpovídá žádnému aktivnímu klíči na vašem účtu.Řešení: Přihlaste se na app.smsmanager.com/api-cloud a zkopírujte váš aktuální API klíč. Předejte jej v každém požadavku pomocí hlavičky x-api-key:
Alternativně jej můžete předat jako query parametr apikey, i když přístup přes hlavičku je doporučený z bezpečnostních důvodů.
Váš účet nemá dostatek kreditu k odeslání požadovaných zpráv. Postihované zprávy se objeví s result: rejected a result_info: [307] Insufficient credit ve vašich webhook callbaccích.Řešení: Dobijte kredit účtu na app.smsmanager.com. Po dobití neuspělé zprávy zopakujte.
Telefonní číslo, které jste poskytli, nebylo možno parsovat nebo normalizovat na platné E.164 číslo.Řešení: Použijte formát E.164 bez úvodního + nebo 00. Například české číslo +420 777 123 456 by mělo být odesláno jako:
Kompletní seznam přijatých formátů najdete v Telefonní čísla.
Zpráva se objeví v poli rejected odpovědi API nebo dorazí do vašeho webhooku s result: rejected.Řešení: Dvě nejčastější příčiny jsou nedostatečný kredit a neplatné telefonní číslo. Zkontrolujte obojetě:
  1. Ověřte kreditní zůstatek na app.smsmanager.com.
  2. Potvrďte, že telefonní číslo je ve formátu E.164 bez úvodního + (např. 420777123456).
Obdrželi jste webhook s result: sent, ale nikdy jste neobdrželi navazující callback result: delivered.To je v mnoha případech normální. Stav sent znamená, že operatér přijal zprávu, ale potvrzení doručení (DLR) závisí na tom, zda operatér podporuje potvrzení a zda je zařízení příjemce dostupné. Někteří operatoři a sítě nevracejí potvrzení doručení vůbec.Pokud je zpráva časově citlivá, zvažte použití záložního kanálu (např. SMS → Viber) přes parametr flow.
Obdrželi jste odpověď 415 Unsupported Media Type při volání simple POST endpointu.Řešení: Endpoint POST /simple/message vyžaduje form-encoded data, ne JSON. Nastavte hlavičku Content-Type na:
Všechny ostatní JSON API v2 endpointy (/message, /messages) přijímají application/json.

​
Chybové kódy Verify API

Verify API vrací strukturované chybové objekty se strojově čitelným kódem error spolu s čitelným message. Ve vaší aplikační logice používejte pole error pro zpracování konkrétních podmínek selhání.