Opsi API Nomor Telepon Telegram: Bot API, Client API, atau API Pemeriksaan Pendaftaran

Perbandingan bagi pengembang mengenai Telegram Bot API, Telegram client API, dan API pemeriksaan pendaftaran untuk pekerjaan yang melibatkan nomor telepon.

Tidak ada satu API nomor telepon Telegram tunggal. Telegram Bot API hanya menerima nomor telepon saat pengguna memilih untuk membagikannya, Telegram client API bekerja melalui akun pengguna asli beserta kredensialnya, dan API pemeriksaan pendaftaran seperti TG Validator menjawab apakah suatu nomor terdaftar di Telegram atau tidak. Pilih yang sesuai dengan pekerjaan Anda: mengumpulkan nomor dari pengguna yang bersedia, mengotomatiskan akun Anda sendiri, atau memeriksa nomor yang sudah Anda miliki.

Apa yang dimaksud pengembang dengan API nomor telepon Telegram

Pencarian untuk "telegram phone number api" biasanya berasal dari salah satu dari tiga jenis pekerjaan berikut:

1. Mengumpulkan nomor pengguna di dalam bot, misalnya untuk menautkan obrolan Telegram ke akun pelanggan.
2. Mengotomatiskan akun pengguna Telegram, misalnya untuk mengelola kontak atau membangun klien kustom.
3. Memeriksa nomor yang sudah Anda miliki, misalnya untuk menandai kontak CRM mana yang memiliki akun Telegram sebelum memilih saluran komunikasi.

Setiap pekerjaan dipetakan ke antarmuka yang berbeda dengan kredensial, batasan, dan tanggung jawab yang berbeda pula. Memilih antarmuka yang salah adalah alasan paling umum mengapa integrasi terhambat.

Bot API: menerima nomor yang dipilih pengguna untuk dibagikan

Telegram Bot API tidak mencari pengguna berdasarkan nomor telepon. Bot hanya menerima nomor saat pengguna mengirimkannya:

• Tombol papan tik balasan dengan request_contact yang diaktifkan meminta pengguna untuk membagikan nomor telepon mereka sendiri sebagai kontak. Referensi mencatat bahwa ini hanya berfungsi dalam obrolan pribadi.
• Pesan yang dibagikan membawa objek Contact yang berisi nomor telepon dan, secara opsional, pengenal Telegram pengguna.

Ini adalah alat yang tepat jika Anda ingin pelanggan menghubungkan obrolan Telegram mereka ke layanan Anda dengan tindakan eksplisit dari pihak mereka. Alat ini tidak dapat memeriksa daftar nomor, dan bot tidak dapat memanggil metode impor kontak client API, yang menurut dokumentasi Telegram hanya tersedia untuk pengguna (contacts.importContacts).

Client API: mengotomatiskan akun Telegram asli

Telegram client API (MTProto) adalah apa yang digunakan oleh aplikasi resmi dan pihak ketiga. Pustaka seperti TDLib, Telethon, dan Pyrogram membungkusnya, dan sebagian besar skrip "pemeriksa nomor telepon" sumber terbuka dibangun di atasnya.

Sebelum membangun di atasnya, perhatikan apa yang didokumentasikan Telegram dalam Obtaining api_id:

• Anda memerlukan api_id dan api_hash dari my.telegram.org, yang dibuat dari akun Telegram yang sudah ada; setiap nomor telepon hanya dapat ditautkan ke satu api_id.
• Klien pihak ketiga harus mematuhi Ketentuan Layanan API. Akun yang menggunakan klien tidak resmi akan ditempatkan di bawah pengawasan, dan membanjiri atau mengirim spam melalui API dapat menyebabkan pemblokiran permanen.
• Mengimpor kontak akan menyimpannya di akun yang menjalankan kode tersebut.

Client API sangat cocok untuk membangun klien Telegram asli atau mengotomatiskan akun Anda sendiri. Untuk memeriksa daftar kontak bisnis, ini berarti data perusahaan tersimpan di akun satu orang, dan kehilangan akun tersebut akan menghentikan alur kerja Anda.

API pemeriksaan pendaftaran: menjawab apakah suatu nomor ada di Telegram

API pemeriksaan pendaftaran dibuat untuk pekerjaan ketiga. REST API TG Validator bekerja tanpa akun Telegram di pihak Anda:

