Skip to content
Teknik
6 dk okuma6 Kasım 2026

Telegram'da Telefon Doğrulama Nasıl Çalışır

Bir Telegram botu göndericinin telefon numarasını hiç görmez; bu yüzden orada numara doğrulamak WhatsApp'tan farklı işler. İşte akış, arkasındaki denetimler ve uygulamanıza dönen sonuç.

Solda: bir mesaj ve telefon numarası paylaşmak için mavi bir düğme gösteren, bir botla yapılan sohbet. Bir ok sağa, mavi zemin üzerinde mavi onay işareti taşıyan beyaz bir kalkana işaret ediyor; yani paylaşılan numara doğrulanmış

WhatsApp, Phone-Verif'in ilk kanalıydı ama herkes orada yaşamıyor. Telegram artık ikinci kanal: aynı API, aynı sonuç ve varsayılan olarak açık. Altta yatan işleyiş farklı ve sunmadan önce anlamaya değer.

WhatsApp'ta kanıt, kişinin gönderdiği bir mesajdır: mesaj kendi numarasından gelir ve Reverse OTP'nin ardındaki fikir budur. Telegram botunda böyle bir sinyal yoktur. İnsanları sayısal bir hesap kimliğiyle tanır ve kişi paylaşmayı seçmedikçe telefon numarası gizli kalır. Dolayısıyla botun sorması gerekir ve kanıt göndericiden başka bir yerden gelmelidir.

Kişi ne yapıyor

Okunacak ya da yazılacak bir kod yok. Tüm akış Telegram içinde iki dokunuştan ibaret.

1. Bağlantıyı açın

Sayfanız bir QR kod veya düğme gösterir. İkisi de oturum belirtecini bağlantıda taşıyarak botumuza götürür.

2. Başlat'a basın

Başlat'a basmak bu belirteci bota iletir; bot da bu Telegram hesabını oturumla ilişkilendirir.

3. Numarayı paylaşın

Bot tek bir düğme gösterir: “Telefon numaramı paylaş”. Düğmeye dokunmak, hesabın Telegram'a ait kendi kişi kartını gönderir.

4. Tamam

Bot onaylar, oturum doğrulanır ve uygulamanız webhook'unu ve durum sonucunu alır.

Paylaşılan kişi neden kanıt sayılır

Herkes bota bir rakam dizisi gönderebilir; bu yüzden yazılan numaralar doğrudan reddedilir: bot düğmeyi yeniden göstererek yanıt verir. Yalnızca kişi kartı okunur ve oturum tamamlanmadan önce dört denetimden geçmesi gerekir.

Kendi kişi kartıdır

Kartın üzerindeki kullanıcı kimliği, kartı gönderen hesapla eşleşir. Bir rehberden alınan başkasına ait kart burada elenir.

Doğru hesaptan gelir

Gönderen, bu oturumda Başlat'a basan hesaptır; bu nedenle bir kart, başkası tarafından açılmış bir oturumu tamamlayamaz.

İletilmemiştir

Başka bir sohbetten iletilen kart, göndericinin kendi kartı olsa bile reddedilir.

Günceldir

Kart, oturum açıldıktan sonra gönderilmiştir; böylece eski bir kart yeniden kullanılamaz.

Herhangi bir denetimde başarısız olan kart hiçbir şeyi değiştirmez: bot yeniden sorar ve oturum açık kalır. Engelleme listesindeki bir numara, WhatsApp'ta olduğu gibi Telegram'da da reddedilir.

Her oturum yalnızca bir kez tamamlanır

Düğmeye çift dokunmak iki kişi kartı gönderir ve yeniden denenen bir teslimat aynı kartı iki kez gönderebilir. Bu nedenle bir oturumun tamamlanması atomik olarak üstlenilir: tek bir kart kazanır ve tek bir sonuç, tek bir webhook ve harcanan tek bir kredi olur.

Bir oturum ayrıca yalnızca tek bir kanalda tamamlanabilir. Varsayılan olarak WhatsApp, SMS ve bota açıktır; biri oturumu tamamladığında diğerleri belirtecini reddeder. Telegram'a veya WhatsApp'a kilitlenmiş bir oturum diğer kanalı en baştan reddeder. Bot bağlantısı her belirteç için aynı şekilde yönlendirir; bu yüzden hangi belirteçlerin canlı olduğunu öğrenmek için kullanılamaz.

Tek numara, tek kimlik

Telegram ve WhatsApp telefon numaralarını farklı yazar; bu nedenle başka bir şey olmadan önce numara aynı biçime normalleştirilir. Kimlikler bu numaraya göre anahtarlandığı için bu önemlidir.

Bugün WhatsApp'ta, yarın Telegram'da doğrulama yapan bir kişi aynı user_id'yi alır. İki kullanıcı değil, tek kullanıcıdır ve flow=login buna göre is_new_user bildirir.

Bunu biz de kullanıyoruz. Kendi giriş sayfamızdaki Telegram Connect ve WhatsApp Connect, kişi hangisini önce kullanmış olursa olsun aynı numara için aynı hesaba götürür.

Geriye ne dönüyor

Entegrasyonunuz WhatsApp'takiyle aynı durum yanıtını okur ve aynı webhook'u alır; bir doğrulama da aynı krediyi harcar. phone, login ve 2fa akışlarının hepsi çalışır.

Bir şey eklenir. flow=phone akışında doğrulanmış bir Telegram oturumu ayrıca hesabın user_id, username, first_name ve last_name değerlerini içeren bir telegram nesnesi taşır. Login ve 2FA bunu dışarıda bırakır: bir kullanıcı kimliği veya bir eşleşmeyle yanıt verirler ve bir kullanıcı adı, tıpkı bir numara gibi kişiyi tanımlar.

Neyi kanıtlamaz

Doğrulanmış bir oturum, bu Telegram hesabının bu numarayı taşıdığını gösterir. SIM kartın bugün kimde olduğu hakkında hiçbir şey söylemez; SIM takası yazısında açıklandığı gibi bu, bir hesaba dayanan her kanalla paylaştığı bir sınırdır.

Sahiplik denetimi ayrıca Telegram'ın kişi kartında bildirdiği kullanıcı kimliğine bağlıdır. Telegram'ın Bot API dokümantasyonu bu alanın nasıl doldurulduğunu anlatmaz; dolayısıyla burada, WhatsApp'taki gönderen numarasına güvendiğiniz gibi platforma güveniyorsunuz.

Pratik sınırlar da var. Kişinin Telegram'a ihtiyacı var ve Telegram'a kilitlenmiş bir oturumun SMS yedeği yok.

Eklemek

Oturumlar varsayılan olarak Telegram'a açıktır, bu yüzden eklenecek bir parametre yoktur. Bir oturumu bota kilitlemek için provider=telegram, botu dışarıda bırakmak için provider=whatsapp gönderin.

curl -X POST "https://api.phone-verif.com/start-verification" \
  -H "X-API-Key: $PHONE_VERIF_API_KEY"

Telegram kullanılamıyor olmadıkça yanıt, whatsapp ve sms yanında bir telegram bloğu içerir. qr_code_url değerini QR kodunuza kodlayın, mobilde düğme için direct_link kullanın.

{
  "whatsapp": { "...": "..." },
  "sms": { "...": "..." },
  "telegram": {
    "qr_code_url": "https://t.phone-verif.com/tg/<token>",
    "direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
  }
}

Hesap açmadan Telegram demosunda deneyebilirsiniz. Tam API'yi entegrasyon rehberi kapsar.