Tiếng Việt
Nhận OTP Zalo trên số OTP Route thông qua API
Một nhóm nhận mã xác minh Zalo bằng cách đặt một số dùng một lần cho dịch vụ zalo từ OTP Gateway của OTP Route, nhập số đó vào Zalo, rồi đọc mã từ dashboard, một lần polling REST hoặc webhook có chữ ký. Giá bắt đầu từ $0.20 mỗi mã tùy theo quốc gia, và nếu không có mã nào đến trong khung thời gian 20 phút thì ví được hoàn tiền đầy đủ.
Luồng API mã xác minh Zalo trông như thế nào?
Id của dịch vụ là zalo. Các lệnh gọi đi tới https://otproute.com/api/v1 với khóa Bearer có tiền tố or_live_, được cấp trong Developer console.
- Lấy id quốc gia từ
GET /api/v1/countries; chẳng hạn Việt Nam làvn. - Kiểm tra giá và tình trạng khả dụng trực tiếp bằng
GET /api/v1/prices?country=vn&service=zalo. - Tạo activation:
POST /api/v1/activationsvới{"service": "zalo", "country": "vn"}. Lưu activation id và số được trả về. - Nhập số vào màn hình điện thoại của Zalo trên tài khoản thử nghiệm do bạn kiểm soát.
- Nhận mã qua webhook hoặc polling, hoặc kết thúc đơn bằng
POST /api/v1/activations/{id}/cancel.
Kiểm tra số dư bằng GET /api/v1/balance ở đầu bộ kiểm thử sẽ tránh những bất ngờ giữa chừng. Xem tài liệu API để biết đầy đủ cấu trúc yêu cầu.
Xây dựng bộ nhận webhook cho mã Zalo
Đăng ký một endpoint trong Developer console và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled. Mỗi yêu cầu có header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>; hãy 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à từ chối các timestamp cũ.
Hãy làm cho handler idempotent bằng cách lấy activation id làm khóa lưu kết quả. Nếu cùng một sự kiện được gửi hai lần, lần ghi thứ hai nên không có tác dụng. Các nhóm không có endpoint công khai có thể polling GET /api/v1/activations/{id}; giới hạn 300 yêu cầu mỗi phút vẫn đủ chỗ cho khoảng polling ngắn trên nhiều bài kiểm thử song song.
Khi nào Zalo yêu cầu số điện thoại?
Zalo là ứng dụng nhắn tin và mạng xã hội của Việt Nam, trong đó số điện thoại đóng vai trò định danh chính của tài khoản. Mã thường được yêu cầu khi ai đó tạo tài khoản, khi đăng nhập trên thiết bị mới và khi khôi phục quyền truy cập. Các lời nhắc cụ thể do Zalo quyết định và có thể thay đổi, nên kế hoạch kiểm thử cần bao quát từng màn hình thay vì giả định một trình tự cố định.
Với các nhóm QA, điều này quan trọng vì một tích hợp nhắn tin, một mini app hay một kênh hỗ trợ khách hàng xây quanh Zalo thường cần một tài khoản thử nghiệm mới đã xác minh trước khi chạy bất kỳ kịch bản nào khác.
Những quốc gia nào có thể nhận OTP Zalo trên OTP Route?
Các tuyến Zalo được liệt kê ở 198 quốc gia. Trong đó có Việt Nam, Hoa Kỳ, Nhật Bản, Hàn Quốc, Đài Loan, Úc, Canada, Campuchia, Lào, Thái Lan, Malaysia, Singapore, Đức, Pháp và Vương quốc Anh.
Hãy chọn quốc gia khớp với tài khoản bạn đang kiểm thử. Khi ra mắt tại Việt Nam, bạn cần số +84 để tái hiện những gì người dùng trong nước thấy, còn nhóm phục vụ cộng đồng người Việt ở nước ngoài có thể muốn dùng số của các quốc gia nơi khách hàng sinh sống. Quốc gia cũng ảnh hưởng đến giá và tình trạng khả dụng, vì vậy nên kiểm tra endpoint giá trước.
Các bước trên dashboard cho một bài kiểm thử xác minh SMS Zalo
Không phải ai trong dự án cũng viết code. Trên dashboard, chọn Zalo làm dịch vụ, chọn quốc gia, xác nhận giá hiển thị rồi đặt số. Sao chép số vào Zalo; mã sẽ xuất hiện cạnh đơn khi SMS đến. Hủy ngay trên cùng màn hình sẽ hoàn lại toàn bộ số tiền. Việc đăng ký dashboard chỉ cần một địa chỉ email và mã email 6 chữ số, hoặc đăng nhập bằng Google, và xác thực hai yếu tố TOTP có thể bảo vệ tài khoản đăng nhập của nhóm.
Vì sao mã Zalo có thể không đến?
Việc gửi phụ thuộc vào dịch vụ và tuyến, nên không có thời gian chờ cố định. Zalo cũng có thể từ chối một số số ảo, đó là lý do có cơ chế hoàn tiền. Nếu không thấy gì xuất hiện:
- Để đơn mở đến khi hết khung 20 phút, hoặc hủy đơn; cả hai cách đều hoàn tiền về ví.
- Thử lại sau, hoặc chuyển sang quốc gia khác phù hợp với bài kiểm thử.
- Đừng đặt lại liên tục trong vòng lặp ngắn; hãy thêm backoff trong các job tự động.
- Xác nhận tài khoản thử nghiệm không bị Zalo chặn hoặc giới hạn tốc độ.
Tài khoản thử nghiệm Zalo có nên dùng Dedicated Number không?
Một số của OTP Gateway chỉ xử lý một mã. Nếu một tài khoản staging hoặc hỗ trợ cần đăng nhập lại vào tháng sau, Dedicated Number phù hợp hơn: một đường dây Hoa Kỳ hoặc Canada từ $1.95/tháng mà bạn giữ trong khi nó được gia hạn, nhận SMS đến trong dashboard và trên webhook number.sms_received. Tìm hiểu thêm tại số ảo.
Hãy dùng cả hai lựa chọn một cách có trách nhiệm. Tuân thủ điều khoản của Zalo, giữ mỗi người thật hoặc doanh nghiệp một tài khoản, và chỉ dùng OTP Route để kiểm thử và vận hành các tài khoản, sản phẩm hợp pháp của chính bạn. Zalo là nhãn hiệu của chủ sở hữu, và OTP Route không liên kết với họ.
Câu hỏi thường gặp
API của OTP Route dùng service id nào cho Zalo?
Đó là zalo, được gửi trong phần body của POST /api/v1/activations cùng với id quốc gia.
Tôi có thể nhận OTP Zalo trên số ngoài Việt Nam không?
Có. Các tuyến Zalo được liệt kê ở 198 quốc gia, và tình trạng khả dụng của từng nơi được endpoint giá trả về trực tiếp.
Tôi có bị tính phí nếu Zalo từ chối số ảo không?
Không. Nếu không có mã nào đến số trong 20 phút, hoặc bạn hủy, toàn bộ số tiền sẽ được hoàn về ví.
Số ảo cho Zalo có phù hợp với tài khoản cần dùng lâu dài không?
Số dùng một lần thì không. Với các lần đăng nhập lặp lại, Dedicated Number của Hoa Kỳ hoặc Canada mà bạn giữ trong khi nó được gia hạn là lựa chọn an toàn hơn.
Tôi thanh toán xác minh SMS Zalo để kiểm thử như thế nào?
Nạp ví USD trả trước bằng thẻ hoặc USDT/USDC; không có phí hàng tháng, và mỗi lần nạp đều kèm hóa đơn PDF.
Tôi có thể thử tích hợp Zalo mà không tốn tiền không?
Có. Khi bộ phận hỗ trợ chuyển một tài khoản phát triển sang sandbox, các đơn Zalo sẽ trả về số và mã mô phỏng, nhờ đó code webhook và polling có thể được kiểm chứng trước khi chi tiền thật.
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.