Định tuyến mã xác minh Cộng hòa Congo (+242) vào hệ thống kiểm thử của bạn

Những lệnh gọi API nào lấy mã +242 từ đầu đến cuối?

Mọi thứ nằm dưới https://otproute.com/api/v1 và xác thực bằng khóa Bearer bắt đầu bằng or_live_. Hãy tạo khóa trong Developer console; một tài khoản có thể giữ tối đa 10 khóa, giúp bạn dễ cấp cho staging, CI và laptop của đồng nghiệp những thông tin xác thực riêng, có thể thu hồi độc lập.

Một lượt kiểm thử điển hình cho thị trường Brazzaville diễn ra như sau:

1. Lấy GET /api/v1/services và GET /api/v1/countries rồi lưu đệm các id. Cộng hòa Congo là cg (đừng nhầm với nước láng giềng lớn hơn, nước này có id và trang riêng tại Congo (DRC)).
2. Hỏi GET /api/v1/prices?country=cg&service=<id> để biết giá và tình trạng khả dụng trực tiếp của ứng dụng bạn đang kiểm thử.
3. Tạo lượt kích hoạt bằng POST /api/v1/activations với nội dung như {"service": "telegram", "country": "cg"}. Bạn nhận một id kích hoạt cùng số +242.
4. Nhập số đó vào màn hình đăng ký hoặc đăng nhập của chính sản phẩm bạn.
5. Lấy mã Congo từ một lượt gửi webhook hoặc bằng cách polling GET /api/v1/activations/{id}. Nếu bài kiểm thử bị hủy, hãy giải phóng bằng POST /api/v1/activations/{id}/cancel.

Hãy chạy GET /api/v1/balance trước khi một bộ kiểm thử bắt đầu để ví trống làm job thất bại sớm thay vì giữa chừng. Giới hạn 300 yêu cầu mỗi phút để lại nhiều dư địa cho vài worker chạy song song. Cấu trúc yêu cầu và phản hồi đầy đủ nằm trong tài liệu dành cho nhà phát triển.

Làm sao nối webhook có chữ ký cho các lượt kích hoạt Congo?

Polling phù hợp khi một kỹ sư bấm thử một luồng; webhook thân thiện hơn với cả đội CI. Hãy thêm một endpoint trong Developer console (mỗi tài khoản được phép năm endpoint) và đăng ký activation.sms_received, activation.expired và activation.cancelled.

Mỗi yêu cầu mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hãy dựng lại HMAC-SHA256 của "<t>.<raw body>" bằng secret của endpoint đó, so sánh với v1 bằng phép kiểm tra thời gian hằng định, và bỏ mọi yêu cầu có dấu thời gian đã cũ. Hãy băm các byte thô trước khi phân tích JSON, vì JSON được tuần tự hóa lại hiếm khi khớp từng byte.

Hãy coi các sự kiện được định danh theo id kích hoạt. Nếu cùng một sự kiện đến hai lần, trình xử lý của bạn nên nhận ra id đã được giải quyết và chỉ cần trả về mã trạng thái thành công. Hướng dẫn bắt OTP qua webhook trình bày các mẫu xếp hàng giúp các bộ chạy kiểm thử chậm không bị quá thời gian.

Một số xác minh Congo có thể bao phủ những dịch vụ nào?

Bản chụp hôm nay cho cg gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber và imo. Tổng cộng, quốc gia này có hơn 1.000 dịch vụ trên OTP Gateway.

Danh sách đó thay đổi trong ngày khi các tuyến mở và đóng, vì vậy đừng bao giờ mã hóa cứng. Hãy để bộ kiểm thử của bạn hỏi endpoint giá về dịch vụ cụ thể nó cần, và bỏ qua hoặc xếp lịch lại một cách nhẹ nhàng khi tình trạng khả dụng trống. Các ứng dụng nhắn tin có xu hướng chiếm ưu thế trong danh sách Congo, khớp với cách nhiều khách hàng ở đó lần đầu gặp một sản phẩm mới: qua một liên kết chia sẻ trong nhóm trò chuyện chứ không phải tìm kiếm trên kho ứng dụng.

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

Số của Cộng hòa Congo dài chín chữ số sau mã quốc gia, và không giống nhiều kế hoạch đánh số khác, số 0 đứng đầu là một phần của số thuê bao chứ không phải tiền tố trunk. Số di động thường được viết là 06… hoặc 05… trong nước và +242 06… ở dạng quốc tế. Một bộ chuẩn hóa sao chép từ codebase châu Âu và bỏ mọi số 0 đứng đầu sẽ âm thầm làm hỏng chúng, vì vậy hãy lưu đúng chuỗi E.164 mà API trả về và kiểm tra độ dài theo từng quốc gia thay vì dùng một quy tắc chung.

Tiếng Pháp là ngôn ngữ chính thức và là ngôn ngữ thường dùng của SMS xác minh, dù Lingala và Kituba được nói rộng rãi hằng ngày. Hãy chờ đợi ký tự có dấu trong một số mẫu tin và bảo đảm bộ phân tích của bạn lấy chữ số bằng một mẫu thay vì dựa vào câu chữ tiếng Anh cố định.

