Skip to main content
Každé telefonní číslo příjemce předávané SmsManageru musí obsahovat plnou mezinárodní volící předvolbu. SmsManager používá primárně standard E.164, ale odstraňuje úvodní znak +. To znamená, že předáváte prostý číselný řetězec začínající kódem země bez mezer, pomlček nebo jiných oddělovačů.

​
Požadovaný formát

Začněte přímo kódem země následovaným účastnickým číslem, bez formátovacích znaků.
Nejčastější chybou je, stav kdy ukládáte národní formát telefonního čísla (např. 777884070 pro Česko a např. 015123456789 pro Německo. SmsManager nemůže při odesílání zprávy na číslo příjemce 015123456789 automaticky doplnit předvolbu 49, protože z telefonního čísla by musela být odstraněna zároveň úvodní nula. Toto telefoní číslo může mít také validní formát v několika destinacích a není tak jednoznačné, jaká předvolba by měla být doplněna). Proto se vždy doporučuje pracovat s mezinárodním formátem.Telefonní číslo +49(0)15123456789 je automaticky přeloženo na 49015123456789 což také představuje chybný formát (národní 0 by v telefonním čísle po mezinárodní předvolbě neměla být).

​
Tabulka validace formátu

​
Kódy zemí

Vždy zahrnujte plný volící kód země jako první číslice čísla — nepřidávejte úvodní +. Například:
  • Česko (420) → 420XXXXXXXXX
  • Německo (49) → 49XXXXXXXXXX
  • USA (1) → 1XXXXXXXXXX
Kód země dělá víc než jen směruje zprávu — také určuje platnou cenu za zprávu, požadovaná pravidla registrace odesílatele a případná obsahová omezení specifická pro zemi. Použití špatného nebo chybějícího kódu země může mít za následek nesprávně směrované zprávy nebo neočekávané poplatky.
Pokud ukládáte telefonní čísla v databázi s úvodním +, odstraňte jej před předáním čísel SmsManager API. Jednoduchý phone.replace(/^\+/, "") v JavaScriptu nebo phone.lstrip("+") v Pythonu je vše, co potřebujete.

​
Telefonní čísla ve Verify API

Verify API přijímá telefonní čísla v poli phoneNumber těla požadavku pomocí stejného formátu: pouze číslice, včetně kódu země, bez úvodního + nebo 00. Verify API validuje číslo proti následujícímu vzoru před přijetím požadavku session:
To znamená:
  • První číslice musí být 1–9 (žádné úvodní nuly)
  • Celková délka musí být mezi 7 a 15 číslicemi (včetně)
  • Akceptovány jsou pouze číselné znaky — žádné mezery, pomlčky nebo +
Příklad těla požadavku Verify API:
Neplatná telefonní čísla způsobují odmítnutí zpráv před odesláním. Odmítnutá zpráva může spustit webhook callback result: rejected. Vždy validujte a normalizujte telefonní čísla na vaší straně před voláním API.