Lista kontrolna przed startem: odbieranie kodów logowania Telegram na numerze testowym

Co powinno być gotowe przed zamówieniem numeru Telegram?

Przejrzyj najpierw tę listę; większość nieudanych testów Telegrama wynika z jednego z tych punktów.

• Jasny cel. Testujesz bota, Mini App, widżet logowania lub proces obsługi klienta prowadzony przez Twój zespół i potrzebujesz świeżego konta Telegram, które nie jest powiązane z prywatnym telefonem żadnego pracownika.
• Docelowy kraj. Ustal, do jakiego rynku ma należeć konto. Domyślny język i niektóre ekrany powitalne zależą od kraju numeru.
• Środki w portfelu lub sandbox. Zasilony portfel prepaid albo konto deweloperskie przełączone przez wsparcie w tryb sandbox do prób na sucho.
• Klucz API, jeśli automatyzujesz. Utwórz go z prefiksem or_live_ w konsoli deweloperskiej.
• Czyste urządzenie lub emulator. Telegram dostarcza kody w aplikacji do każdej już zalogowanej sesji, więc urządzenie bez istniejącej sesji sprawia, że ścieżka SMS jest przewidywalna.
• Czas. Każda aktywacja jest otwarta przez 20 minut; nie uruchamiaj jej, dopóki tester nie jest gotów wpisać numeru.

Kiedy Telegram faktycznie wysyła kod SMS?

Telegram identyfikuje każde konto po numerze telefonu. Prosi o kod, gdy ktoś rejestruje nowe konto oraz gdy istniejące konto loguje się na nowym urządzeniu. Jeśli konto jest już aktywne gdzie indziej, Telegram zwykle wysyła kod logowania jako wiadomość w istniejącej sesji, a nie SMS-em, dlatego zupełnie nowy numer na świeżym urządzeniu to najczystszy sposób przetestowania kroku z SMS-em. Po krótkim oczekiwaniu może też zaproponować połączenie lub ponowne wysłanie.

Weryfikacja dwuetapowa w Telegramie to osobne hasło w chmurze ustawiane w aplikacji. Nie jest czynnikiem SMS, więc jeśli włączysz ją na koncie testowym, przechowuj to hasło w menedżerze sekretów swojego zespołu.

Jaki kraj mogę wybrać dla Telegrama i dlaczego to ma znaczenie?

Usługa telegram jest obecnie dostępna w 199 krajach, w tym w Indiach, Niemczech, Brazylii, Nigerii, Indonezji, Wielkiej Brytanii, na Ukrainie, w Kazachstanie, Uzbekistanie, Turcji, Hiszpanii, Meksyku, na Filipinach, w Wietnamie i Egipcie.

Dopasuj kraj do przypadku testowego. Bota odpowiadającego po portugalsku warto wypróbować z konta brazylijskiego; zespół obsługujący Azję Środkową może potrzebować numeru kazachskiego. Telegram potrafi też traktować numery z niektórych krajów ostrożniej niż z innych, więc jeśli jedna trasa stale zawodzi, rozsądnym wyjściem jest sąsiedni rynek. Dostępność zmienia się w ciągu dnia, dlatego odczytuj ją z API, a nie z zapisanej listy.

Jak zautomatyzować odbiór kodu Telegram przez API?

1. Opcjonalnie sprawdź koszt przez GET /api/v1/prices?country=<id>&service=telegram.
2. Utwórz zamówienie: POST /api/v1/activations z treścią {"service": "telegram", "country": "<id>"}, gdzie identyfikator kraju pochodzi z GET /api/v1/countries (na przykład br lub de).
3. Przekaż zwrócony numer swojemu runnerowi testów, który wpisze go w kliencie Telegrama lub emulatorze.
4. Poczekaj na kod. Przy webhooku nasłuchuj activation.sms_received; w przeciwnym razie odpytuj GET /api/v1/activations/{id} w rozsądnych odstępach.
5. Posprzątaj przez POST /api/v1/activations/{id}/cancel, jeśli przebieg zostanie przerwany.

