Başla

Telegram API Erişim Nasıl Alınır: api_id, api_hash ve Bot Tokenleri

Telegram API kılavuzu

Telegram API Erişim Nasıl Alınır: api_id, api_hash ve Bot Tokenleri

Bu Telegram API tek bir API değil, üç tanedir: Bot API, İstemci API (MTProto) ve Gateway API. Bu kılavuz, kimlik bilgilerinizi tam olarak nereden alacağınızı ve neyi api_id, api_hash ve her biri bir BotFather bot token'ı kilidi açar; üçüncü seçenek ise çoğu kılavuzun atladığı seçenektir: tek bir satır MTProto kodu yazmadan Unipile aracılığıyla mevcut bir Telegram kullanıcı hesabını bağlamak.
Unipile ile inşa edin
Belgelere bakın

hosted-auth.js
Mevcut bir Telegram kullanıcı hesabını bağlayın // Kendi başınıza yönetmeniz gereken api_id / api_hash yok const bağlantı = bekliyor unipile.barındırılanKimlikDoğrulama.create({   sağlayıcılar ["TELGRAF"],   sonKullanmaTarihi: "2026-12-31T23:59:59.000Z" }); Kullanıcı QR kod veya oturumu ile giriş yapar // Hesap durumu "bağlandı" olarak değiştirilir"
hesap.durumu: "bağlandı"
Başlamak

3 Telegram API'si ve Hangisine İhtiyacınız Var

Çoğu rehber "Telegram API"den tek bir şeymiş gibi bahsetti. Öyle değildir. Telegram, her birinin kendi kimlik bilgileri, kendi kuralları ve kendi limitleri olan üç farklı API sunar. Yanlış olanı seçmek, yanlış kapıya karşı bir hafta harcamanın en kısa yoludur.

Bot API

Komutlara ve mesajlara tepki veren otomatik bir bot ister misiniz?
İhtiyaçlar: BotFather'dan bir bot token'ı
  • HTTP API, MTProto bilgisi gerekmez
  • Bir insan değil, bot hesap olarak hareket eder
  • Kullanımı ücretsiz

İstemci API'sı (MTProto)

Gerçek bir Telegram kullanıcısı gibi davranan tam bir istemci oluşturmanız gerekiyor mu?
Gereksinimler: my.telegram.org adresinden api_id + api_hash
  • Ham MTProto protokolü, istemciyi siz gerçeklersiniz
  • Gerçek bir kullanıcı hesabı gibi davran
  • Ücretsiz, her telefon numarası için bir api_id

Geçit API

Telefon numarası kimlik doğrulaması için yalnızca doğrulama kodları göndermeniz mi gerekiyor?
İhtiyaçlar: Bir Gateway API hesabı
  • Yalnızca Tek Kullanımlık Şifre (OTP) gönderimi, genel mesajlaşma için değil
  • Bot API ve Client API'den ayrı olarak piyasaya sürüldü
  • Bu kılavuzun kapsamı dışındadır
Hiçbiri uymuyor
Kendi MTProto istemcinizi oluşturmaktan kaçının
Unipile, mevcut bir Telegram kullanıcı hesabını Telegram'ın kendi Cihazlar özelliği, QR kodla giriş veya Barındırılan Kimlik Doğrulama (Hosted Auth) aracılığıyla birbirine bağlar. api_id yok, api_hash yok, bot sınırlaması yok.
Unipile ile oluşturun
İstemci API'sı / MTProto

Telegram API kimlik bilgilerinizi alın: api_id ve api_hash

Çoğu insanın aradığı ve asla açıkça belgelenmiş olarak bulamadığı gerçek "Telegram API'sini al" yolu budur: my.telegram.org, bölüm API geliştirme araçları. İşte baştan sona tam yürüyüş.
1
my.telegram.org adresine gidin ve oturum açın
Kimlik doğrulaması yapacağınız aynı telefon numarasıyla doğrulanmış, aktif bir Telegram hesabına ihtiyacınız var. Telefon numaranızı ve Telegram uygulamanıza gönderilen giriş kodunu girin.
2
"API geliştirme araçları"nı aç"
Bu bölüm my.telegram.org hesap ayarlarınız altında yer alır. Telegram'ın İstemci API kimlik bilgilerini verdiği tek resmi yer burasıdır.
3
Başvuru formunu doldurun
Uygulama başlığı, kısa adı ve platformu. Bu alanlar, MTProto kullanacak uygulamayı tanımlar; genel bir ürün adı ile eşleşmeleri gerekmez.
4
api_id ve api_hash'inizi alın
Telegram çifti hemen yayınlar. api_id sayısal bir tanımlayıcıdır, api_hash eşleşme gizlidir. Her ikisini de diğer kimlik bilgileri gibi saklayın, bunlar MTProto istemcinizin Telegram sunucularına kimlik doğrulamasını sağlar.
Etrafında plan yapıl0ması gereken bir kısıtlama
Bir telefon numarası tutabilir yalnızca bir api_id. Birden fazla uygulamaya veya ortama ihtiyacınız varsa, birkaç telefon numarasına ihtiyacınız olur veya aynı api_id'yi kod tabanınızda yeniden kullanırsınız. Aynı numarada ikinci bir api_id oluşturmanın self servis bir yolu yoktur.

