Nhận mã SMS LINE trên số OTP Route: danh sách kiểm tra và các bước thực hiện

LINE dùng số điện thoại để làm gì?

LINE gắn tài khoản với một số điện thoại. Đăng ký mới được xác nhận bằng mã SMS, và ứng dụng có thể hỏi lại số khi tài khoản được chuyển sang thiết bị mới hoặc khi ai đó đăng nhập sau khi cài lại. Số này cũng đóng vai trò trong việc khôi phục quyền truy cập, nên việc tài khoản được tạo bằng số nào là điều quan trọng.

Điểm cuối cùng đó định hình lựa chọn sản phẩm của bạn: số dùng một lần phù hợp với một bước xác minh duy nhất, còn tài khoản phải đăng nhập lại nhiều tháng sau thì cần một số bạn vẫn kiểm soát.

Danh sách kiểm tra trước khi đặt số LINE

• Một khóa API từ Developer console (tiền tố or_live_); tối đa 10 khóa cho mỗi tài khoản.
• Đủ số dư ví, xác nhận bằng GET /api/v1/balance.
• Một quốc gia được chọn khớp với thị trường của tài khoản hoặc tình huống kiểm thử.
• Tra giá trực tiếp cho cặp đó, vì giá khác nhau theo quốc gia.
• Một endpoint webhook đã đăng ký và phần kiểm tra chữ ký đã được thử nghiệm, hoặc một vòng lặp polling sẵn sàng.
• Quyết định xem tài khoản này có phải đăng nhập lại sau này hay không; nếu có, hãy đọc phần số chuyên dụng bên dưới.
• Đọc lại nhanh điều khoản của LINE cho loại tài khoản bạn đang tạo.

Tôi có thể chọn những quốc gia nào cho LINE, và vì sao điều đó quan trọng?

Dịch vụ LINE có sẵn tại 197 quốc gia. Ứng dụng có cơ sở người dùng mạnh nhất ở một số khu vực Đông Á và Đông Nam Á, nên các đội ra mắt ở đó thường bắt đầu với Nhật Bản, Thái Lan, Đài Loan, Indonesia, Hồng Kông hoặc Malaysia. Các lựa chọn khác gồm Singapore, Philippines, Việt Nam, Hàn Quốc, Úc, Hoa Kỳ, Vương quốc Anh, Đức, Brazil và Romania.

Hãy chọn quốc gia nơi người dùng thật của bạn đến từ. Bản build cho thị trường Thái Lan nên được xác minh bằng số Thái để mã quốc gia, định dạng số điện thoại và các màn hình onboarding theo khu vực hoạt động như trong môi trường production. Bao quát nhiều thị trường chỉ tốn thêm rất ít công sức, vì giữa các lần chạy chỉ có giá trị country thay đổi.

Từng bước: luồng API mã xác minh LINE

1. Gọi GET /api/v1/prices?country=<id>&service=linemessenger và xác nhận tuyến đang có sẵn.
2. Tạo activation bằng POST /api/v1/activations với phần thân như {"service": "linemessenger", "country": "th"}.
3. Nhập số được trả về vào màn hình xác minh điện thoại của LINE.
4. Chờ activation.sms_received, hoặc polling GET /api/v1/activations/{id} mỗi vài giây trong giới hạn 300 yêu cầu mỗi phút.
5. Nếu lượt chạy bị bỏ, hãy gọi POST /api/v1/activations/{id}/cancel.

Chi tiết endpoint nằm trong tài liệu dành cho nhà phát triển.

Handler webhook nên xử lý các sự kiện LINE như thế nào?

Đọc header X-OTPRoute-Signature có định dạng t=<unix>,v1=<hex>, tính HMAC-SHA256 trên <t>.<raw body> bằng secret của endpoint, so sánh theo thời gian hằng định, và loại bỏ mọi thứ có timestamp cũ. Sau đó hãy xử lý theo khóa là mã activation, để một lần gửi lại cập nhật cùng một bản ghi thay vì kích hoạt bước kiểm thử của bạn hai lần. Hãy xem activation.expired và activation.cancelled là các kết quả bình thường trong cùng bảng. Hướng dẫn HMAC có phần trình bày đầy đủ.

