Menerima kode SMS Truecaller secara terprogram

Seperti apa rangkaian panggilan API untuk Truecaller?

Id layanan Truecaller adalah truecaller, dan setiap panggilan di bawah dibuat ke https://otproute.com/api/v1 memakai kunci Bearer berawalan or_live_.

1. GET /api/v1/countries memberi Anda id negara; simpan di cache.
2. GET /api/v1/prices?country=<id>&service=truecaller mengembalikan harga terkini dan apakah ada rute yang terbuka saat ini.
3. POST /api/v1/activations dengan {"service": "truecaller", "country": "in"} (atau id negara lain) memesan nomor dan mengembalikan id aktivasi.
4. Masukkan nomor itu di aplikasi Truecaller pada perangkat uji Anda dan minta verifikasi.
5. Kode tiba sebagai event webhook activation.sms_received, atau Anda melakukan polling GET /api/v1/activations/{id}.
6. Jika pengujian ditinggalkan, POST /api/v1/activations/{id}/cancel langsung mengembalikan dananya.

Satu akun mendukung 10 kunci API, 5 endpoint webhook, dan 300 permintaan per menit. Panduan integrasi API membahas percobaan ulang dan timeout.

Bagaimana handler webhook sebaiknya memperlakukan event Truecaller?

Setiap pengiriman membawa X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hitung ulang HMAC-SHA256 atas timestamp, sebuah titik, dan body permintaan mentah dengan secret endpoint Anda, bandingkan dalam waktu konstan, dan tolak timestamp yang terlalu lama.

Kaitkan seluruh pemrosesan ke id aktivasi. Webhook dapat dicoba ulang, jadi handler yang menyimpan kode dua kali atau memajukan pengujian dua kali akan menghasilkan hasil yang tidak stabil; periksa apakah aktivasi sudah ditandai selesai sebelum bertindak. Perlakukan activation.expired dan activation.cancelled sebagai status akhir yang memberi tahu test runner Anda untuk berhenti menunggu. Polling berfungsi sebagai cadangan untuk pengembangan lokal ketika tidak ada endpoint publik.

Mengapa Truecaller meminta nomor telepon sama sekali?

Truecaller adalah aplikasi caller ID dan pemblokir spam, dan nomor telepon adalah akunnya. Registrasi mengonfirmasi bahwa pengguna mengendalikan nomor itu sebelum profil dibuat, dan pemeriksaan berulang saat aplikasi dipasang ulang atau dipindah ke perangkat baru. Di beberapa perangkat, aplikasi dapat mencoba memverifikasi lewat panggilan, bukan SMS. Nomor OTP Gateway hanya menangkap SMS, jadi pemeriksaan berbasis panggilan tidak akan menghasilkan kode pada aktivasi; jendela waktunya habis begitu saja dan dompet dikembalikan dananya.

Alasan sah tim memverifikasi akun Truecaller antara lain memeriksa bagaimana nomor dukungan atau pengantaran keluar milik perusahaan diberi label bagi orang di pasar tertentu, QA pada aplikasi yang terintegrasi dengan identifikasi penelepon, dan staf operasional yang membutuhkan profil kerja terpisah dari ponsel pribadi mereka.

Negara mana yang memiliki rute Truecaller?

Snapshot langsung mencantumkan rute Truecaller di 198 negara, di antaranya India, Pakistan, Bangladesh, Nigeria, Kenya, Mesir, Indonesia, Sri Lanka, Nepal, Arab Saudi, Uni Emirat Arab, Brasil, Meksiko, Afrika Selatan, Inggris, dan Amerika Serikat.

Pilih negara yang sesuai dengan kasus uji. Label penelepon, laporan spam, dan bahasa aplikasi mengikuti pasar, jadi pemeriksaan bagaimana nomor dukungan Lagos Anda tampil sebaiknya memakai rute Nigeria, bukan yang kebetulan paling murah. Ketersediaan berubah sepanjang hari; kueri endpoint harga sebelum setiap eksekusi.

Bisakah non-developer melakukannya dari dashboard?

