Telegram gruba bot ekleme: kurulumu bozmadan dogru sekilde nasil yapilir

Botu eklemek kolaydir. Dogru kurulum asil meseledir.

Telegram bot rehberlerinin cogu cok erken biter.

@BotFather ile bot olusturmayi, token kopyalamayi ve boti gruba eklemeyi anlatirlar. Bu kisim gerekli ama genelde sorunlar burada baslamaz.

Sorunlar daha sonra gelir:

• bot net bir amac olmadan eklenir;
• gerektiginden fazla admin yetkisi verilir;
• privacy mode yanlis anlasilir;
• sadece /start test edilir, gercek grup akisi test edilmez;
• botun neyi otomatiklestirecegi ve neyin ekipte kalacagi tanimlanmaz.

Bir topluluk, musteri grubu, destek alani veya ucretli grup yonetiyorsaniz bu tur kurulumlar hizla operasyonel yuk yaratir.

Resmi kaynaklar ne diyor

Resmi Telegram Bots dokumantasyonu, botlarin mesajlari otomatik olarak islemek icin tasarlanmis ozel hesaplar oldugunu aciklar. Bot API ise su iki noktayi netlestirir:

• yeni botlar @BotFather uzerinden olusturulur;
• guncellemeler long polling veya webhook ile alinabilir.

Resmi Telegram FAQ sayfasi da bot olusturmak icin @BotFather'a yonlendirir.

Burada uc farkli seyi ayirmak gerekir:

• bot hesabini olusturmak;
• boti gercek bir mantiga baglamak;
• grupta dogru erisim seviyesini vermek.

Ucune de ihtiyaciniz var.

Adim 1: Botun gercek gorevini belirleyin

Olusturmadan once botun ne yapacagini yazin:

• yeni uyeleri karsilamak;
• onboarding gondermek;
• sik sorulari yanitlamak;
• spam veya yasakli kelimeleri moderasyon etmek;
• odeme ya da abonelik durumunu kontrol etmek;
• ucretli topluluklara erisimi otomatiklestirmek;
• uyari, hatirlatma veya ozet gondermek.

Bu karar basit gorunur ama sonraki her adimi etkiler.

Bot sadece komutlara cevap verecekse admin yetkisine bile ihtiyaci olmayabilir.

Spam silmesi, katilim isteklerini yonetmesi, uyeleri cikarmasi veya premium erisimi kontrol etmesi gerekiyorsa izinler hassas bir konu haline gelir.

Adim 2: BotFather ile botu olusturun

Telegram'da @BotFather aratin.

Sonra:

1. @BotFather ile sohbet baslatin.
2. /newbot gonderin.
3. Gorunen bir isim secin.
4. Sonu bot ile biten bir kullanici adi secin.
5. API token'ini guvenli bir yerde saklayin.

Bu token, uygulamanizin bot olarak hareket etmesini saglayan kimlik bilgisidir. Bunu paylasilan dokumanlara veya daginik ekip sohbetlerine birakmayin.

Token sizarsa @BotFather uzerinden yenileyin.

Adim 3: Botu gercek bir mantiga baglayin

Botu olusturmak tek basina onu kullanisli yapmaz.

Botun ne yapacagini soyleyen bir sistem gerekir. Bu sistem su olabilir:

• kendi backend'iniz;
• barindirilan bir otomasyon;
• kullanim senaryosu Telegram grup operasyonlariyla ilgiliyse Metricgram gibi bir urun.

Bot API iki update modeli sunar:

• test ve kucuk kurulumlar icin daha basit olan long polling;
• production otomasyonu icin daha uygun olan webhook.

Telegram dokumantasyonu, webhook URL'sinde gizli bir path kullanilmasini onerir.

Bir cok ekip burada gereksiz yere fazla sey insa eder. Ozel bir bot gelistirmeye calisirlar ama gercek ihtiyac cogu zaman daha sadedir:

• dogru kisileri iceri almak;
• artik orada olmamasi gerekenleri cikarmak;
• onboarding'i otomatiklestirmek;
• erisimi odeme durumuyla senkron tutmak.

Adim 4: Botu dogru Telegram alanina ekleyin

Simdi botu calisacagi grup ya da kanala ekleyin.

Cogu ekip icin bu bir gruptur. Bazen de bagli tartisma grubuna sahip bir kanal olabilir.

Grup icinde:

1. Grup profilini acin.
2. Uye ekle veya Yoneticiler alanina girin.
3. Bot kullanici adini aratin.
4. Normal bir hesap gibi ekleyin.

