Odbieranie kodów SMS z Zoho do testów i kont firmowych

Sytuacja: ekran Zoho prosi o numer komórkowy

Zespoły trafiają na ten krok na kilka przewidywalnych sposobów. Programista integracji potrzebuje świeżego konta Zoho, by przetestować połączenie OAuth z CRM, Books lub Desk. Agencja konfiguruje Zoho Mail i Zoho One dla klienta i nie chce wiązać loginu administratora z prywatnym telefonem pracownika. Lider QA musi wykazać, że rejestracja działa tak samo dla użytkownika w Dubaju jak w Sydney. W każdym przypadku przeszkodą jest ta sama wiadomość SMS, a osoba, która jej potrzebuje, rzadko ma pod ręką kartę SIM z właściwego kraju.

OTP Route zamienia tę wiadomość w coś, o co Twoje narzędzia mogą poprosić, na co mogą poczekać i co mogą odczytać.

Gdzie Zoho wymaga weryfikacji telefonu?

Zoho zwykle prosi o numer komórkowy przy tworzeniu nowego konta i może używać SMS-a jako drugiego składnika przy logowaniu, obok swojej aplikacji uwierzytelniającej. Zweryfikowany numer służy też do odzyskiwania konta po utracie hasła. To, kiedy dokładnie pojawia się żądanie kodu, zależy od produktu, regionu konta i ustawień bezpieczeństwa wybranych przez administratora, więc buduj testy tolerujące zarówno pojawienie się monitu, jak i jego brak.

Wybór kraju dla numeru Zoho

Usługa zoho jest obecnie obsługiwana w 198 krajach. Dopasuj numer do rynku konta, które tworzysz lub testujesz, bo kraj wpływa na numer kierunkowy oczekiwany przez Zoho, język wiadomości, a czasem także na to, w którym regionalnym centrum danych wyląduje konto.

Często wybierane trasy to Indie, Stany Zjednoczone, Wielka Brytania, Zjednoczone Emiraty Arabskie, Australia i Niemcy. Na liście są też Kanada, Brazylia, Meksyk, Singapur, Arabia Saudyjska, RPA, Holandia, Hiszpania, Francja, Japonia, Indonezja, Malezja i Kenia. Dostępność zmienia się w ciągu dnia, więc odczytaj ją z GET /api/v1/countries na początku przebiegu.

Podłączanie API kodu weryfikacyjnego Zoho do testów

Wywołania trafiają na https://otproute.com/api/v1 z kluczem Bearer z konsoli deweloperskiej.

1. Pobierz cenę przez GET /api/v1/prices?country=<id>&service=zoho.
2. Utwórz aktywację: POST /api/v1/activations z treścią {"service": "zoho", "country": "<id>"}.
3. Niech automatyzacja przeglądarki wpisze zwrócony numer w formularz Zoho i zażąda kodu.
4. Poczekaj na zdarzenie activation.sms_received, powiązane z identyfikatorem aktywacji, na swoim endpoincie webhooka.

Dwa nawyki czynią obsługę niezawodną. Po pierwsze, sprawdzaj X-OTPRoute-Signature, obliczając HMAC-SHA256 z "<t>.<raw body>" sekretem endpointu i odrzucając przeterminowane znaczniki czasu. Po drugie, zadbaj o idempotentność: zapisuj identyfikator aktywacji i ignoruj powtórne dostarczenie, aby kod nigdy nie został wysłany dwa razy. Jeśli Twój runner testów nie przyjmuje ruchu przychodzącego, odpytuj zamiast tego GET /api/v1/activations/{id} i trzymaj się poniżej 300 żądań na minutę. Oba wzorce pokazuje poradnik przechwytywania przez webhooki.

Ręcznie w panelu

Przy jednorazowych konfiguracjach otwórz OTP Gateway, wybierz Zoho, wskaż kraj, sprawdź wyświetlaną cenę i potwierdź. Skopiuj numer do Zoho, naciśnij przycisk wysyłający kod i zostaw aktywację otwartą. Kod pojawi się na ekranie po nadejściu. Masz 20 minut; jeśli nic nie przyjdzie albo anulujesz, pełna kwota wraca do portfela.

Dlaczego OTP z Zoho może nie dotrzeć

Brak kodu zwykle ma zwyczajną przyczynę:

• Zoho może odrzucać numery wirtualne w niektórych regionach lub dla niektórych typów kont. To jego decyzja i właśnie dlatego zwroty są automatyczne.
• Trasa dla danego kraju może być w tej chwili przeciążona. Spróbuj później albo z innym krajem pasującym do testu.
• Powtarzane żądania z jednej sesji przeglądarki mogą być ograniczane przez samo Zoho, więc rozstaw próby w czasie.
• Zamawianie nowych aktywacji w ciasnej pętli nie pomaga i zjada Twój budżet API.

Poczekaj, aż okno wygaśnie, zanim uznasz, że trasa zawiodła.

Kiedy lepszy jest numer dedykowany

Aktywacja jednorazowa jest właściwa do tworzenia i testowania kont. Nie nadaje się do loginu administratora, który w przyszłym miesiącu znów zapyta o SMS, bo tego numeru już nie będziesz mieć. W takim przypadku numer dedykowany od $1.95/miesiąc daje amerykańską lub kanadyjską linię, którą zachowujesz, dopóki się odnawia, z przychodzącymi SMS-ami w panelu i przekazywanymi na webhook. Linie dedykowane są oferowane tylko w tych dwóch krajach. Więcej o numerach wirtualnych.

Odpowiedzialne korzystanie z numerów Zoho

Przestrzegaj regulaminu Zoho. Zakładaj jedno konto na jedną prawdziwą osobę lub firmę i używaj OTP Route do testowania oraz obsługi własnych legalnych produktów i kont klientów, nigdy do masowego produkowania rejestracji. OTP Route nie jest powiązany z Zoho, którego nazwa jest znakiem towarowym swojego właściciela, a do każdej aktywacji stosuje się Acceptable Use Policy. Agencje obsługujące wielu klientów mogą przeczytać stronę rozwiązania dla agencji.

Najczęstsze pytania

Jak odebrać OTP z Zoho przez API?

Utwórz aktywację z identyfikatorem usługi zoho i wybranym krajem, a potem odczytaj kod z webhooka activation.sms_received albo przez odpytywanie aktywacji.

Czy mogę użyć numeru wirtualnego do weryfikacji SMS Zoho w testach?

Często tak, ale Zoho może w niektórych przypadkach odrzucać numery wirtualne. Jeśli kod nie dotrze w ciągu 20 minut, opłata zostaje zwrócona.

Ile kosztuje numer telefonu Zoho na jeden kod?

Od $0.20 za kod. Aktualną cenę dla danego kraju zwraca endpoint cen i pokazuje panel.

Jaki kraj wybrać dla konta testowego Zoho?

Wybierz kraj użytkownika lub rynku, który testujesz, aby numer kierunkowy i język wiadomości odpowiadały prawdziwemu przypadkowi.

Czy mogę zachować ten sam numer do przyszłych logowań w Zoho?

Nie z aktywacją jednorazową. Dla konta, które musi się jeszcze weryfikować, rozwiązaniem jest amerykański lub kanadyjski numer dedykowany.

Czy mogę przetestować przepływ bez wydawania środków z portfela?

Tak. Konto deweloperskie można na prośbę przełączyć na sandbox, który zwraca symulowane numery i kody. Szczegóły w dokumentacji.

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.