Kiểm thử xác minh điện thoại Thái Lan (+66): danh sách kiểm tra, các bước và cách khắc phục

Trước khi bắt đầu: danh sách kiểm tra khi kiểm thử +66

Các luồng đăng ký ở Thái Lan có vài cái bẫy mà bắt trên giấy rẻ hơn là bắt trong một lượt CI thất bại. Hãy xác nhận từng mục trước:

• Thông tin xác thực. Một khóa Bearer có tiền tố or_live_ từ Developer console, giới hạn theo môi trường sẽ dùng nó.
• Định danh. Id quốc gia của Thái Lan là th; hãy lấy id dịch vụ từ GET /api/v1/services thay vì đoán.
• Cách nhận. Hoặc một endpoint webhook với secret ký đã được lưu, hoặc một job polling tuân theo giới hạn 300 yêu cầu mỗi phút.
• Xử lý số. Quyết định cách code của bạn bỏ số 0 nội địa trước khi lưu bất cứ thứ gì (xem phần về định dạng).
• Phân tích tin nhắn. Bảo đảm bộ phân tích xử lý được chữ Thái xung quanh các chữ số.
• Ngân sách. Một ví đã nạp tiền, hoặc một tài khoản sandbox nếu bạn chỉ cần chứng minh phần tích hợp.

OTP Gateway có thể bao phủ những luồng đăng ký Thái nào?

Thái Lan là một trong những tuyến rộng hơn, với hơn 1,800 dịch vụ trong ảnh chụp trực tiếp. Nhắn tin và thương mại chiếm ưu thế trong mức dùng địa phương, nên các đội thường bắt đầu với LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram và Telegram. Những dịch vụ khác trong danh sách gồm Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon và Airbnb.

Tình trạng khả dụng theo từng dịch vụ thay đổi khi số đến và đi, nên hãy đọc endpoint giá trước mỗi lượt chạy thay vì gán cứng các giả định.

Đặt số xác minh Thái Lan qua API

URL gốc là https://otproute.com/api/v1.

1. Gọi GET /api/v1/prices?country=th&service=<id>; một câu trả lời rỗng hoặc không khả dụng nghĩa là bạn nên chọn thời điểm hoặc tuyến khác.
2. Gửi POST /api/v1/activations với phần thân như {"service": "line", "country": "th"}. Lưu activation id được trả về cùng với lượt chạy kiểm thử của bạn.
3. Nhập số +66 vào ứng dụng đang kiểm thử và kích hoạt SMS.
4. Lấy mã từ sự kiện activation.sms_received, hoặc từ GET /api/v1/activations/{id} nếu bạn polling.
5. Giải phóng các đơn không cần bằng POST /api/v1/activations/{id}/cancel.

Hãy xác minh header X-OTPRoute-Signature (t=<unix>,v1=<hex>) trên mọi lần gửi và bỏ các sự kiện có timestamp quá cũ. Các sự kiện được định khóa theo activation id, giúp dễ bỏ qua các lần gửi trùng. Ví dụ yêu cầu đầy đủ nằm trong tài liệu dành cho lập trình viên.

Định dạng số Thái, số 0 trung kế và tin nhắn chữ Thái

Trong nước, số di động Thái được viết với số 0 đứng đầu và chín chữ số nữa, thường bắt đầu bằng 06, 08 hoặc 09. Số 0 đó là tiền tố trung kế: ở dạng quốc tế nó biến mất, nên 08x xxx xxxx trở thành +66 8x xxx xxxx. Hãy lưu phiên bản E.164 và chuẩn hóa mọi dữ liệu người dùng nhập vẫn còn số 0, nếu không việc loại trùng của bạn sẽ coi một thiết bị là hai người.

Mã từ các ứng dụng hướng đến người Thái thường đến bên trong một câu tiếng Thái. Hãy trích mã theo mẫu (một chuỗi chữ số có độ dài mong đợi) thay vì neo vào các từ tiếng Anh, và nhớ rằng SMS chữ Thái dùng mã hóa Unicode, nên tin nhắn bị chia thành các đoạn ngắn hơn. Bản địa hóa là lý do khác khiến các đội kiểm thử ở đây: trường ngày tháng trong giao diện tiếng Thái thường hiển thị năm Phật lịch, và giới hạn độ dài của các trường tên và địa chỉ Thái rất dễ làm sai. Việc ra mắt sản phẩm ở Đông Nam Á, onboarding người bán trên sàn thương mại và các bàn hỗ trợ nói tiếng Thái hoàn chỉnh danh sách thường gặp.

