Testowanie tajskiej (+66) weryfikacji telefonu: lista kontrolna, kroki i poprawki

Zanim zaczniesz: lista kontrolna testów +66

Tajskie procesy rejestracji mają kilka pułapek, które taniej wychwycić na papierze niż w nieudanym przebiegu CI. Najpierw potwierdź każdy punkt:

• Dane uwierzytelniające. Klucz Bearer z prefiksem or_live_ z konsoli Developer, przypisany do środowiska, które będzie go używać.
• Identyfikatory. Identyfikator kraju Tajlandii to th; identyfikator usługi weź z GET /api/v1/services, zamiast go zgadywać.
• Sposób dostarczania. Albo endpoint webhooka z zapisanym sekretem podpisu, albo zadanie odpytujące, które mieści się w limicie 300 żądań na minutę.
• Obsługa numerów. Zdecyduj, jak Twój kod usuwa krajowe 0, zanim cokolwiek zapiszesz (zobacz sekcję o formatowaniu).
• Parsowanie wiadomości. Upewnij się, że parser radzi sobie z pismem tajskim wokół cyfr.
• Budżet. Zasilony portfel albo konto sandbox, jeśli chcesz tylko udowodnić działanie integracji.

Które tajskie procesy rejestracji może obsłużyć OTP Gateway?

Tajlandia to jedna z szerszych tras, z ponad 1800 usług w bieżącej migawce. W lokalnym użyciu dominują komunikatory i handel, więc zespoły zwykle zaczynają od LINE, Shopee, Lazada, TikTok, WhatsApp, Facebooka, Instagrama i Telegrama. Na liście są też m.in. Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon i Airbnb.

Dostępność poszczególnych usług zmienia się, gdy numery pojawiają się i znikają, więc przed każdym przebiegiem czytaj endpoint cen, zamiast na stałe zakładać cokolwiek w kodzie.

Zamawianie tajskiego numeru weryfikacyjnego przez API

Bazowy adres URL to https://otproute.com/api/v1.

1. Wyślij GET /api/v1/prices?country=th&service=<id>; pusta lub niedostępna odpowiedź oznacza, że warto wybrać inny czas lub inną trasę.
2. Wyślij POST /api/v1/activations z treścią taką jak {"service": "line", "country": "th"}. Zapisz zwrócony identyfikator aktywacji razem z przebiegiem testu.
3. Wpisz numer +66 w testowanej aplikacji i wywołaj wysłanie SMS-a.
4. Odbierz kod ze zdarzenia activation.sms_received albo z GET /api/v1/activations/{id}, jeśli odpytujesz.
5. Zbędne zamówienia zwolnij przez POST /api/v1/activations/{id}/cancel.

Weryfikuj nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>) przy każdej dostawie i odrzucaj zdarzenia ze zbyt starym znacznikiem czasu. Zdarzenia są identyfikowane po identyfikatorze aktywacji, dzięki czemu zduplikowane dostawy łatwo zignorować. Pełne przykłady żądań znajdziesz w dokumentacji dla deweloperów.

Tajskie formaty numerów, zero prefiksu krajowego i wiadomości w piśmie tajskim

W kraju tajskie numery komórkowe zapisuje się z początkowym 0 i dziewięcioma kolejnymi cyframi, zwykle zaczynającymi się od 06, 08 lub 09. To 0 to prefiks krajowy: w formie międzynarodowej znika, więc 08x xxx xxxx staje się +66 8x xxx xxxx. Zapisuj wersję E.164 i normalizuj dane wpisane przez użytkownika, które nadal mają zero, bo inaczej deduplikacja uzna jeden telefon za dwie osoby.

Kody z aplikacji kierowanych na rynek tajski często przychodzą wewnątrz zdania po tajsku. Wyodrębniaj kod wzorcem (ciąg cyfr oczekiwanej długości), a nie opierając się na angielskich słowach, i pamiętaj, że SMS-y w piśmie tajskim używają kodowania Unicode, więc wiadomości dzielą się na krótsze segmenty. Drugim powodem testów w tym miejscu jest kontrola lokalizacji: pola dat w tajskich interfejsach często pokazują rok według ery buddyjskiej, a limity długości pól na tajskie imiona i adresy łatwo źle ustawić. Premiery produktów w Azji Południowo-Wschodniej, wdrażanie sprzedawców na platformach handlowych i tajskojęzyczne biura obsługi dopełniają typową listę.