.env
# my.telegram.org sitesinden, API geliştirme araçları TELEGRAM_API_ID=1234567 TELEGRAM_API_HASH=0123456789abcdef0123456789abcdef # Her telefon numarası için bir api_id, bunu güvenli bir şekilde saklayın
Bunun yerine Unipile ile hesap bağlantınızı kurun
Bot API

BotFather üzerinden bir bot token'ı alın

Telegram API'ye giden diğer yol bir my.telegram.org hesabı, api_id veya api_hash gerektirmez. Tamamen Telegram'ın kendi botuyla yapılan bir sohbetin içinde çalışır, @BotFather.
1
@BotFather ile bir sohbet açın
Telegram içinde "BotFather" araması yapın. Bu, Telegram'ın platformdaki diğer tüm botları oluşturmak ve yönetmek için kullandığı resmi bottur.
2
Gönder /yeni̇bot
BotFather, yeni bir bot oluşturma sürecinde size doğrudan sohbet üzerinden rehberlik eder; kontrol paneli veya form yoktur.
3
Bir isim ve bir kullanıcı adı seçin
Görünen ad herhangi bir şey olabilir. Kullanıcı adı benzersiz olmalı ve şu ile bitmelidir: bot, örneğin destek_botum.
4
Bot tokenını kopyala
BotFather tokenınızı hemen gönderir. Gizli tutun, botunuzun yaptığı her Bot API çağrısının kimliğini doğrular.

Mevcut Bot API sürüm 10.2, 14 Temmuz 2026'da yayınlanmıştır (kaynak: core.telegram.org/bots/api). Her bot token'ı aynı bu sürümlendirilmiş HTTP API'sine karşı çalışır.

terminal
# Bot API’sinde bot jetonunuzu test edin kıvrıl "https://api.telegram.org/bot/getMe" # Örnek yanıt {   "tamam doğru,   "sonuç {     "kimlik 123456789,     "is_bot": doğru,     "kullanıcı adı: "destek_botum"   } }
Karşılaştırma

Her bir Telegram API'sinin aslında yapmanıza izin verdiği şeyler

