Chọn tuyến +55 cho xác minh SMS tại Brazil

Kiểm thử Brazil nên dùng OTP Gateway hay số dùng lâu dài?

Hãy bắt đầu từ hình dạng của công việc, vì nó quyết định sản phẩm. Một bài kiểm thử xác minh Brazil thường chỉ cần một mã, một lần: màn hình đăng ký bằng tiếng Bồ Đào Nha, một thử thách đăng nhập, một bước đổi số điện thoại. Đó chính xác là thứ OTP Gateway được xây dựng cho. Bạn chọn một dịch vụ và Brazil, nhận một số +55 cho một mã duy nhất, và lượt kích hoạt đóng lại sau 20 phút hoặc khi SMS đến.

Số dùng lâu dài là câu chuyện khác. Dedicated Numbers (số chuyên dụng) là sản phẩm của Hoa Kỳ và Canada, bán tức thì từ dashboard, từ $1.95/tháng, với SMS đến, SMS đi và gọi điện trên trình duyệt. Không có số +55 dùng lâu dài tự phục vụ. Nếu đội của bạn thực sự cần một số Brazil để giữ, hãy viết tới [email protected] và mô tả trường hợp sử dụng; liệu có khả thi hay không tùy thuộc vào quy định địa phương, và không có gì được hứa.

Một nguyên tắc nhanh:

• Một mã cho mỗi ca kiểm thử, trạng thái mới mỗi lần chạy: OTP Gateway với br.
• Một tài khoản staging phải đăng nhập lại vào tháng sau: số chuyên dụng của Mỹ hoặc Canada, nếu dịch vụ chấp nhận.
• Chưa chắc: hãy đọc số tạm thời và số chuyên dụng trước khi mua bất cứ thứ gì.

Hiện nay ứng dụng nào có thể gửi mã tới số Brazil?

Tuyến Brazil hiện bao gồm hơn 2,900 dịch vụ, và những dịch vụ phổ biến trong ảnh chụp trực tiếp gồm WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee và AliExpress.

Hãy xem danh sách đó là ảnh chụp chứ không phải cam kết. Tình trạng khả dụng thay đổi trong ngày khi các đối tác nhà mạng thêm và xoay vòng tuyến, nên pipeline cần hỏi API thay vì tin vào danh sách ghi cứng. Danh bạ quốc gia hiển thị cùng dữ liệu trực tiếp cho những ai thích dùng trình duyệt.

Trình tự API OTP Brazil trong thực tế trông ra sao?

Mọi lệnh gọi đều gửi tới https://otproute.com/api/v1 với khóa Bearer có tiền tố or_live_, được tạo trong Developer console. Id quốc gia của Brazil là br.

1. Xác định id dịch vụ một lần bằng GET /api/v1/services và giữ trong cấu hình.
2. Trước khi đặt số, gọi GET /api/v1/prices?country=br&service=whatsapp (hoặc id dịch vụ của bạn). Phản hồi mang giá và tình trạng khả dụng trực tiếp cho cặp đó.
3. Tạo lượt kích hoạt bằng POST /api/v1/activations với phần thân {"service": "whatsapp", "country": "br"}. Lưu id kích hoạt cạnh lượt chạy kiểm thử của bạn.
4. Nhập số +55 vào luồng bạn đang kiểm thử.
5. Lắng nghe sự kiện activation.sms_received trên webhook; làm phương án dự phòng, hãy kiểm tra GET /api/v1/activations/{id} vài giây một lần.
6. Nếu bài kiểm thử bị hủy giữa chừng, giải phóng số bằng POST /api/v1/activations/{id}/cancel để tiền trở lại ngay.

Các lần gửi webhook được ký trong X-OTPRoute-Signature dưới dạng t=<unix>,v1=<hex>: một HMAC-SHA256 của <t>.<raw body> bằng bí mật endpoint. Hãy xác minh nó, loại bỏ dấu thời gian cũ, và làm trình xử lý idempotent theo id kích hoạt. Tài liệu tham chiếu đầy đủ nằm trong tài liệu API.

Người bên nhóm tăng trưởng có làm được việc này mà không cần code không?

Có. Dashboard chạy cùng quá trình định tuyến OTP mà không cần viết script:

1. Tạo tài khoản bằng email của bạn và mã email 6 chữ số, hoặc đăng nhập Google.
2. Nạp tiền vào ví USD.
3. Chọn Brazil và dịch vụ, kiểm tra giá hiển thị, rồi đặt số.
4. Dán số +55 vào ứng dụng và xem mã xuất hiện trên thẻ kích hoạt.

Người làm marketing, hỗ trợ và rà soát bản địa hóa thường dùng cách này để xác nhận màn hình làm quen bằng tiếng Bồ Đào Nha hoạt động tốt trước khi phát hành, trong khi kỹ sư giữ API cho các lượt chạy tự động.

Nên lưu và chuẩn hóa số +55 như thế nào?