Jak z panelu korzystają zamiast tego pracownicy wsparcia i operacji?

Nie każde sprawdzenie wymaga skryptu. Ktoś z zespołu operacyjnego może się zarejestrować, dodać środki, otworzyć OTP Gateway, wybrać usługę i Tajlandię, sprawdzić podaną cenę i otrzymać numer. Kod pojawia się na karcie aktywacji w przeglądarce. Obowiązuje to samo 20-minutowe okno, a zwrot następuje samoczynnie, jeśli okno zamknie się puste.

Rozwiązywanie problemów: kody, które nie docierają na numer +66

Gdy aktywacja pozostaje pusta, przejdź po tej liście:

• Daj jej pełne okno, zanim anulujesz; opóźnione ponowne wysyłki są częste.
• Potwierdź, że usługa akceptuje numery wirtualne dla Tajlandii. Niektóre nie akceptują i właśnie to obejmuje automatyczny zwrot środków.
• Spróbuj ponownie później albo przełącz się na trasę innego kraju, jeśli pozwala na to Twój przypadek testowy. Artykuł o routingu według kraju wyjaśnia, jak zespoły wybierają trasy zapasowe.
• Rozłóż ponowne próby w czasie. Ponowne zamawianie w ciasnej pętli rzadko pomaga i zaśmieca logi.

Nieudana próba nie kosztuje: wygasła lub anulowana aktywacja zwraca całą kwotę do portfela.

Linie długoterminowe, portfel i sandbox w projektach tajskich

OTP Route nie sprzedaje samoobsługowego, długoterminowego numeru w Tajlandii. Zespoły, które potrzebują trwałej linii tajskiej, mogą zapytać e-mailem na [email protected]; to lokalne przepisy decydują, czy cokolwiek jest możliwe. Numery dedykowane, które zachowujesz i odnawiasz, są dostępne wyłącznie w USA i Kanadzie, od $1.95/miesiąc.

Cała reszta działa na przedpłaconym portfelu w USD bez abonamentu. Zasil go kartą lub w USDT/USDC, a po każdym doładowaniu faktura PDF przychodzi e-mailem. Do prac integracyjnych konto deweloperskie można przenieść do sandboxa, aby symulowane numery i kody przepływały przez Twój kod bez kosztów. Aktualne stawki znajdziesz w cenniku; przestrzegaj regulaminów poszczególnych usług i pamiętaj, że Acceptable Use Policy OTP Route obejmuje każdą aktywację.

Najczęstsze pytania

Czy mogę zweryfikować tajską rejestrację w mojej aplikacji bez tajskiej karty SIM?

Tak. Zamów numer +66 w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu albo przez API i webhooki.

Czy zapisując tajski numer komórkowy, zachować początkowe 0?

Nie. Pomiń prefiks krajowy 0 i zapisz numer jako +66 i pozostałe dziewięć cyfr.

Jakiego identyfikatora oczekuje API dla Tajlandii?

Użyj th jako wartości kraju, na przykład w GET /api/v1/prices?country=th&service=<id>.

Dlaczego wiadomość z LINE lub Shopee przychodzi po tajsku?

Wiele usług lokalizuje szablon SMS według kraju numeru lub języka konta, więc parsuj cyfry, a nie angielskie słowa kluczowe.

Ile kosztuje nieudana aktywacja w Tajlandii?

Nic. Jeśli 20-minutowe okno zakończy się bez SMS-a albo anulujesz zamówienie, cała kwota wraca automatycznie do portfela.

Czy da się uruchamiać tajskie testy OTP w CI bez wydawania pieniędzy?

Tak, poproś o tryb sandbox dla konta deweloperskiego. Zwraca on symulowane numery i kody, dzięki czemu pipeline można przetestować od początku do końca, co opisuje strona rozwiązania CI/CD.

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.