Bu noktada butun izinleri varsayilan olarak vermeyin.

Bot, 1. adimda tanimladiginiz gorev icin gereken minimum erisime sahip olmalidir.

Adim 5: Privacy mode'u anlayin

Bu en yaygin kurulum hatalarindan biridir.

Bir bot gruptaki tum mesajlari varsayilan olarak gormez. Resmi bot dokumantasyonu, privacy mode'un gruplarda bota gelen guncellemeleri sinirladigini aciklar. Privacy mode acikken bot genelde su verileri alir:

• / ile baslayan komutlar;
• botun kendi mesajlarina verilen yanitlar;
• servis mesajlari;
• botlarla uyumlu acik etkilesimler.

Bu yuzden bot bazen "calismiyor" gibi gorunur, ama aslinda privacy mode kurallarina uyuyordur.

Botun daha genis grup aktivitesini okuması gerekiyorsa @BotFather uzerinden bu modu kapatmak veya akisi acik komutlar ve olaylar etrafinda tasarlamak gerekebilir.

Bunu aliskanliktan kapatmayin. Sadece kullanim senaryosu gerektiriyorsa yapin.

Adim 6: Yalnizca gerekli admin yetkilerini verin

Telegram admin haklarini parca parca ayirir. Resmi chatAdminRights referansi; mesaj silme, kullanici yasaklama, mesaj sabitleme ve diger yonetim yetkilerini ayri ayri tanimlar.

Bu nedenle "boti admin yap" yeterli bir karar degildir.

Dogru sorular sunlardir:

• mesaj silmesi gerekiyor mu;
• kullanici yasaklamasi gerekiyor mu;
• uye davet etmesi gerekiyor mu;
• mesaj sabitlemesi gerekiyor mu;
• katilim isteklerini yonetmesi gerekiyor mu.

Ornekler:

• bir SSS botunun admin yetkisine ihtiyaci olmayabilir;
• anti-spam botu silme ve yasaklama yetkisi isteyebilir;
• premium erisim botu davet veya uyelikle ilgili haklara ihtiyac duyabilir;
• destek ya da analitik botu sadece komutlarla calisabilir.

Gerektiginden fazla yetki vermek kotu pratiktir. Token sizarsa veya akista hata olursa kucuk bir hata daha buyuk bir probleme donusebilir.

Adim 7: Gercek akisi test edin

/start ozel sohbette calisiyor diye bot hazir sayilmaz.

Gercek akisi test edin:

1. Test kullanicisi ile gruba girin.
2. Ana komutu veya onboarding akisini tetikleyin.
3. Botun gormesi gereken seyi gorup gormedigini kontrol edin.
4. Moderasyon, davet veya erisim eylemlerinin gercekten calistigini dogrulayin.
5. Bir izin eksik oldugunda ne oldugunu kontrol edin.
6. Bir kullanicinin erisimi kaldirilmasi gerektiginde ne oldugunu test edin.

Bir cok ucretli topluluk tam burada kurulumlarinin yari yolda kaldigini fark eder.

Yaygin hatalar

En yaygin hatalar teknik degil, operasyoneldir:

• tek botu cok fazla farkli is icin kullanmak;
• riski dusunmeden tam admin yetkisi vermek;
• privacy mode'u yanlis yorumlamak;
• token sahibini dokumante etmemek;
• sadece girisi dusunup cikisi unutmak;
• gercek ihtiyac erisim otomasyonu iken ozel bot gelistirmek.

Metricgram nerede devreye girer

Metricgram, bot tek basina urun degil de daha buyuk bir operasyonun parcasi oldugunda anlam kazanir.

Ozellikle su durumlarda:

• Telegram'i Stripe tabanli aboneliklerle baglamak;
• giris ve cikislari otomatiklestirmek;
• manuel davet linki takibi olmadan onboarding yapmak;
• premium veya musteri topluluklarinda moderator yukunu azaltmak;
• biri iptal ettiginde ucretli grubu temiz tutmak.

Bu senaryoda bot onemlidir. Ama asil deger botun etrafindaki operasyon sistemindedir.

Sonuc

Telegram'a bot eklemek kolaydir.

Asil mesele, dogru boti dogru izinlerle eklemek ve topluluk buyudugunde de calismaya devam edecek bir akis kurmaktir.

Aksi halde bot, adminlerin her gun takip etmek zorunda kaldigi bir araca donusur.