Cách các đội nhận mã SMS WeChat để kiểm thử và vận hành

Vì sao xác minh WeChat khác với các ứng dụng nhắn tin khác?

WeChat không chỉ là một ứng dụng trò chuyện. Với nhiều người dùng, đó còn là ví điện tử, cửa hàng thông qua Mini Programs và kênh chính để tiếp cận doanh nghiệp tại Trung Quốc. Đó là lý do việc kiểm tra tài khoản của WeChat nghiêm ngặt hơn phần lớn các ứng dụng, và số điện thoại WeChat có sức nặng hơn một tên đăng nhập đơn thuần.

Ứng dụng dùng mã SMS ở nhiều điểm:

• Đăng ký, khi số điện thoại trở thành mã định danh chính của tài khoản.
• Đăng nhập trên thiết bị mới, thường kết hợp với các bước kiểm tra khác.
• Thay đổi hoặc khôi phục số được liên kết.
• Rà soát bảo mật, có thể yêu cầu nhiều hơn một SMS: WeChat có thể đòi xác nhận từ một người dùng hiện có hoặc các bước xác minh danh tính khác. Không số nào, từ bất kỳ nhà cung cấp nào, có thể thay thế những bước đó.

Với đội đang xây dựng Mini Program cho WeChat, tích hợp tài khoản chính thức hoặc bàn hỗ trợ xuyên biên giới, điều đó có nghĩa là cần lên kế hoạch cẩn thận cho các tài khoản kiểm thử thay vì tạo chúng tùy hứng.

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

Các tuyến WeChat hiện được liệt kê tại 198 quốc gia. Một số ví dụ gồm Trung Quốc, Hồng Kông, Singapore, Malaysia, Hoa Kỳ, Canada, Đài Loan, Ma Cao, Thái Lan, Việt Nam, Indonesia, Philippines, Úc, Vương quốc Anh, Đức và Bangladesh.

Hãy chọn quốc gia khớp với tình huống bạn đang kiểm thử, không phải tuyến rẻ nhất. Bàn hỗ trợ phục vụ du khách Trung Quốc ở châu Âu nên kiểm thử trên số châu Âu; một Mini Program hướng đến cộng đồng người Hoa ở Malaysia nên kiểm thử trên số Malaysia. WeChat có thể đối xử với tài khoản ở các khu vực khác nhau theo cách khác nhau, và bài kiểm thử của bạn nên phản ánh những gì người dùng thật nhìn thấy. Giá khác nhau theo từng quốc gia và được trả về trực tiếp.

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

Các lệnh gọi được gửi đến https://otproute.com/api/v1 với khóa Bearer or_live_ tạo trong Developer console (tối đa 10 khóa, 300 yêu cầu mỗi phút).

1. Xác nhận mã dịch vụ wechat qua GET /api/v1/services, và mã quốc gia qua GET /api/v1/countries.
2. Đọc giá trực tiếp: GET /api/v1/prices?country=<id>&service=wechat.
3. Tạo đơn bằng POST /api/v1/activations với {"service": "wechat", "country": "<id>"}. Lưu lại mã activation được trả về.
4. Nhập số vào WeChat và yêu cầu gửi SMS.
5. Lấy mã từ webhook activation.sms_received, hoặc polling GET /api/v1/activations/{id} mỗi vài giây.
6. Nếu bài kiểm thử dừng sớm, hãy gọi POST /api/v1/activations/{id}/cancel.

Tài liệu tham chiếu đầy đủ nằm trong docs.

Handler webhook cho mã WeChat nên làm gì?

Bạn có thể đăng ký tối đa 5 endpoint cho mỗi tài khoản. Mỗi yêu cầu mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hãy dựng lại chữ ký bằng HMAC-SHA256 của <t>.<raw body> với secret của endpoint đó, so sánh theo thời gian hằng định, và từ chối các timestamp cũ hơn vài phút.

Hãy làm cho handler có tính idempotent: ghi mã theo mã activation, để một lần gửi lại không tạo ra thay đổi nào mới. Cũng nên lắng nghe activation.expired và activation.cancelled để các lượt chạy kiểm thử kết thúc gọn gàng thay vì bị treo. Hướng dẫn của chúng tôi về bảo mật webhook OTP trình bày từng bước kiểm tra. Polling là phương án dự phòng tốt cho một bài kiểm thử thủ công đơn lẻ; webhook mở rộng tốt hơn khi nhiều tác vụ chạy song song.