W przypadku webhooków zweryfikuj X-OTPRoute-Signature, ponownie obliczając HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, odrzucaj stare znaczniki czasu i zapisuj identyfikator każdej przetworzonej aktywacji, aby ponownie dostarczone zdarzenie zostało zignorowane. Na konto przypada do 5 endpointów webhooków i 300 żądań na minutę. O równoległych przebiegach mówi przewodnik po potokach CI.

Czy te same kroki mogę wykonać ręcznie w panelu?

Tak. Zaloguj się, otwórz OTP Gateway, wybierz Telegram i kraj, sprawdź cenę i złóż zamówienie. Skopiuj numer na ekran telefonu w Telegramie, wybierz pasujący kod kraju i poproś o kod. Gdy SMS dotrze, pojawi się obok zamówienia, gotowy do wklejenia.

Kod Telegram nie dotarł. Co jest na liście kontrolnej rozwiązywania problemów?

• Czy istnieje już sesja? Jeśli numer był wcześniej używany, Telegram mógł wysłać kod w aplikacji. Nowa aktywacja pozwala tego uniknąć.
• Czy okno się zakończyło? Pozwól odliczyć 20 minut. Płacisz tylko wtedy, gdy kod dotrze; wygaśnięcie lub anulowanie automatycznie zwraca pełną kwotę.
• Czy trasa jest akceptowana? Telegram może odrzucać niektóre numery wirtualne. Nie mamy na to wpływu i właśnie dlatego istnieje zasada zwrotu.
• Ponów z odstępami. Zamów ponownie później lub w innym kraju; nie zamawiaj w ciasnej pętli, co nie pomaga ani dostarczeniu, ani Twojemu limitowi żądań.
• Sprawdź kod kraju na urządzeniu. Niezgodność wybranego kraju z numerem to łatwy błąd w testach ręcznych.

Kiedy numer dedykowany lepiej pasuje do Telegrama?

Jednorazowy numer z OTP Gateway nadaje się do testów rejestracji. Jeśli konto Telegram musi zalogować się ponownie za miesiąc, na przykład konto zespołowe prowadzące kanał obsługi klienta albo logowanie administratora bota, potrzebuje numeru, nad którym Twój zespół wciąż ma kontrolę. Numery Dedicated w Stanach Zjednoczonych i Kanadzie, od $1.95/month, pozostają Twoje na czas odnawiania i przekazują przychodzące SMS-y do panelu oraz na Twój webhook jako number.sms_received. Porównanie numerów tymczasowych i dedykowanych wyjaśnia, na czym polega wybór.

Jak wygląda odpowiedzialne testowanie Telegrama?

Przestrzegaj regulaminu Telegrama. Zakładaj jedno konto na jedną prawdziwą osobę lub cel biznesowy, używaj go do własnych produktów, botów i działań operacyjnych, a nigdy do spamu, masowego tworzenia kont ani obchodzenia blokady. Każde zamówienie Telegrama podlega też polityce dopuszczalnego użytkowania OTP Route (Acceptable Use Policy). Telegram jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązany.

Najczęstsze pytania

Czy mogę dostać kod weryfikacyjny Telegram bez użycia prywatnego telefonu?

Tak. Zamów numer Telegram w OTP Gateway od OTP Route, wpisz go w aplikacji i odczytaj kod SMS w panelu lub przez API.

Jaki jest identyfikator usługi Telegram w API?

To telegram. Połącz go z identyfikatorem kraju z GET /api/v1/countries przy tworzeniu aktywacji.

Ile kosztuje weryfikacja SMS Telegram do testów?

Od $0.20 za kod; dokładna cena zależy od kraju i jest zwracana na żywo przez endpoint cen.

Dlaczego Telegram wysłał kod w aplikacji zamiast SMS-em?

Telegram dostarcza kody logowania do istniejącej sesji, gdy jest dostępna. Aby przetestować ścieżkę SMS, użyj świeżego numeru i urządzenia bez zalogowanej sesji.

Czy mogę użyć jednorazowego numeru, by później ponownie zalogować się do Telegrama?

Nie, numery OTP Gateway obsługują pojedynczy kod. Do powtarzanych logowań użyj numeru Dedicated w USA lub Kanadzie.

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

Nie. Jeśli kod nie dotrze na numer w ciągu 20 minut albo anulujesz zamówienie, cała kwota wraca do portfela.

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.