Đưa mã xác minh Venezuela (+58) vào bộ kiểm thử của bạn

Vì sao số 0 đứng đầu gây lỗi với số điện thoại Venezuela?

Mã quốc gia của Venezuela là +58, và số trong nước được viết kèm tiền tố trung kế 0. Khi quay số trong nước, số di động có dạng 0412, 0414, 0416, 0424 hoặc 0426 theo sau là bảy chữ số. Trong chuẩn E.164, số 0 này biến mất: 0414 123 4567 trở thành +584141234567.

Lỗi kinh điển là biểu mẫu tự ghép +58 vào bất cứ thứ gì người dùng nhập, tạo ra +580414…, một chuỗi mà không dịch vụ nào chấp nhận. Hãy phòng tránh bằng cách:

• bỏ đúng một số 0 ở đầu khi quốc gia được chọn là Venezuela, trước khi thêm mã quốc gia;
• chỉ lưu chuỗi E.164 đã chuẩn hóa, còn định dạng hiển thị thì xử lý lúc render;
• thêm một test case nhập dạng số nội địa và kiểm tra giá trị được lưu.

Một số +58 để kiểm thử từ OTP Gateway luôn đến ở dạng quốc tế sẵn, nên rất tiện làm giá trị tham chiếu cho các phép kiểm tra đó.

QA bản địa hóa cần kiểm tra gì cho người dùng Venezuela?

Tiếng Tây Ban Nha là ngôn ngữ chính thức và là thứ hầu hết người dùng Venezuela mong muốn thấy. Tin nhắn xác minh từ các nền tảng toàn cầu thường theo ngôn ngữ của tài khoản hoặc thiết bị, nên người kiểm thử có thể nhận tiếng Tây Ban Nha hôm nay và tiếng Anh hôm sau nếu cài đặt khác nhau. Hãy viết logic trích xuất tìm các chữ số, chứ không dựa vào chữ xung quanh.

Về phía bạn, hãy rà soát nội dung tiếng Tây Ban Nha Mỹ Latinh trên màn hình nhập số điện thoại và nhập mã, thông báo lỗi khi số không hợp lệ, và dòng chữ của bộ đếm gửi lại. Đó là những chuỗi người dùng đọc đúng vào lúc họ dễ bỏ đăng ký nhất.

Số Venezuela quan trọng ở đâu với một đội sản phẩm?

Venezuela có cộng đồng người xa xứ đông đảo ở khắp châu Mỹ Latinh, Tây Ban Nha và Hoa Kỳ, và nhiều người vẫn giữ SIM +58 sau khi chuyển đi. Vì vậy số Venezuela có ý nghĩa vượt ra ngoài biên giới quốc gia này:

• Đăng ký xuyên biên giới, khi người dùng đăng ký ở nước ngoài bằng số ở quê nhà và tính năng nhận diện quốc gia của bạn không được từ chối số đó.
• Hỗ trợ ưu tiên nhắn tin, vì ứng dụng chat là kênh chính để mọi người liên hệ doanh nghiệp; các đội thường xác minh tài khoản doanh nghiệp WhatsApp và Telegram theo cách này.
• Ra mắt khu vực ở Nam Mỹ, cần ít nhất một đường +58 thực tế trong checklist phát hành.
• Agency quản lý tài khoản mạng xã hội cho thương hiệu Venezuela và muốn mã về một công cụ dùng chung thay vì điện thoại cá nhân của quản lý; xem agency và đại lý.

OTP Gateway hỗ trợ những gì cho Venezuela?

Có hơn 1.700 dịch vụ khả dụng trên số Venezuela. Các dịch vụ được yêu cầu thường xuyên gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord và LinkedIn. Hãy xem đây là ảnh chụp thay đổi liên tục: tình trạng khả dụng theo từng dịch vụ và quốc gia được tính lại suốt ngày và luôn được API báo cáo trực tiếp.

Gọi API OTP Venezuela từ trình chạy kiểm thử như thế nào?

Mọi yêu cầu đều gửi đến https://otproute.com/api/v1 với khóa Bearer có tiền tố or_live_. Hãy tạo một khóa cho mỗi môi trường trong Developer console (giới hạn là 10 khóa). Mã quốc gia của Venezuela là ve.