Telegram'a bağlanmanın dört yolu, dört çok farklı yetki seti. İşte her birinin neye bağlandığı, hangi kimlik bilgilerine ihtiyaç duyduğu ve nerede durduğu.
KriterlerBot APIİstemci API'sı (MTProto)Geçit APIUnipile
Neyi bağlıyorsunBir bot hesapİstemcisini oluşturduğunuz gerçek bir kullanıcı hesabıHiçbir şey, yalnızca OTP teslimatıMevcut gerçek bir kullanıcı hesabı
Kimlik bilgileri gerekiyorBotFather'dan bot token'ımy.telegram.org adresinden api_id + api_hashGateway API hesabıQR kodla giriş veya Barındırılan Kimlik Doğrulama (sağlayıcılar: "TELEGRAM")
Bir insan hesabı olarak gönderir/alırHayır, bir bot olarak hareket etEvetHayırEvet
MTProto uygulamasıGerekli değil, yalnızca HTTPKendin inşa ediyorsunGeçerli değilUnipile Tarafından İşlem Yapıldı
Grup katılımcı yönetimiBot izinleriyle sınırlıdırDolusu, eğer inşa edersenGeçerli değilKatılımcıları al, ekle, çıkar
Kurulum karmaşıklığıDüşükSelam, MTProto istemcisinin sahibisinDüşükDüşük, bakım gerektiren MTProto yok
MaliyetÜcretsizÜcretsizBu kılavuzda yer almamaktadırUnipile planınıza dahildir
Kötüye kullanım nedeniyle ban riskiToken iptaliFlood/spam paylaşımı kalıcı olarak yasaktırGeçerli değilUnipile's oran sınırı rehberliği ile hafifletildi
Bot API
BağlanırBir bot hesap
Kimlik BilgileriBot belirteci (BotFather)
Bir insan gibi davranHayır
KurulumDüşük
MaliyetÜcretsiz
İstemci API'sı (MTProto)
BağlanırGerçek bir kullanıcı hesabı (kendin yap müşterisi)
Kimlik Bilgileriapi_id + api_hash
Bir insan gibi davranEvet
KurulumYüksek, MTProto kendi yapımı
MaliyetÜcretsiz
Geçit API
BağlanırHiçbir şey, yalnızca OTP teslimatı
Kimlik BilgileriGateway API hesabı
KurulumDüşük
KapsamBu rehberden
Unipile
BağlanırMevcut gerçek bir kullanıcı hesabı
Kimlik BilgileriQR kod veya Barındırılan Kimlik Doğrulama
Bir insan gibi davranEvet
KurulumDüşük, bakım gerektiren MTProto yok
GruplarKatılımcıları al / ekle / kaldır
Unipile'ın Telegram'da Kapsamadığı Şeyler
Kanallar, topluluklar ve yayınlar, sohbet teması, gizli sohbetler, kişi / konum / anket / etkinlik ekleri, grup yönetimi (onaylama, yetkilendirme, yetkiyi kaldırma), sohbet silme, arşivleme ve sesli veya görüntülü aramalar. Unipile hesabı birbirine bağlar, her Telegram istemcisi özelliğini kopyalamaz.
Telegram entegrasyonunuzu Unipile ile oluşturun
Fiyatlandırma ve sınırlar

Ücretsiz. İşte işin koptuğu nokta burası.

Hem Bot API hem de Telegram API (MTProto) ücretsiz olarak kullanılabilir. Fatura yoktur, mesaj başına ücret yoktur, kimlik bilgilerini sınırlayan ücretli bir katman yoktur. İşin püf noktası para değil, davranıştır.
Sel basması, spam ve sahte sayaçlar
Çok hızlı mesaj göndermek, alakasız kullanıcılara toplu mesaj atmak veya görüntülenme ile tepki sayaçlarını yapay olarak artırmak, tetiklemenin en hızlı yoludur kalıcı yasaklama, hem Bot API'sinde hem de İstemci API'sinde.
Resmi olmayan istemciler izleniyor
Kendi api_id ve api_hash'iniz ile oluşturulan herhangi bir istemci otomatik olarak gözetime alındı Telegram sistemleri tarafından. Olağandışı kalıplar, resmi uygulamalara göre daha hızlı bir şekilde işaretlenir.
Unipile's own guidance to stay under the radar
Otomasyon için yepyeni Telegram hesaplarından kaçının, onları diğer tüm kanallar gibi ısıtın
Tam kapasiteyle başlamak yerine mesaj hacmini kademeli olarak artırın
Aynı hesaptan gönderilen mesajlar arasında en az 10 ila 20 saniye bırakın
Unipile ile daha güvenli mesajlaşma akışları oluşturun
Unipile yaklaşımı

Üçüncü yol: mevcut bir Telegram hesabını bağlayın

Ne Bot API ne de kendi yaptığınız bir MTProto istemcisi. Unipile'ın Telegram API'si şunu birbirine bağlar: mevcut Telegram kullanıcı hesabı, Telegram'ın kendi üzerinden Cihazlar özellik, Telegram'ı yeni bir telefonda veya masaüstü uygulamasında kullanmanızı sağlayan aynı mekanizma.
Giriş işlemi bir ... üzerinden gerçekleşir QR kod tarama, veya aracılığıyla Hosted Auth ile sağlayıcılar: "TELEGRAM" Kendi ürününüzün içinde markasız (white-label) bir bağlantı akışı istiyorsanız. Bağlantı kurulduktan sonra hesap kendi gibi davranır: bir bot değildir ve my.telegram.org adresinden alınmış bir api_id veya api_hash gerektirmez.
Bu, Telegram API üzerinde kendi başınıza geliştirme yapmanın en zor iki kısmını ortadan kaldırdığı için önemlidir: MTProto'yu uygulamak ve bir cihaz kaldırıldığında oturumları ve yeniden bağlanmaları yönetmek. Unipile cihazı hesabın Telegram oturumlarından kaldırılırsa, Unipile bunu algılar ve hesap durumu basitçe şu konuma geçer: Bağlantı kesildi, tekrar bağlanmaya hazır.
Gerçek hesap olarak doğrudan mesaj gönderin ve alın
Grup katılımcılarını yönet: getir, ekle, çıkar
Kanal, topluluk veya yayın yok
Grup yönetimi yok (onaylama, terfi ettirme, yetkiyi kaldırma), sesli veya görüntülü arama yok
API ile Telegram mesajı nasıl gönderilir
Unipile Telegram API ürün sayfası
Unipile ile inşa etmeye başlayın

