Telegram Ads API & Entegrasyonları: İş Akışınızı Otomatikleştirin

Telegram reklamverenler için bir API yayımlamıyor: geliştirici sitesinde bir Bot API, bir istemci API’si, TDLib, bir Gateway API ve bir Payments API listeleniyor; hiçbiri reklam kampanyası oluşturmuyor ya da kampanyalar hakkında rapor vermiyor. ADSLY reklam hesaplarınıza yetkili bir oturum üzerinden bağlanır ve bunun üstüne üç entegrasyon yüzeyi koyar: istatistiklerinizi okuyan ve siz izin verirseniz kampanyalarınızı da yöneten bir REST API, imzalı webhook’lar ve tracker’ınızdan dönüşüm alan bir endpoint.

Telegram Ads «API’si» nasıl çalışır

Telegram’ın reklam platformu ads.telegram.org adresindedir ve web arayüzünden yönetilir. Telegram’ın geliştirici dokümantasyonunu Ekim 2026’da kontrol ettik: core.telegram.org Bot API’yi (botlar için bir Payments API ile birlikte), TDLib’i, Gateway API’yi ve istemci uygulamaları geliştirmek için Telegram API’yi tanıtıyor. Reklamla ilgili iki makalesi var: Sponsored Messages istemci uygulamalarına reklamları nasıl göstereceğini anlatıyor, diğeri ise kanal ve bot sahiplerinin reklam gelirini konu alıyor; hiçbiri kampanya yöneten bir reklamveren için değil. Platformun kendi başlangıç rehberi de bir API’den söz etmiyor.

Bu yüzden ADSLY, reklam hesabının sahibi olan Telegram hesabının oturumu üzerinden çalışır. Bir hesabı üç yoldan bağlayabilirsiniz: telefon numaranızı girip isteği Telegram’da onaylamak, ads.telegram.org’da oturumunuz açıkken tarayıcı uzantımızı kullanmak ya da oturum token’ını kendiniz yapıştırmak. İstek yalnızca reklam hesabını bağlar, kişisel Telegram’ınızı değil. Adstat kaynaklı hesaplar Adstat girişinizle bağlanır. Bağlandıktan sonra Euro, TON ve Stars hesapları aynı şekilde yönetilir.

Hesap bağlandıktan sonra ADSLY ne yapar

Web arayüzünde tek tek tıklayarak yaptığınız her şey panelde bir işleme dönüşür:

Kampanya oluşturma — tüm ayarlarıyla tek bir kampanya ya da toplu kurulum: birkaç metin × birkaç bağlantı × bir kanal listesi; isterseniz ülke, konu ya da cihaz başına ayrı kampanyaya bölünür.

CPM ve bütçe değişiklikleri — seçili tüm kampanyalarda teklifi belirlemek, bir tutar ya da yüzde kadar yükseltmek veya düşürmek; bütçe eklemek, azaltmak ya da kalanı geri çekmek.

Duraklatma, sürdürme ve silme — bir seçim, bir grup ya da geçerli filtreye uyan tüm kampanyalar için.

İstatistik senkronizasyonu — gösterimler, tıklamalar, aksiyonlar, harcama, CTR ve CPM her kampanya için saatte bir saklanır.

Metin, başlık ve medya düzenleme — toplu olarak, kampanyaları yeniden oluşturmadan.

Bakiye takibi — ana sayfa her hesabı bakiyesiyle ve aktif, incelemede, reddedilmiş ve durdurulmuş kampanya sayılarıyla listeler; veriler her senkronizasyonda yenilenir.

Veri dışa aktarma ve raporlama

Panel, tek bir istatistik sekmesinin gösterdiğinden daha fazla geçmiş tutar ve bunu dışarı almanıza izin verir:

Excel, CSV ve PDF dışa aktarma — seçtiğiniz sütunlarla bir veri dosyası ya da bir PDF raporu; bütün bir hesap, tek bir grup ya da seçili kampanyalar için. Pro ve Agency planlarında.

Saatlik performans verisi — kampanya başına saatte bir anlık görüntü, 30 gün saklanır; daha uzun dönemler günlük toplamları kullanır. Hesaplar genelinde günün saatine göre bir ölçümümüz yok; kendi saatlerinizi bulmak için kendi kampanyalarınızın saatlik grafiğini kullanın.