• Pemeriksaan tunggal: POST /api/v1/check dengan header X-API-Key yang membawa kunci berawalan sk_. Isi JSON menyebutkan tipe layanan tg dan nomor telepon dalam format E.164.
• Batch kecil: POST /api/v1/batch-check menerima hingga 100 nomor per permintaan.
• Alur respons langsung: kedua endpoint mengembalikan hasil dalam respons; tidak ada tugas untuk dikirim atau dipantau (poll).
• Amplop respons: amplop yang didokumentasikan membungkus setiap jawaban dengan kode bisnis dan pesan. Hasil yang selesai memberi tahu Anda, dalam respons yang sama, apakah nomor yang Anda kirim terdaftar di Telegram. Pemeriksaan yang tidak dapat ditentukan akan mengembalikan kode bisnis bukan nol dan tidak ada hasil yang selesai.
• Saldo: GET /api/v1/balance memungkinkan layanan Anda memeriksa saldo yang tersisa sebelum melakukan pekerjaan besar.

Dokumentasi API saat ini menjelaskan kontrol konkurensi dan batas waktu per pengguna, bukan batas permintaan per menit: hingga lima pemeriksaan yang sedang berjalan, batas waktu 60 detik untuk satu pemeriksaan, dan 300 detik untuk pemeriksaan multi-nomor, dengan satu pemeriksaan multi-nomor per akun dalam satu waktu. Konfirmasikan hal ini dalam dokumentasi sebelum menyesuaikan pekerja, karena dapat berubah sewaktu-waktu.

Untuk daftar yang jauh melebihi 100 nomor, endpoint bulk asinkron terpisah menerima unggahan TXT atau CSV dan mengembalikan satu result.csv saat tugas selesai.

Perbandingan API nomor telepon Telegram

Banyak produk menggabungkan dua di antaranya: bot untuk berbicara dengan pengguna yang memilih untuk ikut serta (opt-in), dan pemeriksaan pendaftaran untuk memutuskan kontak mana yang akan diundang melalui Telegram.

Daftar periksa integrasi untuk API pemeriksaan pendaftaran

• Normalisasi terlebih dahulu. Ubah nomor ke format E.164 (tanda plus, kode negara, tanpa awalan trunk atau tanda baca) sebelum memanggil API.
• Simpan kunci di sisi server. Jangan pernah menyertakannya dalam aplikasi seluler atau bundel peramban, dan kelola kunci dari dasbor.
• Tangani tiga hasil. Terdaftar, Tidak terdaftar, dan Tidak dapat ditentukan. Simpan pemeriksaan yang tidak dapat ditentukan secara terpisah dan coba lagi nanti alih-alih menulisnya sebagai negatif.
• Hormati konkurensi. Sesuaikan kumpulan pekerja (worker pool) dengan batas yang didokumentasikan dan lakukan back-off pada kesalahan alih-alih mencoba lagi dalam perulangan yang ketat.
• Simpan waktu pemeriksaan. Pendaftaran adalah sinyal pada saat pemeriksaan; simpan tanggalnya agar hasil yang kedaluwarsa dapat diperbarui.
• Anggarkan untuk pemeriksaan yang diputuskan. Setiap pemeriksaan yang selesai dan diputuskan akan dikenakan biaya sesuai tarif yang berlaku apa pun jawabannya, jadi lakukan deduplikasi sebelum mengirim.
• Klien AI: endpoint MCP di https://tgvalidator.com/mcp mengekspos pemeriksaan respons langsung dan saldo yang sama ke klien yang kompatibel dengan MCP, menggunakan autentikasi Bearer dengan kunci dan saldo yang sama. Tugas bulk tetap berada di REST API.

FAQ

Dapatkah bot Telegram mencari pengguna berdasarkan nomor telepon?

Tidak. Bot hanya menerima nomor telepon saat pengguna membagikannya, biasanya melalui tombol papan tik balasan yang meminta kontak dalam obrolan pribadi. Memeriksa daftar nomor memerlukan akun pengguna pada client API atau API pemeriksaan pendaftaran.

Bagaimana tim dapat memeriksa pendaftaran Telegram tanpa akun Telegram?

Gunakan API pemeriksaan pendaftaran. TG Validator menerima nomor E.164 di POST /api/v1/check, atau hingga 100 nomor di POST /api/v1/batch-check, diautentikasi dengan header X-API-Key, dan mengembalikan hasil dalam respons yang sama.

Apakah ada batas tarif per menit pada API TG Validator?

Tidak ada batas permintaan per menit yang dipublikasikan. Dokumentasi menjelaskan kontrol konkurensi dan batas waktu per pengguna, sehingga integrasi harus menyesuaikan pekerja dengan kontrol tersebut dan memeriksa dokumentasi terkini untuk perubahan.

Bagaimana tim dapat mencoba API sebelum peluncuran yang lebih besar?

Pengguna terdaftar dapat menghubungi dukungan untuk menerima 100 pemeriksaan gratis, yang cukup untuk menguji normalisasi input, penanganan hasil yang tidak dapat ditentukan, dan pencatatan terhadap sampel kecil.

Pelajari Lebih Lanjut

Pilih informasi produk yang sesuai dengan langkah berikutnya dalam alur kerja Anda.

• Lihat dokumentasi produk →
• Hubungi tim →