Bağlı hesap
SağlayıcıTelegram
Kimlik doğrulama yöntemiQR kod / Barındırılan Kimlik Doğrulama
Durumbağlı
Telegram'dan cihaz kaldırıldıBağlantı kesildi
Yeniden senkronizasyon destekleniyorEvet
Kullanım durumları

Telegram API'sinin CRM ve ATS kullanım alanları

Bir Telegram hesabı bot olarak değil, gerçek ve bağlı bir hesap olarak bağlandığında, Unipile müşterileri arasında sürekli olarak iki kullanım durumu öne çıkmaktadır: satış ekiplerinin konuşmaları merkezi hale getirmesi ve işe alım uzmanlarının adaylara zaten oldukları yerde ulaşması.

CRM: Telegram sohbetlerini birleştirin

Halihazırda Telegram üzerinden potansiyel müşteriler ve müşterilerle iletişim kuran satış ve destek ekipleri bunun için ayrı bir uygulama istemiyor. Unipile aracılığıyla hesap bağlanarak, her bir Telegram mesaj dizisi e-posta, LinkedIn veya WhatsApp sohbetleriyle aynı gelen kutusuna düşer ve CRM'deki doğru kişi kaydına bağlanır.
Birleşik gelen kutusuBağlantılı hesaplarKişi senkronizasyonu

ATS: adaylara Telegram üzerinden ulaşın

Telegramın bir ana mesajlaşma kanalı olduğu bölgelerde işe alım uzmanları, adaylara doğrudan ATS üzerinden ulaşmak, tüm mesaj geçmişini aday profili altında tutmak ve bağlamı kaybetmeden konuşmaları işe alım uzmanları arasında devretmek için kendi Telegram hesaplarını bağlarlar.
Aday iletişimiMesaj geçmişiEkip devri
İstemci API'sı / MTProto

QR kod ile oturum açma: Cihaz akışı, adım adım

QR kodla giriş, Telegram'ın arkasındaki mekanizmadır Cihazlar Telegram Desktop veya Telegram Web'i hesabınıza eklemek için kullandığınız özelliğin aynısı. Bu aynı zamanda Unipile'ın mevcut bir Telegram kullanıcı hesabını bağlarken sizin adınıza yürüttüğü süreçtir. Bunu kendiniz inşa ediyorsanız, tek bir istek/yanıt çağrısı değil; hesaba halihazırda güvenen cihaz ile ona katılmak isteyen cihaz arasında iki yönlü bir el sıkışma gerçekleştiriyorsunuz demektir. İşte iki uygulama arasında tam olarak ne olduğu, yöntem yöntem aşağıdadır.
1
Giriş anahtarı talep et
Giriş yapmak isteyen cihaz arıyor auth.exportLoginToken. Telegram bir ile yanıt verir auth.loginTokengenellikle ikili (binary) bir belirteç ve bir son kullanma tarihi 30 saniye.
2
Bunu bir QR koduna dönüştür
Jeton şu şekilde kodlanmıştır: base64url ve içine yerleştirildi tg://login?token=<base64url> URL. Ekranda taranabilir bir QR kod olarak oluşturulan şey o URL'dir.
3
Zaten oturum açılmış bir uygulamadan tara
Zaten kimliği doğrulanmış olan Telegram uygulaması kodu tarar ve çağırır auth.acceptLoginToken çözülmüş belirteç ile.
4
Sonuç için anket
Oturum açan cihaz bir GirişJetonunuGüncelle güncelle, sonra çağırır auth.exportLoginToken taramanın sonucunu almak için tekrar.
5
Veri merkezini onaylayın veya taşıyın
Veri merkezi eşleşirse Telegram şunu döndürür auth.loginTokenSuccess, giriş yapıldı. Eşleşmezse, yanıt auth.loginTokenMigrateTo, ve istemci aramalıdır auth.importLoginToken belirtilen veri merkezine karşı aynı jetonla.