Tüm hesapların analitiği — Analitik sayfası, erişiminiz olan her hesabın gösterimlerini, tıklamalarını ve aksiyonlarını toplar. Harcama para birimine göre ayrı kalır: euro, TON ve Stars hiçbir zaman toplanmaz.

Değişiklik geçmişi — bir kampanyadaki her durum, teklif ve bütçe değişikliği, onu kimin ya da neyin yaptığıyla birlikte kaydedilir; kurallar ve Auto CPM dahil.

Otomasyon kancaları

Kurallar ve otomatik işlemler her saatlik senkronizasyondan sonra, ekranın başında kimse olmadan çalışır:

IF/THEN kuralları — gösterim, tıklama, aksiyon, CTR, CVR, harcama, CPC, CPA, CPM ve bütçe üzerine koşullar; her biri tüm zamanlar ya da son 1–168 saat üzerinden ölçülür. İşlemler: duraklat, etkinleştir, CPM’i belirle, CPM’i bir tutar ya da yüzde kadar yükselt veya düşür, bütçe ekle ya da azalt, veya yalnızca bildir. Örnek: son 6 saatte CPM €2,50’nin üzerindeyse teklifi %15 düşür. Bir kural tek bir kampanyaya, bir gruba, bir seçime ya da bütün hesaba bağlanabilir.

Kendi dönüşümleriniz üzerine kurallar — tracker’ınız postback göndermeye başladığında aynı motor lead’ler, dönüşümler, satın almalar, gelir, ROAS, lead başına ve satış başına maliyet üzerinden de çalışır. Postback göndermeyen bir hesabı böyle bir kural asla duraklatmaz: veri yokluğu sıfır olarak değil, bilinmeyen olarak ele alınır.

Hesaplar arası kural taslakları — kaydedilen bir taslak ADSLY girişinizde durur; Hesaplara uygula (Apply to cabinets) onu işaretlediğiniz her hesaba kopyalar.

Auto CPM — panel saatte bir, reklamın hedeflediği kanallarda ve botlarda gerçekten gösterilip gösterilmediğini kontrol eder. Çoğunda gösteriliyorsa teklif %10 düşer; çoğunda gösterilmiyorsa %10 yükselir. Üst üste aynı sonucu veren iki kontrol gerekir; değişiklikler arasında üç saat beklenir ve kampanya başına günde en fazla altı değişiklik yapılır.

Recreate ve AI Recreate — reddedilen bir reklam otomatik olarak yeniden gönderilir; AI Recreate ile her denemede metin yeniden yazılır. Bunun için bir kurtarma yüzdesi yayımlamıyoruz.

Ajanslar için entegrasyon senaryoları

Bu parçaların mümkün kıldığı dört kurulum:

Müşteri raporlaması — müşteri hesabı ya da grup başına bir PDF veya Excel dosyası dışa aktarın, ya da /v1/stats verisini zaten kullandığınız raporlama aracına çekin.

Uyarılar — bildir işlemli bir kural saatlik özete düşer; özet Telegram’a, e-postaya ya da uygulama içine gelir. Kendi sistemleriniz için status_change webhook’u, bir kampanya Declined, Active ya da başka bir duruma geçtiğinde tetiklenir.

Özel panolar — /v1/stats/total hesap başına toplamları ve grafik noktalarını döndürür; tipik bir senkronizasyon üç-dört istektir, bir anahtarın izin verdiği dakikada 60 isteğin çok altında.

Tracker ile döngüyü kapatmak — lead’leri ve satışları postback endpoint’ine gönderin; kampanya tablosu Telegram’ın kendi sütunlarının yanında lead ve satış başına maliyeti gösterir. Panelde Keitaro, RedTrack, Binom ve Voluum için yapıştırmaya hazır postback şablonları vardır.

ADSLY REST API ve webhook’lar

API, Pro ve Agency hesapları için yayındadır. Menüden API’yi açın, + Yeni anahtar (+ New key) düğmesine basın ve anahtarın hangi hesaplara erişeceğini — tek hesap, birkaç hesap ya da hepsi — ve kampanya yönetip yönetemeyeceğini seçin. Aynı anda en fazla beş anahtar aktif olabilir.

Temel URL: https://app.adsly.pro/api/v1 · Kimlik doğrulama: X-API-Key başlığı · Hız sınırı: anahtar başına dakikada 60 istek

Her anahtar şunları okuyabilir:

• GET /v1/account/info — bu anahtarın görebildiği hesaplar

• GET /v1/campaigns — metrikleriyle kampanyalar; duruma, başlığa, bot ya da kanal kullanıcı adına, açılış sayfası alan adına ve reklam türüne göre filtreler; cursor ile sayfalama

• GET /v1/stats — bir dönem için kampanya bazında istatistikler, hesaba göre gruplanmış

• GET /v1/stats/total — hesap başına toplamlar ve grafik noktaları

• GET /v1/stats/analytics — en iyi kampanyalarla dönem analitiği

• GET /v1/campaigns/:adId/history — bir dönem boyunca tek bir kampanya

• GET /v1/conversions — postback ile alınan dönüşümler, kampanya bazında

Kampanyaları yönet (Manage campaigns). Bu seçeneği açmadığınız sürece anahtar yalnızca okur. Açtığınızda anahtar ayrıca kampanya oluşturur (çağrı başına 100’e kadar), metni, linki, CPM’i ve günlük limiti düzenler, duraklatır ve yeniden başlatır, bütçe ekler ya da kalanı geri çeker, kopyalar, tek seferde 1.000’e kadar kampanyada toplu işlem yapar, siler ve medya yükler. Hiçbir anahtar hesaptan para çekemez: bütçe yalnızca hesap bakiyesi ile o hesabın kampanyaları arasında hareket eder. API üzerinden yapılan her değişiklik paneldeki kampanya geçmişinde görünür; oluşturma, bütçe, kopyalama ve toplu işlem çağrıları Idempotency-Key kabul eder, yani zaman aşımından sonra tekrar denemek işlemi iki kez çalıştırmaz.

Tam dokümantasyon adsly.pro/docs/api adresinde (İngilizce); her sayfanın Markdown sürümü ve yapay zekâ asistanları için bir llms.txt dizini de orada.

İlk entegrasyonlarda iki şey tökezletir. Parasal alanlar (spent, budget, cpm, cpc, cpa, ctr) hassasiyeti korumak için metin olarak gelir; hesap yapmadan önce sayıya çevirin. Ve ad_id yalnızca tek bir hesabın içinde benzersizdir — Telegram kimlikleri yeniden kullanır — bu yüzden onu her zaman account_id ile birlikte saklayın.

Webhook’lar. Bir anahtara Postback URL girin; ADSLY o adrese imzalı JSON gönderir: senkronizasyonda bir kampanyanın durumu değiştiğinde status_change, her saat başından beş dakika sonra da az önce kapanan saat için kampanya bazında gösterim, tıklama, harcama ve aksiyonları içeren hourly_digest. Her istekte X-Adsly-Signature başlığında bir HMAC-SHA256 imzası, bir zaman damgası ve benzersiz bir teslimat kimliği bulunur. Endpoint herkese açık HTTPS olmalıdır; başarısız bir teslimat bir kez yeniden denenir.

Gelen dönüşümler. Bir anahtarda Postback al (Receive postbacks) seçeneğini açın; ardından ya backend’inizden anahtarı başlıkta göndererek POST /v1/postback çağırın ya da Tracker URL’si oluştur (Generate tracker URL) ile üretilen yalnızca yazılabilir URL’yi tracker’ınıza verin. Olaylar lead, conversion ve purchase’tır; tutar ve para birimi isteğe bağlıdır. Tek bir isteğe 1.000 olay sığar ve bir anahtar saniyede 20 olay kabul eder. Bir olay, reklamın bağlantısında taşınan değerle kampanyasına eşlenir: bot reklamlarında ?start= parametresi, web sitesi reklamlarında tracker’ınızın parametresi.

Güvenlik ve erişim

Bu hesaplarda gerçek bütçeler duruyor; bu yüzden her yüzey bilerek dar tutuldu:

Parola değil, oturum — bir Telegram Ads hesabı, Telegram’da bir isteği onaylayarak, tarayıcı uzantısıyla ya da bir oturum token’ıyla bağlanır. Bağlantı reklam hesabını kapsar, kişisel Telegram’ınızı değil.

Varsayılan olarak salt okunur, hash’lenmiş anahtarlar — bir anahtar, sahibi Kampanyaları yönet seçeneğini açana kadar yalnızca okur; açıldığında bile hesaptan para çekemez. Anahtarlar SHA-256 hash’i olarak saklanır; kaybolan bir anahtar geri getirilemez, yalnızca iptal edilip yenisiyle değiştirilir.

