Jak wprowadzić wenezuelskie (+58) kody weryfikacyjne do swojego zestawu testów

Dlaczego początkowe 0 powoduje błędy w wenezuelskich numerach?

Kod kraju Wenezueli to +58, a numery krajowe zapisuje się z prefiksem 0. Numery komórkowe wybierane wewnątrz kraju wyglądają jak 0412, 0414, 0416, 0424 lub 0426, po których następuje siedem cyfr. W formacie E.164 to 0 znika: 0414 123 4567 staje się +584141234567.

Klasyczny błąd to formularz, który dokleja +58 do wszystkiego, co wpisał użytkownik, i tworzy +580414…, czyli numer, którego żadna usługa nie przyjmie. Zabezpiecz się tak:

• usuwaj pojedyncze początkowe 0, gdy wybrany kraj to Wenezuela, zanim dodasz kod kraju;
• zapisuj wyłącznie znormalizowany ciąg E.164, a formatowanie do wyświetlania wykonuj w momencie renderowania;
• dodaj przypadek testowy, który wpisuje formę lokalną i sprawdza zapisaną wartość.

Numer +58 do testów z OTP Gateway przychodzi już w formie międzynarodowej, więc dobrze nadaje się jako wartość referencyjna w takich asercjach.

Co powinno sprawdzić QA lokalizacji dla użytkowników z Wenezueli?

Językiem urzędowym jest hiszpański i tego oczekuje większość wenezuelskich użytkowników. Wiadomości weryfikacyjne z globalnych platform zwykle zależą od ustawień regionalnych konta lub urządzenia, więc tester może jednego dnia dostać hiszpański, a następnego angielski, jeśli ustawienia się różnią. Pisz logikę wyodrębniania kodu tak, by szukała cyfr, a nie słów wokół nich.

Po swojej stronie sprawdź hiszpańskie teksty (wariant latynoamerykański) na ekranach wpisywania numeru i kodu, komunikaty o błędnym numerze oraz tekst licznika ponownego wysłania. To właśnie te napisy użytkownik czyta w chwili, gdy najłatwiej porzuca rejestrację.

Gdzie numery wenezuelskie mają znaczenie dla zespołu produktowego?

Wenezuela ma liczną diasporę rozproszoną po Ameryce Łacińskiej, Hiszpanii i Stanach Zjednoczonych, a wiele osób po przeprowadzce zachowuje kartę SIM z numerem +58. Dlatego wenezuelskie numery są istotne daleko poza samym krajem:

• Rejestracje transgraniczne, gdy użytkownik zakłada konto za granicą na numer z kraju pochodzenia, a wykrywanie kraju w Twoim produkcie nie może go odrzucić.
• Obsługa oparta na komunikatorach, bo czaty są kluczowym kanałem kontaktu z firmami; zespoły weryfikują w ten sposób konfiguracje biznesowe WhatsApp i Telegram.
• Premiery regionalne w Ameryce Południowej, które potrzebują jednej realistycznej ścieżki +58 na liście kontrolnej wydania.
• Agencje prowadzące konta społecznościowe wenezuelskich marek, które chcą, by kody trafiały do wspólnego narzędzia, a nie na prywatny telefon menedżera; zobacz agencje i resellerzy.

Co OTP Gateway obejmuje dla Wenezueli?

Na wenezuelskich numerach dostępnych jest ponad 1700 usług. Do często zamawianych należą WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord i LinkedIn. Traktuj to jako zmienny zrzut: dostępność dla danej usługi i kraju jest przeliczana w ciągu dnia i zawsze zwracana na żywo przez API.

Jak wywołać API OTP dla Wenezueli z runnera testów?

Wszystkie żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_. Wygeneruj po jednym dla każdego środowiska w konsoli deweloperskiej (limit to 10 kluczy). Identyfikator kraju dla Wenezueli to ve.

1. Raz na uruchomienie zmapuj czytelne nazwy na identyfikatory przez GET /api/v1/services i GET /api/v1/countries.
2. Tuż przed zamówieniem sprawdź GET /api/v1/prices?country=ve&service=<id>, aby test znał aktualną cenę i wiedział, czy dana para jest oferowana.
3. Zamów przez POST /api/v1/activations z treścią taką jak {"service": "whatsapp", "country": "ve"}.
4. Przekaż zwrócony numer +58 do ekranu, który testujesz.
5. Odbierz activation.sms_received na webhooku albo odpytuj GET /api/v1/activations/{id}; jeśli przepływ zostanie przerwany, na koniec użyj POST /api/v1/activations/{id}/cancel.