Số Brazil gồm mã vùng hai chữ số (DDD) theo sau là số thuê bao, và số di động có chín chữ số bắt đầu bằng 9. Bên trong Brazil, người ta quay số 0 đứng đầu cộng mã chọn nhà mạng cho các cuộc gọi đường dài, vì vậy dữ liệu người dùng nhập thường chứa các chữ số thừa không thuộc về dữ liệu lưu trữ.

Hãy lưu mọi thứ theo E.164: +55, mã vùng, rồi số thuê bao, không khoảng trắng, không số 0 đứng đầu và không mã nhà mạng. Chuẩn hóa khi nhập, so sánh trên giá trị đã chuẩn hóa, và chỉ định dạng khi hiển thị. Mã từ các bên gửi Brazil thường đến bằng tiếng Bồ Đào Nha, đôi khi bằng tiếng Anh, vì vậy hãy phân tích các chữ số thay vì khớp một câu cố định.

Các đội kiểm thử thị trường này để ra mắt tại Brazil, QA bản địa hóa tiếng Bồ Đào Nha, và các luồng làm quen đi kèm nghĩa vụ theo luật bảo vệ dữ liệu của Brazil, LGPD. Trang onboarding fintech của chúng tôi đề cập phần xác minh của công việc đó.

Nếu mã Brazil không bao giờ xuất hiện thì sao?

Trước hết, hãy để khung 20 phút chạy hết; một số bên gửi chậm hơn các bên khác, và việc gửi phụ thuộc vào dịch vụ và tuyến. Nếu hết hạn, khoản phí được hoàn tự động và bạn có thể thử lại sau một lúc hoặc trên một tuyến khác mà API liệt kê.

• Xác nhận dịch vụ có chấp nhận số ảo hay không. Một số không chấp nhận, đó chính là lý do quy tắc hoàn tiền tồn tại.
• Đừng đặt lại liên tục trong vòng lặp. Hãy giãn cách giữa các lần thử và ghi lại từng id kích hoạt.
• Kiểm tra rằng ứng dụng của bạn đã gửi số ở dạng quốc tế đầy đủ, không phải dạng nội địa kèm các chữ số trung kế.

Hướng dẫn giảm gửi OTP thất bại liệt kê thêm các cách chẩn đoán.

Ví, hóa đơn và sandbox kết hợp với nhau như thế nào?

OTP Route tính phí từ một ví USD trả trước: dùng bao nhiêu trả bấy nhiêu, không phí hằng tháng và không có gói để chọn. Nạp bằng thẻ hoặc bằng USDT hay USDC, và mỗi lần nạp đều kèm hóa đơn PDF qua email. Bảng giá đầy đủ có trên trang bảng giá và trong API.

Với công việc tích hợp, hãy nhờ bộ phận hỗ trợ chuyển một tài khoản phát triển sang sandbox. Nó trả về số và mã mô phỏng, để bạn chạy thử đường kích hoạt và webhook từ đầu đến cuối mà không đụng đến tiền trong ví. Chỉ dùng cho sản phẩm của chính bạn, tuân thủ điều khoản của từng dịch vụ, và nhớ Chính sách sử dụng chấp nhận được áp dụng cho mọi tài khoản.

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

Tôi có thể kiểm thử luồng đăng ký Brazil của ứng dụng mà không cần SIM địa phương không?

Có. Hãy đặt một số +55 từ OTP Gateway cho ứng dụng của bạn hoặc một dịch vụ được hỗ trợ, nhập vào luồng và đọc mã trên dashboard hoặc qua API.

Id quốc gia của Brazil trong API OTP Route là gì?

Là br. Hãy truyền nó làm trường country khi tạo lượt kích hoạt hoặc làm tham số truy vấn country trên điểm cuối giá.

Tôi có bị tính phí nếu WhatsApp không bao giờ gửi mã tới số +55 của tôi không?

Không. Nếu không có SMS nào đến số trong 20 phút, hoặc bạn hủy trước, toàn bộ số tiền được trả về ví của bạn tự động.

Tôi có thể mua một số Brazil và giữ nhiều tháng không?

Không phải dưới dạng sản phẩm tự phục vụ. Dedicated Numbers dùng lâu dài chỉ được bán cho Hoa Kỳ và Canada; với Brazil bạn có thể gửi email tới [email protected] để hỏi, không kèm lời hứa về khả năng cung cấp.

Có nên lưu số không đứng đầu của số Brazil không?

Không. Hãy cắt bỏ số 0 trung kế và mọi mã chọn nhà mạng, rồi lưu số ở dạng E.164 bắt đầu bằng +55 và mã vùng hai chữ số.

Tin nhắn xác minh Brazil dùng ngôn ngữ nào?

Phần lớn đến bằng tiếng Bồ Đào Nha, và một số dịch vụ toàn cầu gửi nội dung tiếng Anh. Hãy trích mã số thay vì dựa vào cách diễn đạt.

Tôi có thể dùng thử API trước khi nạp tiền vào ví không?

Hãy yêu cầu chế độ sandbox cho tài khoản phát triển. Nó mô phỏng số và mã để toàn bộ tích hợp được kiểm thử mà không tốn tiền trong 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.