Đặt số LINE từ dashboard

Đăng nhập, mở OTP Gateway, chọn LINE và một quốc gia, kiểm tra giá hiển thị rồi đặt đơn. Nhập số vào LINE, sau đó giữ thẻ activation mở; mã sẽ xuất hiện ở đó khi được nhận. Quản lý sản phẩm và nhân viên hỗ trợ thường dùng giao diện này để kiểm tra thủ công màn hình onboarding LINE đã bản địa hóa trước khi bộ kiểm thử tự động tiếp quản. Khung thời gian 20 phút và quy tắc hoàn tiền vẫn áp dụng như vậy.

Xử lý sự cố: vì sao mã LINE có thể không đến

LINE có thể từ chối một số số ảo, và một tuyến từng hoạt động có thể không còn khả dụng vào cuối ngày. Nếu không có SMS nào đến, activation được hoàn tiền đầy đủ khi khung thời gian kết thúc hoặc khi bạn hủy. Sau đó:

• thử quốc gia khác vẫn phù hợp với tình huống kiểm thử;
• thử lại sau thay vì đặt lại liên tục trong một vòng lặp;
• xác nhận số đã được nhập với đúng mã quốc gia.

Khi nào số chuyên dụng phù hợp hơn cho LINE?

Nếu tài khoản staging hoặc tài khoản dùng chung của đội phải tiếp tục đăng nhập, số dùng một lần là công cụ không phù hợp. Số chuyên dụng (Dedicated Numbers) tại Hoa Kỳ và Canada bắt đầu từ $1.95/tháng, nhận SMS đến trong dashboard và trên webhook của bạn qua number.sms_received, và được gia hạn từ ví cho đến khi bạn trả lại. Chi tiết có trên trang số ảo.

Chỉ dùng OTP Route cho sản phẩm và tài khoản hợp pháp của chính bạn: mỗi người thật hoặc doanh nghiệp một tài khoản, tôn trọng điều khoản của LINE và tuân thủ Chính sách sử dụng chấp nhận được.

Câu hỏi thường gặp

OTP Route dùng mã dịch vụ nào cho LINE?

Mã là linemessenger. Hãy dùng nó trong truy vấn giá và trong trường service khi tạo activation.

Tôi có thể làm SMS xác minh LINE để kiểm thử mà không cần SIM vật lý không?

Có. Một số OTP Gateway nhận mã LINE, và bạn đọc mã qua API, webhook hoặc dashboard.

Tôi nên chọn quốc gia nào cho số ảo của LINE?

Hãy chọn thị trường mà người dùng hoặc tình huống kiểm thử của bạn thuộc về, ví dụ Nhật Bản hoặc Thái Lan nếu ra mắt ở đó.

LINE có chấp nhận mọi số OTP Route không?

Không phải lúc nào cũng vậy. LINE có thể từ chối một số số ảo, và khi không có mã nào đến bạn được hoàn tiền tự động.

Nhận OTP LINE tốn bao nhiêu?

Từ $0.20 cho mỗi mã, tùy theo quốc gia; giá trực tiếp lấy từ GET /api/v1/prices.

Tôi có thể giữ cùng số điện thoại LINE cho các lần đăng nhập sau không?

Chỉ với số chuyên dụng, có sẵn ở Hoa Kỳ và Canada. Số dùng một lần chỉ dành cho một mã.

Tôi có cần webhook để nhận mã OTP LINE, hay polling là đủ?

Polling GET /api/v1/activations/{id} hoạt động tốt cho các lượt chạy nhỏ. Webhook mở rộng tốt hơn khi nhiều activation chạy song song.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.