Na starcie zestawu sprawdź GET /api/v1/balance. Przy webhookach zweryfikuj X-OTPRoute-Signature (t=<unix>,v1=<hex>), obliczając HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, i odrzucaj nieaktualne znaczniki czasu. Konto pozwala na 5 endpointów webhooków i 300 żądań na minutę. Wzorce dla pipeline'ów opisuje testowanie SMS OTP w pipeline'ach CI oraz dokumentacja API.

Zamawianie ręczne i co robić, gdy kod nie przychodzi

W panelu kroki są krótkie: wybierz Wenezuelę, wybierz usługę, potwierdź cenę, użyj numeru w aplikacji i poczekaj na kod na ekranie. Sprawdza się to u product managerów i liderów supportu, którzy potrzebują szybkiej kontroli bez pisania kodu.

Każda aktywacja ma 20-minutowe okno. Jeśli SMS nie dotrze do tego czasu albo anulujesz zamówienie, cała opłata wraca automatycznie do portfela; płacisz tylko za odebrane kody. Czas dostarczenia zależy od usługi i trasy. Gdy kod się spóźnia, poczekaj do końca okna, a potem spróbuj później lub wybierz inną trasę usługi, zamiast zamawiać w pętli. Sprawdź, czy usługa nie odrzuca numerów wirtualnych dla danej czynności, bo niektóre tak robią. Przestrzegaj regulaminów poszczególnych usług; obowiązuje też Zasady dopuszczalnego użytkowania OTP Route.

Czy mogę zachować numer +58 i jak zasilić portfel?

Nie w trybie samoobsługowym. Dedykowane numery wirtualne, od $1.95/month, można kupić natychmiast tylko dla Stanów Zjednoczonych i Kanady (zobacz numery wirtualne). Zespoły potrzebujące długotrwałej linii wenezuelskiej mogą napisać na [email protected]; o możliwości decydują lokalne przepisy.

Płatność działa w modelu pay as you go z jednego przedpłaconego portfela w USD, bez planu i opłaty miesięcznej. Środki dodasz kartą lub w USDT/USDC, a każde doładowanie dostaje fakturę PDF e-mailem. Na prośbę konto deweloperskie można przełączyć na sandbox, który zwraca symulowane numery i kody do kompleksowych testów integracji. Koszty porównasz w cenniku.

Najczęstsze pytania

Czy mogę przetestować rejestrację wenezuelskiego użytkownika bez wenezuelskiej karty SIM?

Tak. Zamów numer +58 w OTP Gateway, wpisz go w aplikacji, a kod pojawi się w panelu lub trafi na Twój webhook.

Jaki jest identyfikator Wenezueli w API OTP Route?

ve. Używasz go w GET /api/v1/prices oraz jako wartość country przy tworzeniu aktywacji.

Czy przy zapisie wenezuelskiego numeru komórkowego zostawiać 0?

Nie. Usuń krajowe 0 i zapisz +58 oraz pozostałe cyfry, na przykład +58414 i dalej siedem cyfr.

Ile kosztuje wenezuelski numer weryfikacyjny?

Od $0.20 za kod; API i panel pokazują dokładną cenę dla usługi przed zamówieniem. Niewykorzystane aktywacje są zwracane.

Dlaczego wenezuelski kod przyszedł po angielsku?

Język wybiera usługa wysyłająca, zwykle na podstawie ustawień regionalnych konta lub urządzenia. Wyodrębniaj cyfry, zamiast polegać na brzmieniu wiadomości.

Czy dla Wenezueli jest dedykowany numer długoterminowy?

Nie ma opcji samoobsługowej; dedykowane linie to produkt dla USA i Kanady. W sprawie Wenezueli możesz napisać na [email protected].

Czy OTP Route można wykorzystać do obchodzenia ograniczeń platform?

Nie. Usługa służy do testowania i obsługi własnych, legalnych produktów i kont, po jednym na osobę lub firmę, zgodnie z regulaminami poszczególnych usług.

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.