Maks'ta bir gruba veya kanala botu hızlıca nasıl eklersiniz?

Kerem Aydın·6 Temmuz 2026·⏱3 dk

Kısaca özetlemek gerekirse: Botu Maks panelinde kaydedin, token veya kullanıcı adını alın, botu ilgili gruba/kanala davet edin veya ekleyin ve gerekli yetkileri verin (kanalda yayın yapmak için yönetici rolü gerekir). Ardından webhook veya polling ayarlarını yapıp çalışmayı test edin.

Hazırlık: Botu kaydetme ve erişim bilgilerini alma

  1. Maks uygulamasında/panelinde "Botlar" veya "Geliştiriciler" bölümünü açın.
  2. Yeni bir bot oluşturun: Ad, kullanıcı adı ve açıklama girin.
  3. Alınan token'ı (API anahtarı) kaydedin — bu, mesaj göndermek ve webhook ayarlamak için gereklidir.
  4. İsteğe bağlı olarak: Push bildirimleri planlıyorsanız webhook URL'sini ve test Redirect/Callback adresini belirtin.
  5. Gizlilik ayarlarını kontrol edin: Botun grup sohbetindeki tüm mesajları görmesini istiyorsanız ilgili seçeneği etkinleştirin (genellikle "Tüm mesajları al" olarak adlandırılır).

Webhook yoksa sunucuda polling kullanın (API'ye periyodik istekler). Basit testler için önce botla özel sohbette çalışın.

Bota gruba nasıl eklenir?

  1. Grubu açın ve "Davet Et" veya "Üye Ekle" seçeneğine tıklayın.
  2. Botun kullanıcı adını girin (veya listeden seçin) ve eklemeyi onaylayın.
  3. Bot gelen mesajlara tepki verecekse ihtiyaçlarınıza göre "mesajları okuma"/"mesaj gönderme" yetkilerini verin.
  4. Komutlar ve yönetimsel işlevler için botu yönetici olarak atayın ve gerekli izinleri işaretleyin (mesaj yönetimi, sabitleme, silme).
  5. Test edin: Gruba /start@kullaniciadi gibi bir komut veya basit bir mesaj gönderin — botun aldığını ve/veya yanıt verdiğinden emin olun.

Bot gruptaki mesajları görmüyorsa botun gizlilik ayarlarını (sadece kişisel sohbetlere ayarlanmış olabilir) ve yönetici yetkilerini kontrol edin.

Bota kanala nasıl eklenir (mesaj yayınlaması için)?

  1. Kanal ayarlarını açın → "Yöneticiler" → "Yönetici Ekle".
  2. Kullanıcı adına göre botu bulun ve yönetici olarak ekleyin.
  3. Yetkileri verin: Görevlere bağlı olarak "Yayınla" (Kanal olarak gönder) ve/veya "Mesajları düzenle". Yönetici rolü olmadan bot genellikle yayın yapamaz.
  4. Bot API üzerinden çalışıyorsa kanal ID'sini öğrenin (isteklerde gerekli olacaktır) ve kanala mesaj göndermek için bot token'ını kullanın.
  5. Yayını test edin: API veya arayüz üzerinden test mesajı gönderin.

Çalışma ve ayarların hızlı kontrolü

  • Token'ın kesilmediğinden ve doğru kullanıldığından emin olun.
  • Sunucu/webhook günlüklerinde hata olup olmadığını kontrol edin (401/403 — token/erişim sorunları, 404 — yanlış endpoint).
  • Önce özel sohbette deneyin, ardından gruba/kanala taşıyın.

Sık yapılan hatalar

  • Yanlış token: Bot yanıt vermez, 401 döner.
  • Kanalda yönetici yetkisi eksik → Bot yayın yapamaz.
  • Botun gizlilik ayarları gruplarda mesaj okumayı yasaklıyor.
  • Yanlış kanal ID'si veya grup özel — davetiye/bağlantı gerekiyor.
  • Webhook yanlış yapılandırılmış (yanlış URL veya doğrulanmamış SSL).

SSS

  • Bot özel bir gruba eklenebilir mi?
    Evet — bir üye tarafından davet edilerek veya bağlantı ile; grup kapalıysa yönetici botu manuel olarak davet etmelidir.
  • Bota yönetici yetkisi vermek gerekir mi?
    Kanalda yayın yapmak ve bazı moderasyon işlevleri için evet. Basit bildirimler için mesaj gönderme yetkisi yeterlidir.
  • Botu hızlıca nasıl test edebilirim?
    Botla kişisel sohbeti ve API'ye istek gönderen basit bir betik kullanın (veya geçici olarak polling'i etkinleştirin).

Gerekirse, tam Maks paneline bağlı olarak API istek örnekleri veya yönetici izin şablonu sağlayabilirim — lütfen arayüzü veya ayarların ekran görüntülerini belirtin.