Telegram Telefon Numarası API Seçenekleri: Bot API, İstemci API veya Kayıt Kontrol API'si

Telefon numaralarıyla ilgili çalışmalar için Telegram Bot API, Telegram istemci API ve kayıt kontrol API'sinin geliştirici gözüyle karşılaştırması.

Tek bir "Telegram telefon numarası API'si" yoktur. Telegram Bot API, yalnızca bir kullanıcı numarasını paylaşmayı seçtiğinde numara alır; Telegram istemci API, gerçek bir kullanıcı hesabı ve kimlik bilgileri üzerinden çalışır; TG Validator gibi bir kayıt kontrol API'si ise gönderilen bir numaranın Telegram'da kayıtlı olup olmadığını yanıtlar. İhtiyacınıza uygun olanı seçin: gönüllü bir kullanıcıdan numara toplamak, kendi hesabınızı otomatize etmek veya elinizde zaten bulunan numaraları kontrol etmek.

Geliştiricilerin "Telegram telefon numarası API" derken kastettikleri

"Telegram telefon numarası API" aramaları genellikle şu üç işten birinden kaynaklanır:

1. Bir bot içinde kullanıcının numarasını toplamak, örneğin bir Telegram sohbetini müşteri hesabıyla ilişkilendirmek için.
2. Bir Telegram kullanıcı hesabını otomatize etmek, örneğin kişileri yönetmek veya özel bir istemci oluşturmak için.
3. Elinizde zaten bulunan numaraları kontrol etmek, örneğin bir kanal seçmeden önce hangi CRM kişilerinin Telegram hesabı olduğunu işaretlemek için.

Her iş, farklı kimlik bilgileri, limitler ve sorumluluklar içeren farklı bir arayüze karşılık gelir. Yanlış olanı seçmek, entegrasyonların duraksamasının en yaygın nedenidir.

Bot API: kullanıcının paylaşmayı seçtiği bir numarayı almak

Telegram Bot API, kullanıcıları telefon numarasına göre aramaz. Bir bot, numarayı yalnızca kullanıcı gönderdiğinde alır:

• request_contact ayarlı bir yanıt klavyesi düğmesi, kullanıcıdan kendi telefon numarasını kişi olarak paylaşmasını ister. Referans notları, bunun yalnızca özel sohbetlerde çalıştığını belirtir.
• Paylaşılan mesaj, telefon numarasını ve isteğe bağlı olarak kullanıcının Telegram tanımlayıcısını içeren bir Contact nesnesi taşır.

Bu, bir müşterinin Telegram sohbetini kendi tarafında açık bir eylemle hizmetinize bağlamasını istediğinizde doğru araçtır. Bir numara listesini kontrol edemez ve botlar, Telegram'ın yalnızca kullanıcılara açık olduğunu belirttiği istemci API'sinin kişi içe aktarma yöntemini çağıramaz (contacts.importContacts).

İstemci API: gerçek bir Telegram hesabını otomatize etmek

Telegram istemci API (MTProto), resmi ve üçüncü taraf uygulamaların kullandığı yöntemdir. TDLib, Telethon ve Pyrogram gibi kütüphaneler bunu sarmalar ve çoğu açık kaynaklı "telefon numarası denetleyicisi" betiği bunun üzerine inşa edilmiştir.

Bunun üzerine bir geliştirme yapmadan önce, Telegram'ın Obtaining api_id belgesinde belirttiklerine dikkat edin:

• Mevcut bir Telegram hesabından oluşturulmuş bir api_id ve api_hash değerine ihtiyacınız vardır; her telefon numarası yalnızca bir api_id ile ilişkilendirilebilir.
• Üçüncü taraf istemciler, API Hizmet Şartları'na uymalıdır. Resmi olmayan istemcileri kullanan hesaplar gözlem altına alınır ve API üzerinden flood veya spam yapmak kalıcı yasaklamaya yol açabilir.
• Kişileri içe aktarmak, bunları kodu çalıştıran hesapta saklar.

İstemci API, gerçek bir Telegram istemcisi oluşturmak veya kendi hesabınızı otomatize etmek için uygundur. İşletme kişi listelerini kontrol etmek için kullanıldığında, şirket verilerinin tek bir kişinin hesabında tutulması anlamına gelir ve o hesabın kaybedilmesi iş akışını durdurur.

Kayıt kontrol API'si: bir numaranın Telegram'da olup olmadığını yanıtlamak

Bir kayıt kontrol API'si, üçüncü iş için oluşturulmuştur. TG Validator'ın REST API'si, sizin tarafınızda herhangi bir Telegram hesabı olmadan çalışır:

• Tekli kontrol: sk_ ön ekli anahtarınızı taşıyan bir X-API-Key başlığı ile POST /api/v1/check. JSON gövdesi, tg hizmet türünü ve E.164 formatındaki telefon numarasını belirtir.
• Küçük gruplar: POST /api/v1/batch-check, istek başına 100 numaraya kadar kabul eder.
• Aynı yanıt akışı: her iki uç nokta da sonuçları yanıt içinde döndürür; gönderilecek veya sorgulanacak bir görev yoktur.
• Yanıt zarfı: belgelenen zarf, her yanıtı bir iş kodu ve mesajla sarmalar. Tamamlanmış bir sonuç, gönderdiğiniz numaranın Telegram'da kayıtlı olup olmadığını aynı yanıt içinde size bildirir. Karar verilemeyen bir kontrol, sıfır olmayan bir iş kodu döndürür ve tamamlanmış bir sonuç içermez.
• Bakiye: GET /api/v1/balance, büyük bir işten önce hizmetinizin kalan bakiyeyi kontrol etmesini sağlar.

Mevcut API belgeleri, dakika başına istek limiti yerine kullanıcı başına eşzamanlılık ve zaman aşımı kontrollerini tanımlar: beş adede kadar devam eden kontrol, tek bir kontrol için 60 saniyelik zaman aşımı ve çoklu numara kontrolü için 300 saniyelik zaman aşımı; hesap başına aynı anda bir adet çoklu numara kontrolü. Çalışanları ayarlamadan önce bunları belgelerden doğrulayın, çünkü değişebilirler.

100 numaradan çok daha uzun listeler için, ayrı asenkron toplu işlem uç noktaları bir TXT veya CSV yüklemesini kabul eder ve görev bittiğinde bir result.csv döndürür.

Telegram telefon numarası API karşılaştırması

Birçok ürün bu ikisini birleştirir: katılan kullanıcılarla konuşmak için bir bot ve hangi mevcut kişilerin Telegram üzerinden davet edileceğine karar vermek için bir kayıt kontrolü.

Kayıt kontrol API'si için entegrasyon kontrol listesi

• Önce normalleştirin. API'yi çağırmadan önce numaraları E.164 formatına (artı işareti, ülke kodu, trunk ön eki veya noktalama işareti olmadan) dönüştürün.
• Anahtarı sunucu tarafında tutun. Asla bir mobil uygulamada veya tarayıcı paketinde göndermeyin ve anahtarları panelden yönetin.
• Üç sonucu yönetin. Kayıtlı, Kayıtlı değil ve Belirlenemedi. Belirlenemeyen kontrolleri ayrı olarak saklayın ve negatif olarak yazmak yerine daha sonra tekrar deneyin.
• Eşzamanlılığa saygı gösterin. Çalışan havuzlarını belgelenen eşzamanlılık limitine göre boyutlandırın ve hatalarda sıkı bir döngüde tekrar denemek yerine bekleyin.
• Kontrol zamanını saklayın. Kayıt, kontrol anındaki bir sinyaldir; eski sonuçların yenilenebilmesi için tarihi saklayın.
• Karar verilen kontroller için bütçe ayırın. Tamamlanan her karar verilmiş kontrol, yanıt ne olursa olsun geçerli tarife üzerinden ücretlendirilir, bu nedenle göndermeden önce mükerrer kayıtları temizleyin.
• Yapay zeka istemcileri: https://tgvalidator.com/mcp adresindeki bir MCP uç noktası, aynı anahtar ve bakiye ile Bearer kimlik doğrulaması kullanarak aynı yanıtlı kontrolleri ve bakiyeyi MCP uyumlu istemcilere sunar. Toplu görevler REST API'sinde kalır.

SSS

Bir Telegram botu, kullanıcıyı telefon numarasına göre arayabilir mi?

Hayır. Bir bot, telefon numarasını yalnızca kullanıcı paylaştığında alır; bu genellikle özel bir sohbette kişiyi isteyen bir yanıt klavyesi düğmesi aracılığıyla olur. Bir numara listesini kontrol etmek için ya istemci API'sinde bir kullanıcı hesabı ya da bir kayıt kontrol API'si gerekir.

Ekipler, Telegram hesabı olmadan Telegram kaydını nasıl kontrol edebilir?

Bir kayıt kontrol API'si kullanın. TG Validator, POST /api/v1/check adresinde bir E.164 numarasını veya POST /api/v1/batch-check adresinde 100 numaraya kadar kabul eder, X-API-Key başlığı ile kimlik doğrulaması yapar ve sonucu aynı yanıt içinde döndürür.

TG Validator API'sinde dakika başına bir hız sınırı var mı?

Dakika başına bir istek limiti yayınlanmamıştır. Belgeler bunun yerine kullanıcı başına eşzamanlılık ve zaman aşımı kontrollerini tanımlar, bu nedenle entegrasyonlar çalışanları bu kontrollere göre boyutlandırmalı ve değişiklikler için güncel belgeleri kontrol etmelidir.

Ekipler daha büyük bir kullanımdan önce API'yi nasıl deneyebilir?

Kayıtlı kullanıcılar, giriş normalleştirmesini, belirlenemeyen durum yönetimini ve günlüğe kaydetmeyi küçük bir örneklem üzerinde test etmek için yeterli olan 100 ücretsiz kontrol almak üzere destek ekibiyle iletişime geçebilir.

Daha Fazla Bilgi

İş akışınızdaki bir sonraki adıma uygun ürün bilgisini seçin.

• Ürün belgelerini görüntüleyin →
• Ekiple konuşun →