qr-giriş-akışı
// Giriş yapan cihaz auth.exportLoginToken(api_id, api_hash) // -> auth.loginToken { token, expires } // Bir QR kod olarak işlendi tg://login?token=<base64url(token)> // Zaten kimliği doğrulanmış cihaz bunu tarar auth.acceptLoginToken(jeton) Giriş yapan cihaz tekrar sorguluyor auth.exportLoginToken() // -> auth.loginTokenSuccess // veya auth.loginTokenMigrateTo { dc_id }
Kısa pencere, yeniden denemeyi planla
Bu jeton genellikle yalnızca 30 saniye. Taranmadan önce süresi dolarsa, müşterinin araması gerekir auth.exportLoginToken yeniden dene ve eski olanı sadece tekrar denemek yerine yeni bir kod üret.
GEÇERSİZ_YETKİLENDİRME_BELİRTECİ
KİMLİK_DOĞRULAMA_JETONU_SÜRESİ_DOLDU
DOĞRULAMA_JETONU_ZATEN_KABUL_EDİLDİ
Tam olarak, bir Telegram hesabını Unipile üzerinden bağladığınızda Unipile'ın sizin adınıza gerçekleştirdiği iletişim budur Cihazlar entegrasyon: QR kod, token değişimi, veri merkezi yönetimi ve bir token süresi dolduğunda yeniden deneme. Tek bir uç noktayı çağırırsınız, Unipile, bağlanmakta olan hesabın uygulamanızın ilk konuştuğu veri merkezinden farklı bir veri merkezinde bulunduğu durum dahil olmak üzere yukarıda açıklanan MTProto konuşmasını gerçekleştirir. Bu veri merkezi yönetimi, akışı sıfırdan oluşturduğunuzda gözden kaçırmak kolaydır, çünkü yalnızca hesapların bir alt kümesinde ortaya çıkar ve etkilenenler için oturum açma işlemlerini sessizce bozar eğer auth.loginTokenMigrateTo dal işlenmiyor.
Unipile ile QR giriş akışınızı oluşturun
İstemci API'sı / MTProto

Telefon numarasıyla giriş yapın ve 2FA engeli

Klasik telefon numarasıyla oturum açma, özel yapım Telegram istemcilerinin çoğunun takıldığı noktadır. Karmaşık olduğu için değil, çünkü iki aşamalı doğrulama açıldığı anda akış sessizce dallanır ve bu dal seçime bağlı değildir. Yalnızca sorunsuz senaryoyu (kod gönder, kodu doğrula, tamam) uygulayan bir istemci, bir test hesabında sorunsuz çalışır ve ardından bulut şifresi etkin gerçek bir kullanıcıyla ilk kez karşılaştığında canlı ortamda başarısız olur.
1
Giriş kodunu gönder
auth.sendCode kodu telefon numarasına gönderir ve bir auth.sentCode a içeren nesne phone_code_hash, bir sonraki arama için gerekli.
2
Kodu doğrula
auth.signIn kodu kontrol eder phone_code_hash. Telefon numarasının henüz bir hesabı yoksa Telegram şunu döndürür: Kayıt olmak için yetkilendirme gereklidir bir yetkilendirme yerine.
3
İki aşamalı doğrulama duvarına çarpmak
Hesapta iki faktörlü kimlik doğrulama etkinleştirilmişse, auth.signIn a ile cevaplar 400 hatası: SESSION_PASSWORD_NEEDED. Bu, bir istisna olarak ele alınamama durumu değil, bulut parolası olan herhangi bir hesap için beklenen yanıttır.
4
Bunu SRP ile netleştirin
Giriş işlemini tamamlamak, SRP protokolünün çalıştırılması anlamına gelir: bir InputCheckPasswordSRP hesap parola parametrelerinden nesne, ardından çağır auth.checkPassword. Başarı geri döner yetki.yetkilendirme; yanlış bir şifre döndürür GEÇERSİZ_ŞİFRE_ÖZETİ.
Yalnızca resmi uygulamalar Firebase SMS alır
Yalnızca Telegram'ın kendi resmi mobil uygulamalarının kullanılmasına izin verilir Firebase tabanlı SMS kodu gönderimi. Üçüncü taraf uygulamaların, kodu başka bir teslimat kanalından yönlendirmesi veya şuraya yazması gerekir: sms@telegram.org erişimi görüşmek üzere.
Bu yolda karşılaşabileceğiniz hatalar
OTURUM_PAROLASI_GEREKLİ
GEÇERSİZ_ŞİFRE_ÖZETİ
Kayıt olmak için yetkilendirme gereklidir
Unipile'ın Telegram entegrasyonu bu dalın tamamını sizin için çalıştırır: kod teslimi, OTURUM_PAROLASI_GEREKLİ kontrol edin, ve bir bulut parolası ayarlandığında SRP değişimi, hesabın bir telefon numarası, bir QR kodu aracılığıyla mı yoksa Hosted Auth. Yukarıdaki SMS gönderim kısıtlaması da buna dahildir: Üçüncü taraf uygulamalar Firebase tabanlı gönderime güvenemeyeceği için, telefon numarası akışını kendinizin yönetmesi, tek bir mesaj bile göndermeden önce sadece kod açısından değil, gerçek bir operasyonel yük de getiren noktalardan biridir.
Gönderim limitleri

