Daftar periksa pra-penerbangan untuk menerima kode login Telegram di nomor uji

Apa yang harus siap sebelum memesan nomor Telegram?

Periksa daftar ini lebih dulu; sebagian besar pengujian Telegram yang gagal bersumber dari salah satu butir berikut.

• Tujuan yang jelas. Anda menguji bot, Mini App, widget login, atau alur dukungan yang dijalankan tim Anda sendiri, dan Anda membutuhkan akun Telegram baru yang tidak terikat pada ponsel pribadi karyawan mana pun.
• Negara target. Tentukan pasar mana yang seharusnya tampak dimiliki akun itu. Bahasa bawaan dan beberapa layar onboarding mengikuti negara dari nomor tersebut.
• Dana dompet atau sandbox. Dompet prabayar yang terisi, atau akun pengembangan yang dialihkan ke sandbox oleh tim dukungan untuk uji coba.
• Kunci API, jika mengotomatiskan. Buat satu kunci berawalan or_live_ di Developer console.
• Perangkat atau emulator yang bersih. Telegram mengirim kode di dalam aplikasi ke sesi mana pun yang sudah login, sehingga perangkat tanpa sesi yang ada membuat jalur SMS lebih mudah diprediksi.
• Waktu. Setiap aktivasi terbuka selama 20 menit; jangan memulainya sebelum penguji siap mengetik nomornya.

Kapan Telegram benar-benar mengirim kode SMS?

Telegram mengenali setiap akun lewat nomor telepon. Ia meminta kode ketika seseorang mendaftarkan akun baru dan ketika akun yang sudah ada masuk di perangkat baru. Jika akun itu sudah aktif di tempat lain, Telegram biasanya mengirim kode login sebagai pesan di sesi yang ada, bukan lewat SMS, sehingga nomor baru di perangkat yang bersih adalah cara paling rapi untuk menguji langkah SMS. Telegram juga dapat menawarkan panggilan atau kirim ulang setelah jeda singkat.

Verifikasi dua langkah di Telegram adalah kata sandi cloud terpisah yang diatur di dalam aplikasi. Ini bukan faktor SMS, jadi simpan kata sandi itu di secret manager tim Anda jika Anda mengaktifkannya pada akun uji.

Negara mana yang bisa saya pilih untuk Telegram, dan mengapa itu penting?

Layanan telegram saat ini terdaftar di 199 negara, termasuk India, Jerman, Brasil, Nigeria, Indonesia, Inggris, Ukraina, Kazakhstan, Uzbekistan, Turki, Spanyol, Meksiko, Filipina, Vietnam, dan Mesir.

Sesuaikan negara dengan kasus uji. Bot yang membalas dalam bahasa Portugis sebaiknya dicoba dari akun Brasil; tim dukungan yang melayani Asia Tengah mungkin menginginkan nomor Kazakhstan. Telegram juga dapat memperlakukan nomor dari beberapa negara dengan lebih hati-hati daripada yang lain, jadi jika satu rute terus gagal, pasar tetangga adalah alternatif yang masuk akal. Ketersediaan langsung berubah sepanjang hari, jadi bacalah dari API, bukan dari daftar yang tersimpan.

Bagaimana cara mengotomatiskan kode Telegram dengan API?

1. Secara opsional, pastikan biayanya dengan GET /api/v1/prices?country=<id>&service=telegram.
2. Buat pesanan: POST /api/v1/activations dengan {"service": "telegram", "country": "<id>"}, dengan id negara diambil dari GET /api/v1/countries (misalnya br atau de).
3. Serahkan nomor yang dikembalikan ke test runner Anda, yang mengetikkannya ke klien atau emulator Telegram.
4. Tunggu kodenya. Dengan webhook, dengarkan activation.sms_received; jika tidak, lakukan polling GET /api/v1/activations/{id} pada interval yang wajar.
5. Bersihkan dengan POST /api/v1/activations/{id}/cancel jika pengujian dihentikan.

Untuk webhook, verifikasi X-OTPRoute-Signature dengan menghitung ulang HMAC-SHA256 atas <t>.<raw body> memakai secret endpoint, tolak timestamp lama, dan catat setiap id aktivasi yang sudah diproses agar event yang dikirim ulang diabaikan. Setiap akun mendapat hingga 5 endpoint webhook dan 300 permintaan per menit. Panduan pipeline CI membahas eksekusi paralel.

