Nhận mã SMS imo để kiểm thử và vận hành tài khoản

Tình huống: sản phẩm của bạn liên quan đến imo, và mỗi lần kiểm thử đều cần một số điện thoại

imo là ứng dụng nhắn tin và gọi thoại, gọi video, nhận diện mỗi tài khoản bằng số điện thoại. Đăng ký hoặc chuyển tài khoản sang thiết bị mới đều kích hoạt một mã dùng một lần qua SMS. Thiết kế này đơn giản với người dùng nhưng bất tiện với các nhóm làm việc: ai xây dựng tích hợp, quy trình hỗ trợ hoặc thử nghiệm thị trường có liên quan đến imo đều cần một số liên lạc được cho mỗi lần thử.

Dùng điện thoại của nhân viên sẽ trộn số cá nhân với tài khoản công việc và không mở rộng được cho ma trận kiểm thử nhiều quốc gia. Một số dùng một lần từ OTP Gateway xử lý đúng một mã, giữ số riêng tư ngoài cuộc, và có thể đặt bằng code hoặc thao tác tay. Trang xác minh ứng dụng di động mô tả mô hình tổng quát hơn.

Những quốc gia nào có thể nhận mã OTP imo?

Dịch vụ imo hiện khả dụng tại 197 quốc gia. Một số ví dụ gồm Ấn Độ, Pakistan, Bangladesh, Nepal, Ả Rập Xê Út, Các Tiểu vương quốc Ả Rập Thống nhất, Ai Cập, Nigeria, Kenya, Indonesia, Philippines, Đức, Bỉ, Vương quốc Anh, Hoa Kỳ và Canada.

Hãy chọn quốc gia khớp với trường hợp bạn đang kiểm thử. Nếu đội hỗ trợ của bạn phục vụ khách hàng ở Nam Á, một số thuộc khu vực đó sẽ tái hiện đúng luồng họ gặp, kể cả ngôn ngữ của SMS và các bước kiểm tra theo khu vực mà dịch vụ áp dụng. Danh sách quốc gia cho phép duyệt mọi tuyến.

Luồng API mã xác minh imo hoạt động như thế nào?

Tạo một khóa Bearer trong Developer console (tiền tố or_live_, tối đa 10 khóa mỗi tài khoản) rồi gọi https://otproute.com/api/v1; giới hạn là 300 yêu cầu mỗi phút.

1. Tra cứu id bằng GET /api/v1/services và GET /api/v1/countries; id của dịch vụ là imo.
2. Xem giá của cặp dịch vụ và quốc gia bằng GET /api/v1/prices?country=pk&service=imo.
3. Đặt số bằng POST /api/v1/activations với {"service": "imo", "country": "pk"}, rồi lưu activation id.
4. Nhập số được trả về vào màn hình đăng ký của imo.
5. Nhận mã từ webhook activation.sms_received, hoặc polling GET /api/v1/activations/{id} nếu bạn không thể mở một endpoint công khai.

Với webhook, hãy xác minh X-OTPRoute-Signature: t=<unix>,v1=<hex> bằng cách tính HMAC-SHA256 của "<t>.<raw body>" với secret của endpoint, và từ chối các timestamp cũ. Hãy làm cho handler idempotent, lấy activation id làm khóa, để một lần gửi lại chỉ được xử lý một lần. Lược đồ đầy đủ nằm trong tài liệu.

Có thể đặt số imo từ dashboard thay vì dùng API không?

Có. Đăng ký bằng email và mã email 6 chữ số, hoặc đăng nhập bằng Google, rồi bật xác thực hai yếu tố TOTP. Nạp tiền vào ví, chọn imo và một quốc gia, kiểm tra giá hiển thị rồi xác nhận. Nhập số vào imo, và mã sẽ xuất hiện trong dashboard ngay khi được gửi đến. Cách này phù hợp với nhân viên hỗ trợ hoặc quản lý tài khoản agency cần một lần xác minh mà không phải viết code.

Vì sao mã imo có thể không đến, và nên làm gì?