Telegram API oran sınırları, rakamlarla

Bölüm 5, hesapların yasaklanmasına yol açan davranışları ele alıyordu. İşte Bot API tarafındaki gerçek belgelenmiş sınırlar ve bunları yükseltmenin maliyeti.
1/san
Aynı bireysel sohbete gönderilebilecek maksimum mesaj sayısı
dk/20
Tek bir gruptaki maksimum mesaj sayısı
~30/sn
Farklı sohbetlerde yayın yapmak için yaklaşık üst sınır
429
Bu limitlerden herhangi biri aşıldığında hata döndürülür
Ücretli yayınlar, iki şartla tavanı yükseltiyor
Botlar etkinleştirebilir ücretli yayınlar gönderme sınırını şu kadara çıkaran BotFather aracılığıyla Saniyede 1.000 mesaj. Ücretsiz eşiğin üzerinde gönderilen mesajlar ücrete tabidir. 0.1 Telegram Yıldızı her biri. Bu özellik, aynı anda karşılanması gereken iki hesap düzeyinde gereksinimin arkasında kilitlidir.
100.000 Yıldız bakiyesi
aylık 100.000 aktif kullanıcı
Bireysel, grup veya yayın üst sınırını aşın ve Bot API şu yanıtı verir: 429 kapsamındaki durum hata referansı aşağıda, yanında 420 TAŞKINI ve SEL_BEKLEME_SÜRESİ_X MTProto tarafında kullanılan kodlar. Her iki mekanizma da aynı nedenle var: Telegram sizin için yavaşlatmaya karar vermeden önce sizin yavaşlamanızı sağlamak.

Bu sayılar Bot API'ye özgüdür. Bağlı bir kullanıcı hesabı, Yayınlanmış bir tavan sınır yoktur, yalnızca Unipile'ın kendi hızlandırma rehberliği kapsamında yer alan Ücretsiz, işin koptuğu nokta tam olarak burasıYeni hesapları ısıtın, kademeli olarak artırın, mesajlar arasında en az 10 ila 20 saniye bekletin.
Hata referansı

Bilmeniz gereken Telegram API hataları