Nhân sự hỗ trợ và vận hành dùng dashboard thì sao?

Không phải lần kiểm tra nào cũng cần script. Một người trong nhóm vận hành có thể đăng ký, nạp tiền, mở OTP Gateway, chọn một dịch vụ và Thái Lan, xem lại giá được báo, rồi nhận số. Mã hiện trên thẻ kích hoạt trong trình duyệt. Áp dụng cùng khung 20 phút, và việc hoàn tiền tự diễn ra nếu khung đóng mà không có gì.

Xử lý sự cố mã không bao giờ đến số +66

Khi một lượt kích hoạt cứ trống, hãy đi lần lượt theo danh sách này:

• Cho nó đủ khung thời gian trước khi hủy; việc gửi lại trễ là phổ biến.
• Xác nhận dịch vụ chấp nhận số ảo cho Thái Lan. Một số thì không, và đó là điều cơ chế hoàn tiền tự động bao trùm.
• Thử lại sau, hoặc chuyển sang tuyến quốc gia khác nếu ca kiểm thử của bạn cho phép. Bài viết về định tuyến theo quốc gia giải thích cách các đội chọn phương án dự phòng.
• Giãn cách các lần thử lại. Đặt lại liên tục trong vòng lặp chặt hiếm khi hiệu quả và làm rối log của bạn.

Không mất tiền cho một lần thử thất bại: một lượt kích hoạt hết hạn hoặc bị hủy sẽ trả lại toàn bộ số tiền vào ví.

Đường dây dài hạn, ví và sandbox cho các dự án Thái

OTP Route không bán số dài hạn tự phục vụ ở Thái Lan. Các đội cần một đường dây Thái cố định có thể gửi email đến [email protected] để hỏi; quy định địa phương quyết định liệu có thể làm được gì không. Các số riêng mà bạn giữ và gia hạn chỉ có ở Mỹ và Canada, từ $1.95/tháng.

Mọi thứ còn lại chạy trên một ví USD trả trước không có gói đăng ký. Nạp bằng thẻ hoặc USDT/USDC, và một hóa đơn PDF được gửi qua email cho mỗi lần nạp. Với công việc tích hợp, một tài khoản phát triển có thể được chuyển sang sandbox để số và mã mô phỏng chạy qua code của bạn miễn phí. Xem bảng giá để biết mức giá hiện hành, tuân theo điều khoản của từng dịch vụ, và nhớ rằng Acceptable Use Policy của OTP Route bao trùm mọi lượt kích hoạt.

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

Tôi có thể xác minh đăng ký Thái của ứng dụng mà không có SIM Thái không?

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

Có nên giữ số 0 đứng đầu khi lưu số di động Thái không?

Không. Hãy bỏ số 0 trung kế và lưu số dưới dạng +66 theo sau là chín chữ số còn lại.

API cần id nào cho Thái Lan?

Dùng th làm giá trị quốc gia, ví dụ trong GET /api/v1/prices?country=th&service=<id>.

Vì sao tin nhắn LINE hoặc Shopee đến bằng tiếng Thái?

Nhiều dịch vụ bản địa hóa mẫu SMS theo quốc gia của số hoặc ngôn ngữ tài khoản, nên hãy phân tích các chữ số thay vì từ khóa tiếng Anh.

Một lượt kích hoạt Thái Lan thất bại tốn bao nhiêu?

Không tốn gì. Nếu khung 20 phút kết thúc mà không có SMS, hoặc bạn hủy, toàn bộ số tiền tự động quay về ví.

Có cách nào chạy kiểm thử OTP Thái trong CI mà không tốn tiền không?

Có, hãy yêu cầu chế độ sandbox cho một tài khoản phát triển. Nó trả về số và mã mô phỏng để pipeline được kiểm thử từ đầu đến cuối, như đã nêu ở trang giải pháp CI/CD.

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.