Tôi có thể làm việc này từ dashboard thay vì API không?

Có. Trong dashboard OTP Route, mở OTP Gateway, chọn WeChat và một quốc gia, kiểm tra giá hiển thị rồi xác nhận. Dán số vào WeChat, yêu cầu mã và theo dõi trang đơn hàng; SMS sẽ hiện ở đó khi được gửi đến. Cách này phù hợp với nhân viên vận hành chỉ thiết lập tài khoản doanh nghiệp một lần và không bao giờ đụng đến API.

Vì sao mã WeChat có thể không đến?

Mỗi activation kéo dài 20 phút và chỉ xử lý một mã. Bạn chỉ trả tiền nếu mã đến; nếu khung thời gian kết thúc mà không có gì hoặc bạn hủy, tiền được hoàn vào ví tự động.

Các nguyên nhân phổ biến khiến mã im lặng:

• WeChat có thể từ chối số ảo hoặc yêu cầu xác minh bổ sung mà một mình SMS không đáp ứng được.
• Tuyến đã chọn đang bận; hãy thử lại sau hoặc kiểm thử ở quốc gia khác phù hợp với trường hợp của bạn.
• Yêu cầu chưa bao giờ được gửi, thường vì ứng dụng hiển thị captcha hoặc lời nhắc bảo mật trước.

Hãy để khung thời gian chạy hết trước khi đặt lại, và không bao giờ thử lại liên tục trong một vòng lặp. Thêm mẹo có trong giảm số lần gửi OTP thất bại.

Khi nào số chuyên dụng phù hợp hơn mã dùng một lần?

Số tạm thời chỉ nhận một mã. Nếu tài khoản WeChat staging phải đăng nhập lại vào tháng sau, hoặc đội hỗ trợ dùng chung một tài khoản doanh nghiệp, thì số phải ở lại với bạn. Số chuyên dụng (Dedicated Numbers) làm được điều đó: có sẵn tại Hoa Kỳ và Canada, từ $1.95/tháng, với SMS đến trong dashboard và trên webhook của bạn qua number.sms_received. Các quốc gia khác không có lựa chọn dài hạn tự phục vụ; hãy gửi email đến [email protected] để hỏi.

Hãy dùng mọi tài khoản WeChat theo đúng điều khoản của WeChat: mỗi người thật hoặc doanh nghiệp một tài khoản, được tạo cho các sản phẩm hợp pháp của chính bạn. WeChat là nhãn hiệu của chủ sở hữu và OTP Route không có liên kết với WeChat; Chính sách sử dụng chấp nhận được của chúng tôi được áp dụng.

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

Tôi có thể dùng số ảo để kiểm thử đăng ký WeChat không?

Thường là được, nhưng không phải lúc nào cũng vậy. WeChat có thể từ chối một số số ảo hoặc yêu cầu kiểm tra bổ sung; khi không có mã nào đến, activation được hoàn tiền.

Mã dịch vụ của WeChat trong API là gì?

Đó là wechat. Hãy dùng nó trong lệnh gọi giá và trong phần thân yêu cầu activation.

Vì sao WeChat yêu cầu một người dùng hiện có xác nhận tài khoản mới của tôi?

Đó là một bước bảo mật của WeChat, tách biệt với SMS. Một số điện thoại không thể tự hoàn thành bước đó.

Có bao nhiêu quốc gia hỗ trợ SMS xác minh WeChat để kiểm thử?

Hiện có 198 quốc gia liệt kê các tuyến WeChat. Hãy kiểm tra danh sách trực tiếp trước khi đặt đơn, vì tình trạng sẵn có thay đổi trong ngày.

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

Mã bắt đầu từ $0.20 cho mỗi mã; giá chính xác phụ thuộc vào quốc gia và được hiển thị trước khi bạn đặt đơn. Bạn chỉ trả tiền nếu mã đến.

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

Có, với số chuyên dụng ở Hoa Kỳ hoặc Canada từ $1.95/tháng. Các activation tạm thời chỉ xử lý một mã.

Tôi có thể kiểm thử tích hợp WeChat mà không tốn tiền không?

Hãy nhờ bộ phận hỗ trợ chuyển tài khoản phát triển sang sandbox, chế độ này trả về số và mã mô phỏng cho các bài kiểm thử đầu cuối.

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.