MTProto hataları, çoğu geliştiricinin zaten bildiği HTTP durum kodlarıyla aynı üç haneli yapıyı takip eder ve kısa, makine tarafından okunabilir bir dizeyle eşleştirilir. İşte referans tablosu ve yalnızca sizin için değil, son kullanıcılarınız için ortaya çıkan bir hata. Bu listeyi yayına almadan önce bilmek, aldıktan sonra bilmekten daha önemlidir: bu kodların birkaçı, 303 ve 420 özellikle bunlar olağanüstü hatalar değildir, bir MTProto istemcisinin normal çalışma koşullarının bir parçasıdır ve günlüğe kaydedilip göz ardı edilmek yerine kod yolunda ele alınmaları gerekir.
KodAnlam
303 DİĞER_GÖRİstek, farklı bir veri merkezini hedefleyecek şekilde tekrarlanmalıdır.
400 GEÇERSİZ_İSTEKSorgu hatalar içeriyor. API_KIMLIK_GECERSIZ bu kodun yaygın bir örneğidir.
401 YETKİSİZBu yöntem, yalnızca yetkili kullanıcılara ayrılmış bir özellik gerektirir.
403 YASAKGizlilik ihlali, örneğin sizi engellemiş bir kullanıcıya mesaj yazmaya çalışmak.
404 BULUNAMADIİstenen nesne veya yöntem mevcut değil.
420 FLOOD / FLOOD_WAIT_Xİzin verilen maksimum çağrı sayısı aşıldı, tekrar denemeden önce X saniye bekleyin.
303 DİĞER_GÖRİstek, farklı bir veri merkezini hedefleyecek şekilde tekrarlanmalıdır.
400 GEÇERSİZ_İSTEKSorgu hatalar içeriyor. API_KIMLIK_GECERSIZ bu kodun yaygın bir örneğidir.
401 YETKİSİZBu yöntem, yalnızca yetkili kullanıcılara ayrılmış bir özellik gerektirir.
403 YASAKGizlilik ihlali, örneğin sizi engellemiş bir kullanıcıya mesaj yazmaya çalışmak.
404 BULUNAMADIİstenen nesne veya yöntem mevcut değil.
420 FLOOD / FLOOD_WAIT_Xİzin verilen maksimum çağrı sayısı aşıldı, tekrar denemeden önce X saniye bekleyin.
Son kullanıcı tarafında bir tane daha
API_ID_YAYINLANDI_AKIN yayınlanmış bir uygulama örneği yeniden kullandığında son kullanıcılarınız için görünür api_id kendi örneğini istemek yerine açık kaynaklı örnek kodun içinde gönderilir. Yayınladığınız her uygulamanın kendi [uygulamaya ihtiyacı vardır] api_id ve api_hash my.telegram.org adresinden.
Client API (MTProto) üzerinde doğrudan oluşturulmuş bir istemci, bu kodların her biriyle kendi başına başa çıkmak zorundadır: doğru veri merkezi üzerinde yeniden deneme: 303, konusunda geri adım at 420, ve tedavi et 401 ve 403 genel hatalardan ziyade hesap durumuyla ilgili sinyaller olarak. Mevcut bir hesabı Unipile üzerinden bağlamak, kendi kodunuzun her çağrıda doğru şekilde yorumlaması gereken bir dizi MTProto kodu yerine, bu hata yönetimini tek bir bağlı hesap durumunun arkasına taşır.
İstemci API'sı / MTProto

Bir MTProto kütüphanesi seçmek ve bunun sizin için yapmayacağı şeyler

İstemci API yolunu kendiniz inşa etmeye karar verirseniz, bir şartnameden MTProto uygulamıyorsunuz demektir. Halihazırda bir avuç kütüphane bu protokolü konuşmaktadır, bu nedenle istemcinin kendisi nadiren zor olan kısmıdır. Bunlardan birini seçmek yalnızca sorunun bir kısmını çözer ve çözdüğü kısım genellikle daha küçük olanıdır.
Python

Telethon

async/await etrafında kurulmuş, ham protokol çağrıları yerine saf Python'a yakın okunan bir istemci API'sine sahip saf bir Python MTProto uygulaması.
Python

Pyrogram

Oturum yönetimi konusunda kendine özgü bir yaklaşımı ve bir protokol kütüphanesinden ziyade geleneksel bir SDK gibi hissettirmek için tasarlanmış bir istemci yüzeyine sahip başka bir Python MTProto istemcisi.
Node.js

GramJS

Node.js çalışma zamanı için aynı MTProto iletişim kuralını uygulayan, JavaScript ve TypeScript kod tabanları için Telethon'a en yakın eşdeğer.
Resmi

TDLib