Bisa. Masuk, buka OTP Gateway, pilih Truecaller dan sebuah negara, konfirmasi harga yang ditampilkan, dan nomor muncul di kartu aktivasi. Masukkan di Truecaller, minta kodenya, dan kode itu tampil di kartu yang sama saat SMS masuk. Jendela 20 menit terlihat di kartu. Jika tidak ada kode yang tiba, atau Anda membatalkan, seluruh jumlahnya kembali ke dompet Anda secara otomatis. Top-up dompet dapat dilakukan lewat kartu atau USDT/USDC, dengan faktur PDF lewat email untuk setiap top-up; lihat harga.

Mengapa kode Truecaller bisa gagal tiba?

Penyebab umum:

• Truecaller menolak nomor karena menganggapnya virtual. Beberapa layanan memang begitu; itulah sebabnya Anda mendapat pengembalian dana.
• Aplikasi memilih verifikasi berbasis panggilan, bukan SMS.
• Rute sempat padat. Coba nanti atau dengan negara lain yang cocok dengan pengujian Anda.
• Nomor dimasukkan tanpa kode negara, atau dengan angka 0 awalan yang tertinggal.

Jangan membanjiri endpoint pemesanan dalam sebuah loop. Beri jarak antar percobaan dan catat setiap id aktivasi agar Anda dapat melihat polanya.

Kapan Nomor Dedicated lebih masuk akal untuk Truecaller?

Nomor sekali pakai hilang setelah aktivasi. Jika profil Truecaller harus diverifikasi ulang nanti, misalnya perangkat kerja tim dukungan yang direset, gunakan Nomor Dedicated. Nomor ini tersedia secara instan di Amerika Serikat dan Kanada mulai dari $1.95/month, menerima SMS di dashboard dan lewat webhook number.sms_received, serta diperpanjang dari dompet sampai Anda melepasnya. Lihat nomor virtual.

Gunakan OTP Route hanya untuk akun dan produk Anda sendiri yang sah: satu akun per orang atau bisnis yang nyata, tanpa laporan atau perubahan label terhadap nomor orang lain, dan dengan penghormatan penuh terhadap ketentuan Truecaller serta Acceptable Use Policy OTP Route. Truecaller adalah merek dagang pemiliknya, dan OTP Route tidak berafiliasi dengannya.

Pertanyaan umum

Apa id layanan Truecaller di API?

Id-nya truecaller. Pasangkan dengan id negara pada GET /api/v1/prices dan pada body POST /api/v1/activations.

Bisakah saya menerima OTP Truecaller di nomor virtual?

Sering kali bisa, tetapi tidak selalu; Truecaller dapat menolak nomor yang dikategorikan sebagai virtual. Jika tidak ada kode dalam 20 menit, biayanya dikembalikan otomatis.

Mengapa Truecaller menelepon alih-alih mengirim SMS?

Aplikasi dapat memilih verifikasi berbasis panggilan di beberapa perangkat. Nomor OTP Gateway hanya menangkap SMS, jadi minta opsi SMS jika aplikasi menawarkannya.

Negara mana yang sebaiknya saya pilih untuk pengujian verifikasi SMS Truecaller?

Pilih pasar yang menjadi topik pengujian Anda, karena label penelepon dan bahasa mengikuti negara nomor. Periksa dulu ketersediaan langsung lewat endpoint harga.

Bisakah saya mempertahankan nomor telepon Truecaller yang sama untuk login berikutnya?

Bisa, dengan Nomor Dedicated di Amerika Serikat atau Kanada mulai dari $1.95/month. Nomor gateway sekali pakai tidak dapat dipakai ulang.

Bagaimana mencegah pengiriman webhook ganda merusak pengujian saya?

Buat handler idempoten pada id aktivasi dan verifikasi tanda tangan sebelum melakukan apa pun dengan payload.

Apakah OTP Route berafiliasi dengan Truecaller?

Tidak. Truecaller adalah merek dagang pemiliknya; OTP Route menyediakan nomor untuk pengujian dan pengoperasian akun Anda sendiri yang sah.

Nama layanan adalah merek dagang milik pemiliknya masing-masing. OTP Route tidak berafiliasi dengan mereka. Gunakan nomor secara sah, patuhi ketentuan tiap layanan dan Kebijakan Penggunaan yang Dapat Diterima kami.