Nhận mã SMS Truecaller bằng lập trình

Chuỗi lệnh gọi API cho Truecaller trông như thế nào?

Id dịch vụ của Truecaller là truecaller, và mọi lệnh gọi dưới đây được thực hiện tới https://otproute.com/api/v1 bằng khóa Bearer có tiền tố or_live_.

1. GET /api/v1/countries cho bạn các id quốc gia; hãy lưu cache.
2. GET /api/v1/prices?country=<id>&service=truecaller trả về giá hiện tại và cho biết một tuyến có đang mở lúc này hay không.
3. POST /api/v1/activations với {"service": "truecaller", "country": "in"} (hoặc bất kỳ id quốc gia nào khác) giữ chỗ số và trả về activation id.
4. Nhập số đó vào ứng dụng Truecaller trên thiết bị kiểm thử của bạn và yêu cầu xác minh.
5. Mã đến dưới dạng sự kiện webhook activation.sms_received, hoặc bạn polling GET /api/v1/activations/{id}.
6. Nếu bài kiểm thử bị bỏ dở, POST /api/v1/activations/{id}/cancel hoàn tiền ngay lập tức.

Một tài khoản hỗ trợ 10 khóa API, 5 endpoint webhook và 300 yêu cầu mỗi phút. Hướng dẫn tích hợp API đề cập việc thử lại và timeout.

Bộ xử lý webhook nên đối xử với các sự kiện Truecaller thế nào?

Mỗi lần gửi mang theo X-OTPRoute-Signature: t=<unix>,v1=<hex>. Tính lại HMAC-SHA256 trên timestamp, một dấu chấm và nội dung thô của yêu cầu với secret của endpoint, so sánh theo thời gian không đổi, và từ chối các timestamp quá cũ.

Gắn mọi xử lý với activation id. Webhook có thể được thử lại, nên một bộ xử lý lưu mã hai lần hoặc đẩy bài kiểm thử tiến hai lần sẽ cho kết quả chập chờn; hãy kiểm tra xem lượt kích hoạt đã được đánh dấu hoàn tất chưa trước khi hành động. Coi activation.expired và activation.cancelled là các trạng thái kết thúc, báo cho trình chạy kiểm thử ngừng chờ. Polling hoạt động như phương án dự phòng cho phát triển cục bộ, nơi không có endpoint công khai.

Vì sao Truecaller lại yêu cầu số điện thoại?

Truecaller là ứng dụng nhận diện người gọi và chặn spam, và số điện thoại chính là tài khoản. Việc đăng ký xác nhận người dùng kiểm soát số đó trước khi hồ sơ được tạo, và bước kiểm tra lặp lại khi ứng dụng được cài lại hoặc chuyển sang thiết bị mới. Trên một số thiết bị, ứng dụng có thể thử xác minh bằng cuộc gọi thay vì SMS. Số OTP Gateway chỉ thu SMS, nên kiểm tra bằng cuộc gọi sẽ không tạo ra mã trên lượt kích hoạt; khung thời gian đơn giản là hết và ví được hoàn tiền.

Những lý do hợp pháp để các đội xác minh tài khoản Truecaller gồm kiểm tra cách các số hỗ trợ hoặc giao hàng gọi ra của công ty được gắn nhãn với người dùng ở một thị trường nhất định, QA cho các ứng dụng tích hợp nhận diện người gọi, và nhân viên vận hành cần một hồ sơ công việc tách biệt khỏi điện thoại cá nhân.

Quốc gia nào có tuyến Truecaller?

Ảnh chụp trực tiếp liệt kê các tuyến Truecaller tại 198 quốc gia, trong đó có Ấn Độ, Pakistan, Bangladesh, Nigeria, Kenya, Ai Cập, Indonesia, Sri Lanka, Nepal, Ả Rập Xê Út, Các Tiểu vương quốc Ả Rập Thống nhất, Brazil, Mexico, Nam Phi, Vương quốc Anh và Hoa Kỳ.

Hãy chọn quốc gia khớp với trường hợp kiểm thử. Nhãn người gọi, báo cáo spam và ngôn ngữ ứng dụng đều theo thị trường, nên việc kiểm tra cách đường dây hỗ trợ ở Lagos của bạn hiển thị nên dùng tuyến Nigeria, chứ không phải tuyến nào tình cờ rẻ nhất. Tình trạng khả dụng thay đổi trong ngày; hãy truy vấn endpoint giá trước mỗi lần chạy.

Người không phải lập trình viên có làm được từ dashboard không?

Có. Đăng nhập, mở OTP Gateway, chọn Truecaller và một quốc gia, xác nhận giá hiển thị, và số sẽ xuất hiện trên thẻ kích hoạt. Nhập nó vào Truecaller, yêu cầu mã, và mã hiện trên cùng thẻ đó khi SMS đến. Khung 20 phút hiển thị ngay trên thẻ. Nếu không có mã nào đến, hoặc bạn hủy, toàn bộ số tiền tự động quay về ví của bạn. Nạp ví bằng thẻ hoặc USDT/USDC, với hóa đơn PDF qua email cho mỗi lần; xem bảng giá.

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

Các nguyên nhân thường gặp:

• Truecaller từ chối số vì coi nó là số ảo. Một số dịch vụ làm vậy; đó là lý do bạn được hoàn tiền.
• Ứng dụng chọn xác minh bằng cuộc gọi thay vì SMS.
• Tuyến bị nghẽn tạm thời. Hãy thử lại sau hoặc với quốc gia khác phù hợp với bài kiểm thử.
• Số được nhập không có mã quốc gia, hoặc kèm một số 0 trunk thừa.

Đừng dồn dập gọi endpoint đặt số trong vòng lặp. Hãy giãn cách các lần thử và ghi log từng activation id để bạn thấy được quy luật.

Khi nào Dedicated Number hợp lý hơn cho Truecaller?

Một số dùng một lần sẽ biến mất sau lượt kích hoạt. Nếu một hồ sơ Truecaller phải được xác minh lại sau này, ví dụ thiết bị công việc của đội hỗ trợ bị đặt lại, hãy dùng Dedicated Number. Các số này khả dụng ngay lập tức tại Hoa Kỳ và Canada từ $1.95/month, nhận SMS trong dashboard và qua webhook number.sms_received, và tự gia hạn từ ví cho đến khi bạn trả lại. Xem số ảo.

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

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

Id dịch vụ của Truecaller trong API là gì?

Là truecaller. Hãy ghép nó với id quốc gia trong GET /api/v1/prices và trong nội dung của POST /api/v1/activations.

Tôi có thể nhận OTP Truecaller trên số ảo không?

Thường là được, nhưng không phải lúc nào cũng vậy; Truecaller có thể từ chối các số mà nó phân loại là số ảo. Nếu không có mã nào đến trong 20 phút, khoản phí được hoàn tự động.

Vì sao Truecaller gọi điện thay vì gửi SMS?

Ứng dụng có thể chọn xác minh bằng cuộc gọi trên một số thiết bị. Số OTP Gateway chỉ thu SMS, vì vậy hãy yêu cầu tùy chọn SMS nếu ứng dụng cung cấp.

Tôi nên chọn quốc gia nào để kiểm thử xác minh SMS Truecaller?

Chọn thị trường mà bài kiểm thử của bạn nhắm tới, vì nhãn người gọi và ngôn ngữ theo quốc gia của số. Hãy kiểm tra tình trạng khả dụng trực tiếp bằng endpoint giá trước.

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

Có, với Dedicated Number tại Hoa Kỳ hoặc Canada từ $1.95/month. Số gateway dùng một lần không thể tái sử dụng.

Làm sao ngăn các lần gửi webhook trùng lặp làm hỏng bài kiểm thử của tôi?

Làm cho bộ xử lý có tính idempotent theo activation id và xác thực chữ ký trước khi làm bất cứ điều gì với dữ liệu.

OTP Route có liên kết với Truecaller không?

Không. Truecaller là nhãn hiệu của chủ sở hữu; OTP Route cung cấp số để kiểm thử và vận hành các tài khoản hợp pháp của chính bạn.

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.