C++ ile yazılmış ve çeşitli diller için bağlamaları (bindings) sunulan Telegram'ın kendi resmi kütüphanesidir. Telegram'ın kendi uygulamalarının yaptığı gibi tam MTProto yığınını uygular.
Hangisinin uygun olduğu genellikle bir özellik karşılaştırmasından ziyade halihazırda kullandığınız yazılım yığınına (stack) dayanır: Python tabanlı bir arka uç (backend) şuna işaret eder: Telethon veya Pyrogram, bir Node.js veya TypeScript backend'i şuna işaret eder GramJS, ve Telegram'ın kendi resmi uygulamalarına mümkün olduğunca yakın kalmak isteyen bir ekip, şunu işaret ediyor: TDLib ve ciltleri. Bu seçimlerin hiçbiri aşağıdaki eserin ikinci yarısını ortadan kaldırmaz.
Bir kütüphanenin size sundukları
MTProto şifreleme katmanı ve ham metot çağrıları
Telegram sunucularından gelen etkinlikler için güncelleme işleme
Kimlik doğrulama, mesajlaşma ve hesap yöntemlerini çağırmak için istemci taraflı bir API
Hâlâ kendi başınıza ne inşa ediyorsunuz
Oturumların yeniden başlatmalar ve dağıtımlar arasında güvenilir bir şekilde kalıcı hale getirilmesi
Kullanıcılarınız için SESSION_PASSWORD_NEEDED ve SRP akışını uçtan uca yönetme
Bir cihaz kaldırıldığında zarif bir şekilde yeniden bağlanma ve hesap durumunu takip etme
Ya da istemciyi tamamen atlayın
Unipile, MTProto istemcisini sizin için halihazırda çalıştırıyor
Oturum kalıcılığı, 2FA duvarı, yeniden bağlanma ve hesap yaşam döngüsü tek bir API üzerinden yönetilir. Mevcut bir Telegram hesabını bağlarsınız, bir kütüphane yönetmezsiniz.
Unipile ile inşa edin

Telegram API: Sık Sorulan Sorular

api_id, api_hash, BotFather bot tokenleri ve mevcut bir Telegram hesabını Unipile ile bağlama hakkında net yanıtlar.

Telegram'ın bir değil, üç API'si vardır. Bot API, bot hesapları için bir HTTP arayüzüdür. İstemci API'si olarak da adlandırılan Telegram API, MTProto protokolü üzerinde çalışır ve tam Telegram istemcilerinin üzerine kurulduğu şeydir. Ağ Geçidi API'si yalnızca doğrulama kodları gönderir. Hangisine ihtiyacınız olduğu, bir botu otomatikleştirip otomatikleştirmediğinize veya gerçek bir kullanıcı hesabı olarak hareket edip etmediğinize bağlıdır.
Tek bir Telegram API anahtarı yoktur. İstemci API'si (Client API) için my.telegram.org adresinden oturum açın, API geliştirme araçlarını açın ve bir api_id ile api_hash almak için formu doldurun. Bot API için Telegram içinden BotFather'a mesaj atarsınız ve o da bir bot token döndürür. Telegram'ın telefon numarası başına yalnızca bir api_id'ye izin verdiğini unutmayın.
Evet. Telegram, hem Bot API'sinin hem de Telegram API'sinin mesaj başına ücret alınmadan, ücretsiz olarak kullanılabilir olduğunu belirtmektedir. Gerçek maliyet; çalıştırdığınız altyapıda, oturum yönetimi işlemlerinde ve agresif gönderim yapmanız durumundaki banlanma riskinde yatar.
Bot API düz bir HTTPS arayüzüdür: sendMessage gibi metotları bot token'ınız ile api.telegram.org adresine çağırırsınız. İstemci API'si ise ikili bir MTProto protokolüdür; bu nedenle çoğu geliştirici bunu kendileri uygulamak yerine Telethon, Pyrogram veya GramJS gibi bir kütüphane kullanır.
14 Temmuz 2026'da yayınlanan Bot API 10.2; 11 Haziran 2026'daki 10.1'i ve 8 Mayıs 2026'daki 10.0'ı takip etti.
Evet. Unipile'ın hesapları bağlama yöntemi olan Telegram'ın kendi Cihazlar özelliği aracılığıyla mevcut bir Telegram hesabını, QR kodla giriş veya barındırılan bir kimlik doğrulama akışı kullanarak bağlayabilirsiniz. MTProto, oturum depolama veya iki aşamalı doğrulama işlemlerini kendiniz uygulamak zorunda kalmadan kullanıcı hesabı erişimi elde edersiniz.

Hala sorularınız mı var? Ekibimiz yardım etmek için burada.

Bir uzmanla konuşun
Doğru yapılmış Telegram API'si

Unipile ile Telegram API entegrasyonunuzu oluşturun

MTProto istemcisini atlayın, bot sınırlamalarını atlayın. Unipile aracılığıyla mevcut bir Telegram hesabını bağlayın ve bunu WhatsApp, LinkedIn, Instagram, Gmail, Outlook ve IMAP ile tek bir API'de birleştirin.
Unipile ile inşa edin
Belgeleri oku Telegram API sayfasına bakın
API ile bir Telegram mesajı gönderin
Unipile Telegram API ürün sayfası
tr_TRTR
en_USEN fr_FRFR es_ESES de_DEDE it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR