Odbiór gruzińskich kodów SMS +995 dla QA i regionalnych wdrożeń

Dlaczego kraj Georgia myli plany testów?

Pierwszą niespodzianką jest nazwa. Georgia jako kraj dzieli ją ze stanem USA, więc biblioteki formularzy, filtry analityczne, a nawet koledzy z zespołu mylą jedno z drugim. W API identyfikator kraju to ge, zgodny z kodem ISO GE, a numer kierunkowy to +995. Test, który po cichu wybiera amerykański numer +1, bo ktoś wpisał „Georgia” w polu wyszukiwania, to błąd warty wyłapania na wczesnym etapie.

Drugą jest pismo. Gruziński używa własnego alfabetu, mchedruli, który leży poza 7-bitowym zestawem znaków GSM. Każdy SMS zawierający gruzińskie litery jest wysyłany jako Unicode, więc każdy segment mieści mniej znaków, a dłuższe wiadomości dzielą się szybciej. Jeśli Twój produkt wysyła wiadomości po gruzińsku, dokładnie na to powinno spojrzeć QA lokalizacji.

Jak wygląda poprawnie zapisany numer +995?

W kraju przed numerem abonenckim wybiera się prefiks krajowy 0; w formie międzynarodowej to 0 znika. Numery komórkowe mają dziewięć cyfr i zaczynają się od 5, więc forma E.164 to +995 i dziewięć cyfr zaczynających się od 5.

Praktyczna procedura normalizacji gruzińskich danych wejściowych:

• Usuń spacje, kropki i myślniki, które użytkownicy wpisują z przyzwyczajenia.
• Jeśli wartość zaczyna się od 0 i ma dziesięć cyfr, usuń 0 i dodaj +995.
• Jeśli zaczyna się od 995 bez znaku plus, dodaj plus.
• Odrzuć wszystko, co po plusie nadal nie ma dwunastu cyfr.

Przechowywanie jednego kanonicznego formatu sprawia, że numer wpisany w teście zgadza się z numerem, który backend później wyszukuje.

Jakie gruzińskie ścieżki weryfikacji mogę przetestować?

Aktualny zestaw dla Gruzji pokazuje WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Discord, LinkedIn i Viber, a pełny katalog obejmuje ponad 1 500 usług.

Zespoły testują tu z kilku powtarzających się powodów: produkt wchodzi na Kaukaz Południowy, zdalny zespół w Tbilisi weryfikuje regionalne konta firmowe albo przegląd lokalizacji sprawdza, czy gruziński tekst poprawnie renderuje się na ekranach rejestracji. Dostępność zmienia się w ciągu dnia, więc zanim zarezerwujesz numer +995 do testów, zapytaj API, zamiast ufać wczorajszej liście. Routing OTP wybiera spośród tego, co jest dostępne w danej chwili.

Jak przebiega sekwencja wywołań Georgia OTP API?

Wszystkie wywołania trafiają pod https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_. Każde konto może mieć do 10 kluczy, co pozwala rozdzielić staging i produkcję.

1. Jednorazowo pobierz GET /api/v1/countries i potwierdź identyfikator ge.
2. Wywołaj GET /api/v1/prices?country=ge&service=<id>, aby odczytać dzisiejszą cenę i dostępność.
3. Złóż zamówienie przez POST /api/v1/activations, na przykład {"service": "whatsapp", "country": "ge"}.
4. Wpisz numer +995 w testowanej aplikacji i wywołaj jej krok z SMS-em.
5. Odczytaj kod z GET /api/v1/activations/{id} albo pozwól, by dostarczył go webhook.
6. Jeśli scenariusz zostanie przerwany, zwolnij zamówienie przez POST /api/v1/activations/{id}/cancel.

Limit 300 żądań na minutę zostawia miejsce na odpytywanie co kilka sekund w kilku równoległych zadaniach.

Odpytywać czy używać webhooków dla kodów +995?

Oba style korzystają z tego samego API do weryfikacji SMS, a odpytywanie jest w porządku dla pojedynczego dewelopera, który chce odbierać wiadomości SMS OTP z Gruzji z laptopa. W CI spokojniejszy jest webhook: zarejestruj do 5 endpointów w konsoli deweloperskiej i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Weryfikuj każde żądanie. Nagłówek X-OTPRoute-Signature zawiera t=<unix>,v1=<hex>; oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj żądania ze starym znacznikiem czasu. Zapisuj wyniki pod identyfikatorem aktywacji, aby powtórna dostawa była nieszkodliwa. Opis odbioru przez webhook zawiera przykładowy wzorzec.

Gruziński kod nie dotarł. Co spróbować?

Najpierw daj mu pełne 20 minut; zamówienie samo się zwróci, jeśli nic nie przyjdzie. Następnie zastanów się, czy usługa w ogóle akceptuje numery wirtualne dla gruzińskich kont, bo niektóre nie akceptują. Ponowna próba później albo przepuszczenie tego samego testu przez inną trasę usługi często usuwa przejściowy spadek. Czego nie należy robić, to wysyłać nowych zamówień w ciasnej pętli, co zjada czas i wygląda podejrzanie dla platformy odbierającej.

Numery długoterminowe, rozliczenia i sandbox

OTP Route nie sprzedaje samoobsługowych długoterminowych numerów gruzińskich. Linie dedykowane istnieją tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/month; aby zapytać o trwałą linię +995, napisz na [email protected], a odpowiedź będzie zależeć od lokalnych przepisów.

Portfel jest przedpłacony w USD, bez abonamentu: zasilasz go kartą lub USDT/USDC i za każdym razem dostajesz fakturę PDF. Konto sandbox, dostępne na prośbę, zwraca symulowane numery i kody do testów integracji. Zajrzyj do cennika lub załóż konto, aby zacząć.

Najczęstsze pytania

Jak upewnić się, że dostanę numer z kraju Georgia, a nie ze stanu USA?

Używaj identyfikatora kraju ge w wywołaniach API i szukaj numeru kierunkowego +995 w panelu. Stan USA nigdy nie ma własnego identyfikatora kraju.

Czy mogę przetestować gruzińską ścieżkę rejestracji bez lokalnej karty SIM?

Tak. Numer OTP Gateway z prefiksem +995 odbiera kod, a Ty odczytujesz go w panelu lub przez API.

Czy przy zapisywaniu gruzińskich numerów komórkowych zachować początkowe 0?

Nie. 0 to krajowy prefiks; zapisz numer jako +995 i dziewięć cyfr zaczynających się od 5.

Dlaczego gruzińskie wiadomości SMS mieszczą mniej znaków w segmencie?

Gruzińskie litery wykraczają poza 7-bitowy alfabet GSM, więc wiadomość używa kodowania Unicode, które mieści mniej znaków w każdym segmencie.

Jaka jest cena gruzińskiego numeru weryfikacyjnego?

Zaczyna się od $0.20 za kod i zależy od usługi. Aktualną cenę zwraca GET /api/v1/prices i pokazuje panel przed zamówieniem.

Czy zapłacę, jeśli platforma odrzuci numer?

Nie. Gdy w ciągu 20-minutowego okna nie dotrze żaden SMS albo anulujesz, cała kwota wraca do portfela.

Do czego wolno używać numerów +995?

Do testowania własnego produktu, automatyzacji QA i prowadzenia własnych kont biznesowych. Przestrzegaj regulaminu każdej usługi i Acceptable Use Policy OTP Route.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.