Mỗi activation mở trong 20 phút, và bạn chỉ trả tiền nếu mã đến. Đơn hết hạn hoặc bị hủy sẽ được hoàn lại đầy đủ vào ví một cách tự động.

Mã không đến thường vì những lý do bình thường: imo có thể từ chối số ảo trong một số trường hợp, một tuyến có thể đang bận, hoặc dịch vụ thêm bước kiểm tra với các số mà nó đã từng thấy. Khi đó:

• Hãy để khung thời gian chạy hết thay vì hủy sớm.
• Thử lại sau, hoặc thử tuyến của quốc gia khác vẫn phù hợp với bài kiểm thử.
• Đặt khoảng nghỉ và giới hạn số lần thử lại; đặt liên tiếp nhiều đơn imo chỉ làm cạn số lần thử.

Khi nào Dedicated Number phù hợp hơn cho imo?

Vì imo gắn tài khoản với số điện thoại, một số dùng một lần không thể nhận mã sau đó khi cùng tài khoản đăng nhập trên thiết bị khác. Với đường dây hỗ trợ, tài khoản vận hành dùng chung hoặc tài khoản staging cần hoạt động liên tục, Dedicated Number là lựa chọn tốt hơn. Loại số này chỉ có ở Hoa Kỳ và Canada, từ $1.95/tháng, nhận SMS đến trong dashboard và gửi tới webhook của bạn qua number.sms_received. Trang số chuyên dụng giải thích việc gia hạn và trả số.

Sử dụng có trách nhiệm và thanh toán

Hãy tuân thủ điều khoản dịch vụ của imo: mỗi người thật hoặc doanh nghiệp chỉ một tài khoản, không đăng ký hàng loạt hay giả mạo. OTP Route dùng để kiểm thử luồng sản phẩm của chính bạn và vận hành các tài khoản hợp pháp của bạn, và Chính sách Sử dụng Chấp nhận được của chúng tôi áp dụng. imo là nhãn hiệu của chủ sở hữu, và OTP Route không có liên kết nào với họ.

Thanh toán dùng một ví USD trả trước, trả theo mức dùng, không phí hàng tháng. Bạn nạp tiền bằng thẻ hoặc USDT/USDC, và hóa đơn PDF được gửi qua email sau mỗi lần nạp, giúp chi phí kiểm thử imo dễ đối soát. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu để kiểm thử đầu cuối với số và mã mô phỏng.

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

Làm thế nào để nhận OTP imo qua API?

Tạo một activation với {"service": "imo", "country": "<id>"}, nhập số vào imo, rồi đọc mã từ webhook hoặc GET /api/v1/activations/{id}.

Xác minh SMS imo để kiểm thử có khả dụng ở quốc gia của tôi không?

Hiện imo được liệt kê ở 197 quốc gia. Hãy kiểm tra GET /api/v1/countries hoặc dashboard để biết tình trạng khả dụng trực tiếp.

imo có chấp nhận số ảo mọi lúc không?

Không. imo có thể từ chối một số số ảo, vì vậy đơn không có mã sẽ được hoàn tiền đầy đủ sau 20 phút.

Số điện thoại imo từ OTP Route có giá bao nhiêu?

Từ $0.20 mỗi mã, tùy theo quốc gia. Giá trực tiếp được trả về bởi GET /api/v1/prices.

Tôi có thể đăng nhập lại cùng một tài khoản imo sau này bằng số dùng một lần không?

Không đáng tin cậy, vì mỗi số dùng một lần chỉ xử lý một mã. Hãy dùng Dedicated Number của Hoa Kỳ hoặc Canada cho các tài khoản cần đăng nhập lại.

Webhook của tôi nên xử lý các lần gửi trùng lặp của imo như thế nào?

Xác minh chữ ký, rồi chỉ xử lý mỗi activation id một lần để các lần gửi lại không lặp lại công việc.

Tôi có thể tạo nhiều tài khoản imo bằng cách này không?

Chỉ dành cho những người thật hoặc doanh nghiệp bạn đại diện, trong khuôn khổ điều khoản của imo. Đăng ký hàng loạt hoặc giả mạo không được phép.

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.