Các đội thường kiểm thử ở đây khi đưa sản phẩm vào khu vực Trung Phi nói tiếng Pháp, hỗ trợ nhân viên vận hành ở Brazzaville hoặc Pointe-Noire, hoặc phục vụ khách hàng Congo ở nước ngoài vẫn đăng ký bằng số quê nhà. Kiểm tra toàn bộ luồng trên một tuyến +242 thật sẽ bắt được các lỗi định dạng và nội dung mà trình giả lập bỏ sót.

Nếu không có mã nào đến số +242 thì sao?

Im lặng thường là vấn đề tuyến hoặc việc chấp nhận, không phải lỗi tích hợp. Một cách xử lý hợp lý:

• Để cửa sổ 20 phút chạy hết trước khi kết luận gì; một số đơn vị gửi gom lưu lượng đi của họ.
• Xác nhận dịch vụ đích có chấp nhận số ảo. Một số dịch vụ không chấp nhận, và đó chính là lý do một mã không nhận được sẽ không tốn gì.
• Thử lại sau, hoặc chuyển sang tuyến dịch vụ khác, thay vì bắn đơn mới trong vòng lặp dày làm cạn giới hạn tốc độ.
• Hủy những số bạn không cần nữa để tiền được hoàn ngay thay vì chờ hết hạn.

Bài viết của chúng tôi về giảm thiểu OTP gửi thất bại đề cập sâu hơn về backoff và ngân sách thử lại.

Tôi có thể giữ một dòng số Congo dài hạn không?

Không có số dài hạn tự phục vụ cho Cộng hòa Congo. OTP Gateway cấp một số cho mỗi mã xác minh, và đó là sản phẩm duy nhất được cung cấp cho cg hiện nay.

Số ảo chuyên dụng (Dedicated Virtual Numbers) của OTP Route là sản phẩm dành cho Hoa Kỳ và Canada, bắt đầu từ $1.95/month, có nhận và gửi SMS cùng gọi điện trên trình duyệt. Nếu đội của bạn thật sự cần một dòng số Congo cố định, hãy gửi email tới [email protected]; việc có thể sắp xếp được hay không phụ thuộc vào quy định địa phương, nên hãy xem đó là một câu hỏi chứ không phải lời hứa. Những đánh đổi được tóm tắt trong số tạm thời so với số chuyên dụng.

Thiết lập định tuyến OTP Congo được tính phí và kiểm thử an toàn thế nào?

Việc thanh toán chạy từ một ví USD trả trước duy nhất, không có gói đăng ký hay bậc gói. Nạp bằng thẻ hoặc stablecoin USDT/USDC, và mỗi lần nạp tạo một hóa đơn PDF gửi qua email cho bộ phận tài chính của bạn.

Trước khi đưa tiền thật vào pipeline, hãy nhờ bộ phận hỗ trợ chuyển một tài khoản phát triển sang chế độ sandbox. Nó trả về số và mã mô phỏng, nên bạn có thể chạy thử toàn bộ đường đi của API xác minh SMS từ đầu đến cuối mà không tốn gì. Chỉ dùng OTP Route cho sản phẩm của chính bạn và các tài khoản bạn có quyền vận hành; đ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 vẫn áp dụng. Xem bảng giá để biết các khoản phí và hoàn tiền hiển thị trong ví ra sao.

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

Country id của Cộng hòa Congo trong API OTP Route là gì?

Là cg. Cộng hòa Dân chủ Congo là một quốc gia riêng với id riêng, nên hãy kiểm tra kỹ cấu hình của bạn đang tham chiếu nước nào.

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

Có. Đặt một số +242 để kiểm thử từ OTP Gateway, nhập vào ứng dụng, rồi đọc mã trong dashboard hoặc qua API.

Tôi có bỏ số 0 đứng đầu khi lưu số +242 không?

Không. Ở Cộng hòa Congo, số 0 thuộc về số thuê bao chín chữ số, vì vậy hãy giữ giá trị E.164 đúng như API trả về.

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

Phần lớn đến bằng tiếng Pháp, đôi khi bằng tiếng Anh với các ứng dụng quốc tế. Hãy phân tích chữ số bằng một mẫu thay vì khớp với các từ cụ thể.

Tôi có bị tính phí nếu mã không bao giờ đến không?

Không. Nếu cửa sổ đóng mà không có SMS, hoặc bạn hủy trước, toàn bộ số tiền sẽ tự động quay lại ví của bạn.

Nhận một mã SMS OTP Congo tốn bao nhiêu?

Từ $0.20 mỗi mã; giá +242 của từng ứng dụng được báo trực tiếp, vì vậy hãy truy vấn trước khi đặt.

Có sandbox để xây dựng tích hợp không?

Có, theo yêu cầu. Bộ phận hỗ trợ có thể đưa một tài khoản phát triển vào chế độ sandbox, trả về số và mã mô phỏng mà không động đế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.