Bisakah saya melakukan langkah yang sama secara manual di dasbor?

Bisa. Masuk, buka OTP Gateway, pilih Telegram dan negaranya, periksa harga, lalu pesan. Salin nomor ke layar telepon Telegram, pilih kode negara yang sesuai, dan minta kodenya. Ketika SMS masuk, kode tampil di samping pesanan, siap ditempel.

Kode Telegram tidak datang. Apa saja daftar pemecahan masalahnya?

• Apakah ada sesi yang sudah ada? Jika nomor pernah dipakai sebelumnya, Telegram mungkin mengirim kode di dalam aplikasi. Aktivasi baru menghindari hal ini.
• Apakah jendela waktunya sudah habis? Biarkan timer 20 menit berjalan. Anda hanya membayar jika kode tiba; kedaluwarsa atau pembatalan mengembalikan seluruh biaya secara otomatis.
• Apakah rutenya diterima? Telegram dapat menolak beberapa nomor virtual. Itu di luar kendali kami dan justru alasan aturan pengembalian dana ada.
• Coba lagi dengan jeda. Pesan lagi nanti atau di negara lain; jangan memesan ulang dalam loop cepat, yang tidak membantu pengiriman maupun batas laju Anda.
• Periksa kode negara di perangkat. Ketidakcocokan antara negara yang dipilih dan nomornya adalah kesalahan yang mudah terjadi pada pengujian manual.

Kapan Dedicated Number lebih cocok untuk Telegram?

Nomor OTP Gateway sekali pakai cocok untuk pengujian pendaftaran. Jika akun Telegram harus masuk lagi bulan depan, misalnya akun tim yang menjalankan kanal dukungan atau login admin sebuah bot, akun itu memerlukan nomor telepon yang masih dikuasai tim Anda. Dedicated Number di Amerika Serikat dan Kanada, mulai $1.95/month, tetap menjadi milik Anda selama diperpanjang dan meneruskan SMS masuk ke dasbor serta ke webhook Anda sebagai number.sms_received. Perbandingan nomor sementara vs nomor khusus menjelaskan untung ruginya.

Seperti apa pengujian Telegram yang bertanggung jawab?

Ikuti ketentuan layanan Telegram. Buat satu akun per orang nyata atau per tujuan bisnis, gunakan untuk produk, bot, dan operasional Anda sendiri, dan jangan pernah untuk spam, pembuatan akun massal, atau menyiasati pemblokiran. Setiap pesanan Telegram yang Anda buat juga tercakup dalam Kebijakan Penggunaan yang Dapat Diterima OTP Route. Telegram adalah merek dagang pemiliknya, dan OTP Route tidak berafiliasi dengannya.

Pertanyaan umum

Bisakah saya mendapatkan kode verifikasi Telegram tanpa memakai ponsel pribadi?

Bisa. Pesan nomor Telegram dari OTP Gateway OTP Route, masukkan di aplikasi, lalu baca kode SMS di dasbor atau lewat API.

Apa id layanan Telegram di API?

Id-nya telegram. Gabungkan dengan id negara dari GET /api/v1/countries saat membuat aktivasi.

Berapa biaya verifikasi SMS Telegram untuk pengujian?

Mulai dari $0.20 per kode; harga persisnya bergantung pada negara dan dikembalikan secara langsung oleh endpoint harga.

Mengapa Telegram mengirim kode di dalam aplikasi, bukan lewat SMS?

Telegram mengirim kode login ke sesi yang sudah ada bila tersedia. Gunakan nomor baru dan perangkat tanpa sesi login untuk menguji jalur SMS.

Bisakah saya memakai ulang nomor sekali pakai untuk masuk kembali ke Telegram nanti?

Tidak, nomor OTP Gateway hanya untuk satu kode. Untuk login berulang, gunakan Dedicated Number di AS atau Kanada.

Apakah saya ditagih jika Telegram menolak nomornya?

Tidak. Jika tidak ada kode yang masuk ke nomor dalam 20 menit, atau Anda membatalkan, seluruh biaya kembali ke dompet Anda.

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.