Odbieranie kodów weryfikacyjnych WhatsApp bez angażowania telefonu pracownika

Dlaczego zespół potrzebuje numeru WhatsApp, który nie należy do żadnej konkretnej osoby?

Sytuacja jest dobrze znana. Zespół produktowy buduje obsługę klienta w WhatsApp albo testuje, jak aplikacja przekazuje użytkownika do czatu, i ktoś musi zarejestrować konto. Najszybciej jest użyć prywatnego telefonu kolegi. Taki wybór wiąże konfigurację firmową z kartą SIM jednego pracownika, miesza ruch testowy z jego prywatnymi rozmowami i przestaje działać w dniu, w którym ta osoba odchodzi.

Z tą samą barierą mierzą się agencje konfigurujące WhatsApp dla klientów oraz inżynierowie QA, którzy potrzebują konta testowego na konkretnym rynku, by zobaczyć, jak zachowuje się regionalny proces rejestracji. Numer WhatsApp z OTP Gateway odsuwa te prace od prywatnych linii: wybierasz kraj, odbierasz kod rejestracyjny i idziesz dalej.

Kiedy WhatsApp prosi o kod weryfikacyjny z numeru telefonu?

WhatsApp identyfikuje każde konto po numerze telefonu, dlatego kontroluje jego posiadanie jednorazowym kodem w kilku momentach:

• Rejestracja: nowe konto dostaje sześciocyfrowy kod SMS, a WhatsApp może zaproponować połączenie głosowe jako alternatywę.
• Nowe urządzenie: ponowna instalacja lub przeniesienie na inny telefon powtarza weryfikację, a poprzedni telefon zostaje wylogowany.
• Konta firmowe: uruchomienie aplikacji WhatsApp Business na danym numerze przechodzi przez ten sam krok.
• Weryfikacja dwuetapowa: opcjonalny PIN wybierany przez użytkownika. Nigdy nie jest wysyłany SMS-em, ale po włączeniu jest wymagany razem z kodem.

Dla testów wniosek jest prosty: SMS potwierdza, że w danej chwili masz dostęp do numeru, więc numeru, którego już nie posiadasz, nie da się później użyć do ponownej weryfikacji konta.

Jak działa przepływ kodu weryfikacyjnego WhatsApp przez API?

Użyj identyfikatora usługi whatsapp razem z identyfikatorem kraju testowanego rynku, na przykład in, br lub us. Mając klucz Bearer z konsoli deweloperskiej:

1. GET /api/v1/prices?country=<id>&service=whatsapp zwraca aktualną cenę i informację, czy dana trasa jest teraz dostępna.
2. POST /api/v1/activations z treścią {"service": "whatsapp", "country": "<id>"} rezerwuje numer i uruchamia 20-minutowe okno.
3. Wpisz numer na ekranie rejestracji WhatsApp i poproś o SMS.
4. Kod dociera do Ciebie jako zdarzenie webhooka activation.sms_received albo odpytujesz GET /api/v1/activations/{id} co kilka sekund.
5. Jeśli test zostaje przerwany, POST /api/v1/activations/{id}/cancel zwraca kwotę do portfela.

Zanim zaufasz treści żądania, sprawdź X-OTPRoute-Signature: oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj wynik z v1 i odrzucaj zbyt stare znaczniki czasu. Następnie zapisz zdarzenie przy jego identyfikatorze aktywacji, aby powtórne dostarczenie niczego nie zmieniło. Odpytywanie jest prostsze, gdy runner testów nie może udostępnić publicznego adresu URL; obie ścieżki opisuje dokumentacja dla deweloperów.

W których krajach są numery WhatsApp i czy wybór kraju ma znaczenie?

Trasy WhatsApp są obecnie dostępne w 198 krajach, między innymi w Indiach, Brazylii, Indonezji, Nigerii, Niemczech, Meksyku, Wielkiej Brytanii, Stanach Zjednoczonych, Pakistanie, na Filipinach, w Egipcie, Kenii, Hiszpanii, Turcji i Republice Południowej Afryki. Pełną listę znajdziesz na stronie krajów.

Wybieraj kraj świadomie. Jeśli Twój proces rejestracji jest skierowany do użytkowników z Brazylii, numer +55 pokaże, jak aplikacja formatuje, waliduje i wyświetla lokalny numer. Jeśli konto firmowe ma obsługiwać jeden rynek, dopasuj do niego kraj. Przypadkowy kraj niczego nie oszczędza, a może sprawić, że wynik testu straci sens.

Dlaczego kod WhatsApp może nie dotrzeć?

