Odbieranie kodów SMS LINE na numerach OTP Route: lista kontrolna i kroki

Do czego LINE używa numeru telefonu?

LINE wiąże konto z numerem telefonu. Nowa rejestracja jest potwierdzana kodem SMS, a aplikacja może ponownie poprosić o numer, gdy konto jest przenoszone na nowe urządzenie lub gdy ktoś loguje się po reinstalacji. Numer odgrywa też rolę w odzyskiwaniu dostępu, więc ma znaczenie, z jakim numerem utworzono konto.

Ten ostatni punkt kształtuje wybór produktu: numer jednorazowy pasuje do pojedynczego kroku weryfikacji, natomiast konto, które musi zalogować się ponownie po miesiącach, potrzebuje numeru, który nadal kontrolujesz.

Lista kontrolna przed zamówieniem numeru LINE

• Klucz API z konsoli deweloperskiej (prefiks or_live_); do 10 kluczy na konto.
• Wystarczające saldo portfela, potwierdzone przez GET /api/v1/balance.
• Kraj dobrany do rynku konta lub przypadku testowego.
• Sprawdzenie aktualnej ceny dla tej pary, ponieważ ceny różnią się w zależności od kraju.
• Zarejestrowany endpoint webhooka z przetestowaną weryfikacją podpisu albo gotowa pętla odpytywania.
• Decyzja, czy to konto musi później logować się ponownie; jeśli tak, przeczytaj poniższą sekcję o numerach dedykowanych.
• Szybkie ponowne przeczytanie regulaminu LINE dla typu tworzonego konta.

Jakie kraje mogę wybrać dla LINE i dlaczego to ma znaczenie?

Usługa LINE jest dostępna w 197 krajach. Aplikacja ma najsilniejszą bazę użytkowników w częściach Azji Wschodniej i Południowo-Wschodniej, więc zespoły wchodzące na te rynki często zaczynają od Japonii, Tajlandii, Tajwanu, Indonezji, Hongkongu lub Malezji. Inne opcje to Singapur, Filipiny, Wietnam, Korea Południowa, Australia, Stany Zjednoczone, Wielka Brytania, Niemcy, Brazylia i Rumunia.

Wybierz kraj, z którego pochodzą Twoi prawdziwi użytkownicy. Wersję na rynek tajski należy weryfikować numerem tajskim, aby numer kierunkowy kraju, format numeru telefonu i ewentualne regionalne ekrany onboardingu zachowywały się tak jak na produkcji. Pokrycie kilku rynków wymaga niewiele dodatkowej pracy, ponieważ między uruchomieniami zmienia się tylko wartość country.

Krok po kroku: przepływ API kodów weryfikacyjnych LINE

1. Wywołaj GET /api/v1/prices?country=<id>&service=linemessenger i potwierdź, że trasa jest dostępna.
2. Utwórz aktywację przez POST /api/v1/activations z treścią taką jak {"service": "linemessenger", "country": "th"}.
3. Wpisz zwrócony numer na ekranie weryfikacji telefonu LINE.
4. Poczekaj na activation.sms_received albo odpytuj GET /api/v1/activations/{id} co kilka sekund, mieszcząc się w limicie 300 żądań na minutę.
5. Jeśli uruchomienie zostanie porzucone, wywołaj POST /api/v1/activations/{id}/cancel.

Szczegóły endpointów znajdziesz w dokumentacji dla deweloperów.

Jak handler webhooka powinien traktować zdarzenia LINE?

Odczytaj nagłówek X-OTPRoute-Signature w formacie t=<unix>,v1=<hex>, oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj wszystko ze starym znacznikiem czasu. Następnie kluczuj przetwarzanie identyfikatorem aktywacji, aby ponowiona dostawa aktualizowała ten sam rekord, zamiast dwukrotnie uruchamiać krok testu. Traktuj activation.expired i activation.cancelled jako czyste wyniki w tej samej tabeli. Przewodnik po HMAC zawiera pełny opis.

Zamawianie numeru LINE z poziomu panelu

Zaloguj się, otwórz OTP Gateway, wybierz LINE i kraj, sprawdź wyświetloną cenę i zamów. Wpisz numer w LINE, a następnie zostaw otwartą kartę aktywacji; kod pojawi się tam po odebraniu. Menedżerowie produktu i agenci wsparcia często używają tego widoku, aby ręcznie sprawdzić zlokalizowany ekran onboardingu LINE, zanim przejmie go zautomatyzowany zestaw testów. Obowiązują to samo 20-minutowe okno i zasada zwrotu.

Rozwiązywanie problemów: dlaczego kod LINE może nie dotrzeć

LINE może odrzucać niektóre numery wirtualne, a trasa, która działała wcześniej, może być niedostępna później w ciągu dnia. Jeśli SMS nie dotrze, aktywacja jest zwracana w całości po zamknięciu okna lub po anulowaniu. Następnie:

• spróbuj innego kraju, który nadal pasuje do przypadku testowego;
• ponów próbę później, zamiast składać zamówienia w ciasnej pętli;
• upewnij się, że numer wpisano z właściwym numerem kierunkowym kraju.

Kiedy numer dedykowany lepiej pasuje do LINE?

Jeśli konto stagingowe lub wspólny login zespołu musi nadal się logować, numer jednorazowy to złe narzędzie. Numery dedykowane w Stanach Zjednoczonych i Kanadzie kosztują od $1.95/month, odbierają przychodzące SMS-y w panelu i na Twoim webhooku przez number.sms_received i odnawiają się z portfela, dopóki ich nie zwolnisz. Szczegóły znajdziesz na stronie numerów wirtualnych.

Używaj OTP Route wyłącznie do własnych, legalnych produktów i kont: jedno konto na prawdziwą osobę lub firmę, z poszanowaniem regulaminu LINE i zgodnie z Polityką dopuszczalnego użytkowania.

Najczęstsze pytania

Jakiego identyfikatora usługi OTP Route używa dla LINE?

Identyfikator to linemessenger. Użyj go w zapytaniu o ceny i w polu service przy tworzeniu aktywacji.

Czy mogę wykonać weryfikację SMS LINE do testów bez fizycznej karty SIM?

Tak. Numer OTP Gateway odbiera kod LINE, który odczytujesz przez API, webhook lub panel.

Jaki kraj wybrać dla numeru wirtualnego dla LINE?

Wybierz rynek, do którego należą Twoi użytkownicy lub przypadek testowy, na przykład Japonię lub Tajlandię przy premierze na tych rynkach.

Czy LINE zaakceptuje każdy numer OTP Route?

Nie zawsze. LINE może odrzucać niektóre numery wirtualne, a gdy kod nie dotrze, otrzymujesz automatyczny zwrot.

Ile kosztuje odebranie OTP LINE?

Od $0.20 za kod, w zależności od kraju; aktualną cenę zwraca GET /api/v1/prices.

Czy mogę zachować ten sam numer LINE do późniejszych logowań?

Tylko z numerem dedykowanym, dostępnym w USA i Kanadzie. Numery jednorazowe służą do jednego kodu.

Czy do odbierania kodów OTP LINE potrzebny jest webhook, czy wystarczy odpytywanie?

Odpytywanie GET /api/v1/activations/{id} dobrze sprawdza się przy małych uruchomieniach. Webhooki lepiej się skalują, gdy równolegle działa wiele aktywacji.

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.