1. Ánh xạ tên dễ đọc sang id qua GET /api/v1/services và GET /api/v1/countries, mỗi lượt chạy một lần.
2. Kiểm tra GET /api/v1/prices?country=ve&service=<id> ngay trước khi đặt để bài kiểm thử biết giá hiện tại và cặp này có được cung cấp hay không.
3. Đặt số qua POST /api/v1/activations với nội dung như {"service": "whatsapp", "country": "ve"}.
4. Đưa số +58 được trả về vào màn hình cần kiểm thử.
5. Nhận activation.sms_received qua webhook, hoặc polling GET /api/v1/activations/{id}; dùng POST /api/v1/activations/{id}/cancel khi dọn dẹp nếu luồng bị dừng giữa chừng.

Hãy kiểm tra GET /api/v1/balance khi bắt đầu bộ kiểm thử. Với webhook, hãy xác thực 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 timestamp đã cũ. Mỗi tài khoản cho phép 5 endpoint webhook và 300 yêu cầu mỗi phút. Các mẫu cho pipeline có trong kiểm thử SMS OTP trong pipeline CI và tài liệu API.

Đặt số thủ công và xử lý khi mã không về

Trong dashboard, các bước rất ngắn: chọn Venezuela, chọn dịch vụ, xác nhận giá, dùng số trong ứng dụng và chờ mã hiện trên màn hình. Cách này phù hợp với quản lý sản phẩm và trưởng nhóm hỗ trợ cần kiểm tra nhanh mà không phải viết code.

Mỗi lượt kích hoạt có cửa sổ 20 phút. Nếu hết thời gian mà không có SMS, hoặc bạn hủy, toàn bộ khoản đã tính sẽ tự động được hoàn về ví; bạn chỉ trả tiền cho những mã đã nhận. Thời gian về phụ thuộc vào dịch vụ và tuyến. Nếu mã đến trễ, hãy để cửa sổ chạy hết, rồi thử lại sau hoặc chuyển sang tuyến dịch vụ khác thay vì đặt lại liên tục. Hãy kiểm tra xem dịch vụ có từ chối số ảo cho thao tác đó không, vì một số dịch vụ có làm vậy. Hãy tuân thủ điều khoản của từng dịch vụ; Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng trong mọi trường hợp.

Tôi có thể giữ số +58 không, và nạp ví thế nào?

Không qua hình thức tự phục vụ. Dedicated Virtual Numbers, từ $1.95/month, chỉ có thể mua ngay cho Hoa Kỳ và Canada (xem số ảo). Các đội cần một đường dây Venezuela dùng lâu dài có thể gửi email đến [email protected] để hỏi; quy định địa phương quyết định việc đó có khả thi hay không.

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

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

Tôi có thể kiểm thử luồng đăng ký Venezuela mà không cần SIM Venezuela không?

Có. Hãy đặt một số +58 từ OTP Gateway, nhập vào ứng dụng của bạn, và mã sẽ hiện trong dashboard hoặc đến webhook của bạn.

Id của Venezuela trong API của OTP Route là gì?

ve. Dùng nó trong GET /api/v1/prices và làm giá trị country khi tạo một lượt kích hoạt.

Tôi có nên giữ số 0 khi lưu số di động Venezuela không?

Không. Hãy bỏ số 0 trung kế trong nước và lưu +58 theo sau là các chữ số còn lại, ví dụ +58414 rồi thêm bảy chữ số.

Một số xác minh Venezuela có giá bao nhiêu?

Từ $0.20 mỗi mã; API và dashboard hiển thị giá chính xác theo từng dịch vụ trước khi bạn đặt. Các lượt kích hoạt không dùng đến sẽ được hoàn tiền.

Vì sao mã Venezuela của tôi đến bằng tiếng Anh?

Dịch vụ gửi tin chọn ngôn ngữ, thường theo ngôn ngữ của tài khoản hoặc thiết bị. Hãy phân tích các chữ số thay vì dựa vào cách diễn đạt của tin nhắn.

Có số dùng lâu dài dành riêng cho Venezuela không?

Không có lựa chọn tự phục vụ; đường dây riêng là sản phẩm dành cho Hoa Kỳ và Canada. Bạn có thể gửi email đến [email protected] để hỏi về Venezuela.

Có thể dùng OTP Route để lách các hạn chế của nền tảng không?

Không. Dịch vụ này dành cho việc kiểm thử và vận hành các sản phẩm và tài khoản hợp pháp của chính bạn, mỗi người hoặc doanh nghiệp một tài khoản, theo đúng điều khoản của từng dịch vụ.

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.