WhatsApp sam decyduje, na jakie numery wysyła kody, i może całkowicie odrzucić numer wirtualny przy rejestracji. Wtedy do aktywacji nic nie dociera, okno się zamyka, a pełna kwota wraca do portfela; płacisz tylko wtedy, gdy kod faktycznie przyjdzie. Inne przyczyny są bardziej zwyczajne: obciążona trasa, prośba WhatsApp o odczekanie przed kolejnym kodem albo kod zamówiony połączeniem głosowym zamiast SMS-em.

Co zrobić:

• Zostaw aktywację otwartą na całe okno, zamiast anulować ją po minucie.
• Upewnij się, że ekran rejestracji zażądał SMS-a, a nie połączenia.
• Spróbuj później albo przez trasę innego kraju, jeśli rynek konta na to pozwala.
• Rozłóż próby w czasie. Zamawianie kodu za kodem w szybkiej pętli zwykle pogarsza sytuację.

Czy długo używane konto WhatsApp powinno mieć numer dedykowany?

Zwykle tak. Numer z OTP Gateway służy do jednego kodu, a jeśli konto trzeba zweryfikować ponownie po zmianie telefonu lub reinstalacji, potrzebny jest dokładnie ten sam numer. W przypadku linii obsługi klienta, wspólnego konta firmowego albo konta QA, z którego testerzy korzystają miesiącami, lepiej sprawdza się Dedicated Virtual Number. Takie numery są sprzedawane od ręki w Stanach Zjednoczonych i Kanadzie od $1.95/month, odnawiają się z portfela, przekazują przychodzące SMS-y na Twój webhook jako number.sms_received i można je zwolnić w każdej chwili. Poza tymi dwoma krajami nie ma samoobsługowej linii długoterminowej; napisz na [email protected] i zapytaj. Szczegóły są na stronie numerów wirtualnych.

Czy osoba bez dostępu do API poradzi sobie z tym w panelu?

Tak. Zaloguj się, doładuj portfel kartą lub stablecoinami USDT/USDC, wybierz WhatsApp i kraj, potwierdź wyświetloną cenę i złóż zamówienie. Wpisz numer w WhatsApp, a kod pojawi się na stronie aktywacji, gdy tylko dotrze. Nie ma opłaty miesięcznej ani planu, każde doładowanie dostaje fakturę PDF e-mailem, a zasada zwrotu jest ta sama co w API. Deweloperzy, którzy chcą najpierw przećwiczyć integrację, mogą poprosić wsparcie o przełączenie konta deweloperskiego w tryb sandbox, w którym symulowane numery i kody pozwalają przetestować webhook bez wydawania środków.

Na czym polega odpowiedzialne korzystanie z numerów WhatsApp?

OTP Route służy do testowania i obsługi własnych, legalnych produktów i kont. Przestrzegaj regulaminu WhatsApp, utrzymuj jedno konto na jedną prawdziwą osobę lub firmę i nie używaj tras do masowej rejestracji kont, wysyłania niechcianych wiadomości ani powrotu na platformę po zablokowaniu. Polityka dopuszczalnego użytkowania OTP Route (Acceptable Use Policy) obowiązuje przy każdej aktywacji. WhatsApp jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązany.

Najczęstsze pytania

Czy mogę odebrać OTP WhatsApp bez karty SIM?

Tak. Numer z OTP Gateway odbiera SMS rejestracyjny WhatsApp i pokazuje kod w panelu lub wysyła go na Twój webhook, bez udziału fizycznej karty SIM.

Jaki jest identyfikator usługi WhatsApp w API?

Użyj whatsapp jako usługi w GET /api/v1/prices i POST /api/v1/activations, razem z identyfikatorem kraju, na przykład in lub us.

Czy WhatsApp zaakceptuje każdy numer wirtualny?

Nie. WhatsApp może odrzucać numery wirtualne, dlatego aktywacja, która nie otrzyma kodu, jest w całości zwracana do portfela.

Czy mogę później ponownie zalogować się do konta WhatsApp tym samym numerem?

Nie z numerem z bramki, który obsługuje pojedynczy kod. Jeśli konto będzie wymagało ponownej weryfikacji, użyj Dedicated Virtual Number w USA lub Kanadzie.

Ile kosztuje numer do weryfikacji WhatsApp?

Ceny zaczynają się od $0.20 za kod i zależą od kraju. Aktualną cenę widać w panelu i w endpoincie cen przed złożeniem zamówienia.

Czy weryfikacja SMS WhatsApp do testów jest możliwa w potoku CI?

Tak, dla własnych kont testowych. Podczas rozwoju buduj na sandboxie, a potem wywołuj trasy produkcyjne oszczędnie, z odstępami między próbami.

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.