İmzalı webhook’lar — HMAC imzasını doğrulayın ve zaman damgası beş dakikadan eski olan istekleri reddedin. ADSLY, HTTPS olmayan, loopback ya da özel adreslere teslimat yapmaz.

Hesap bazında ekip erişimi — Agency planında her ekip üyesi her hesap için Viewer, Manager ya da erişimsiz olarak ayarlanır. Üyeler kendi API anahtarlarını oluşturur ve bir anahtar yalnızca o üyeyle paylaşılan hesaplara erişir: üyenin Viewer olduğu hesaplarda salt okunur, Manager olduğu hesaplarda değişiklik yapabilir.

Telegram Ads iş akışınızı otomatikleştirin. ADSLY 500,000+ kampanyayı yönetir — ve Euro hesabı her ülke için açılır. Üç hesap türünün hepsi (TON, Euro, Stars). IF/THEN kuralları, toplu işlemler, istatistik ve kampanya yönetimi için API, webhook’lar ve dışa aktarma. Ücretsiz başlayın — 3 günlük Pro deneme →

Sık Sorulan Sorular

Herkese açık bir Telegram Ads API’si var mı?

Reklamverenler için yok. Telegram’ın geliştirici sitesi Bot API’yi, istemci API’sini, TDLib’i, bir Gateway API’yi ve bir Payments API’yi listeliyor (Ekim 2026’da kontrol edildi); hiçbiri reklam kampanyalarını yönetmiyor, Sponsored Messages bölümü ise reklam gösteren uygulamalar için. ads.telegram.org’daki reklam platformu web arayüzünden yönetilir. ADSLY onun üzerinde, yetkili bir oturum aracılığıyla çalışır.

ADSLY, Telegram Ads hesabıma nasıl bağlanır?

Reklam hesabının sahibi olan Telegram hesabının oturumu üzerinden. Telefon numaranızı girdikten sonra Telegram’da bir isteği onaylarsınız, tarayıcı uzantısını kullanırsınız ya da oturum token’ını yapıştırırsınız. İstek yalnızca reklam hesabını bağlar. Euro, TON ve Stars hesaplarının hepsi böyle bağlanır; Adstat kaynaklı hesaplar bir Adstat girişiyle bağlanır.

Telegram Ads verilerim ADSLY’de güvende mi?

Entegrasyon yüzeyleri tasarım gereği dardır. API anahtarları siz Kampanyaları yönet seçeneğini açmadıkça yalnızca okur, hiçbir zaman hesaptan para çekemez ve hash olarak saklanır; API ile yapılan her değişiklik kampanya geçmişine yazılır; webhook’lar anahtara özel bir sırla imzalanır ve yalnızca herkese açık HTTPS endpoint’lerine gider; yalnızca yazılabilir tracker URL’si dönüşüm gönderebilir ama hiçbir şey okuyamaz; Agency planında ise erişim hesap ve kişi bazında verilir.

Telegram Ads verilerini Google Sheets’e aktarabilir miyim?

Doğrudan bir Google Sheets bağlayıcısı yok. Panelden bir CSV ya da Excel dosyası dışa aktarıp içe aktarın, ya da API’yi bir betikten okuyun — /v1/stats her dönem için kampanya bazında rakamları döndürür.

ADSLY, Telegram Ads için webhook destekliyor mu?

Evet. Postback URL’si olan bir anahtar, bir kampanyanın durumu her değiştiğinde status_change, saatte bir de kampanya bazında gösterim, tıklama, harcama ve aksiyonlarla hourly_digest alır. İkisi de HMAC-SHA256 ile imzalanır; anahtardaki Test düğmesi alıcınızı kontrol edebilmeniz için bir ping gönderir.

ADSLY REST API şu anda kullanılabilir mi?

Evet, Pro ve Agency planlarında; anahtarları panelde kendiniz oluşturursunuz. Her anahtar hesap listesini, kampanyaları, istatistikleri, analitiği, kampanya geçmişini ve alınan dönüşümleri okur; anahtar başına dakikada 60 istek. Kampanyaları yönet seçeneği açık bir anahtar ayrıca kampanya oluşturur, düzenler, duraklatır, yeniden başlatır, bütçe yükler, kopyalar, siler ve medya yükler. Dokümantasyon: adsly.pro/docs/api.