# Telegram Bot Grup Kurulumu

## 🎮 Bot'u Gruba Ekleme ve Yapılandırma

### 1. İlk Kurulum

#### a) Kendi Telegram ID'nizi Bulun
1. Telegram'da [@userinfobot](https://t.me/userinfobot) botuna gidin
2. `/start` yazın
3. Size gelen ID numaranızı kopyalayın

#### b) Bot Kodunda Admin ID'nizi Güncelleyin
`bot.py` dosyasında şu satırları bulun ve kendi ID'nizi ekleyin:

```python
# Satır 172 ve 186 civarı
if update.effective_user.id not in [1234567890]:  # Buraya kendi Telegram ID'nizi ekleyin
```

Örnek:
```python
if update.effective_user.id not in [123456789, 987654321]:  # Birden fazla admin ekleyebilirsiniz
```

### 2. Bot'u Gruba Ekleme

1. Telegram'da bot'unuzu bulun: `@papiplay_bot`
2. Bot'un profiline girin
3. "Gruba Ekle" butonuna tıklayın
4. İstediğiniz grubu seçin
5. Bot'u grup yöneticisi yapın (opsiyonel ama önerilir)

### 3. Grup İzinlerini Ayarlama

Bot varsayılan olarak sadece izin verilen gruplarda çalışır. Bir grupta çalışması için:

#### Yöntem 1: Komutla Ekleme
1. Bot'u gruba ekledikten sonra grupta şu komutu yazın:
   ```
   /groupinfo
   ```
   Bu size grup ID'sini ve diğer bilgileri gösterecek.

2. Admin olarak grupta şu komutu yazın:
   ```
   /addgroup
   ```
   Bot otomatik olarak o grubu izin verilenler listesine ekleyecek.

#### Yöntem 2: Config Dosyasından Ekleme
1. `bot/config.json` dosyasını açın
2. `allowed_groups` dizisine grup ID'sini ekleyin:
   ```json
   "groups": {
       "active_group_id": null,
       "allowed_groups": [-1001234567890]  // Grup ID'si eksi ile başlar
   }
   ```

### 4. Bot Komutları

#### Genel Komutlar (Herkes Kullanabilir)
- `/start` veya `/papiplay` - Oyun linkini gösterir
- `/groupinfo` - Grup bilgilerini gösterir

#### Admin Komutları (Sadece Bot Adminleri)
- `/addgroup` - Grubu izin verilenler listesine ekler
- `/removegroup` - Grubu izin verilenler listesinden çıkarır

### 5. Config Ayarları

`config.json` dosyasında yapabileceğiniz ayarlar:

```json
{
    "settings": {
        "allow_private_messages": true,    // Özel mesajlara izin ver/verme
        "allow_all_groups": false,         // Tüm gruplara izin ver/verme
        "initial_credits": 5000,           // Yeni kullanıcıların başlangıç kredisi
        "token_expiry_hours": 24           // Token geçerlilik süresi (saat)
    }
}
```

### 6. Grup Değiştirme

Başka bir gruba geçmek için:

1. **Eski grubu kaldırın:**
   - Eski grupta: `/removegroup`
   - Veya config.json'dan grup ID'sini silin

2. **Yeni grubu ekleyin:**
   - Yeni grupta: `/addgroup`
   - Veya config.json'a yeni grup ID'sini ekleyin

### 7. Sorun Giderme

#### Bot komutlara cevap vermiyor
- Bot'un gruba eklendiğinden emin olun
- Bot'un mesaj okuma izninin olduğundan emin olun
- Grup ID'sinin config'e eklendiğinden emin olun

#### "Bu bot sadece izin verilen gruplarda çalışır" hatası
- `/addgroup` komutunu admin olarak çalıştırın
- Veya config.json'a grup ID'sini manuel ekleyin

#### Grup ID'sini bulamıyorum
- Grupta `/groupinfo` komutunu kullanın
- Chat ID satırındaki değer grup ID'sidir

### 8. Ubuntu Sunucuda Çalıştırma

SSH ile sunucuya bağlandıktan sonra:

```bash
cd /var/www/html/bot
python3 bot.py
```

Arka planda çalıştırmak için:
```bash
nohup python3 bot.py &
```

Veya systemd servisi olarak (önerilen):
```bash
sudo systemctl start papiplay-bot
sudo systemctl enable papiplay-bot
```

### 9. Güvenlik İpuçları

1. Bot token'ınızı kimseyle paylaşmayın
2. Admin ID'lerinizi güvenli tutun
3. Sadece güvendiğiniz gruplara bot ekleyin
4. Düzenli olarak logları kontrol edin

### 10. Mesajları Özelleştirme

`config.json` dosyasında mesajları değiştirebilirsiniz:

```json
"messages": {
    "welcome": "Hoş geldin {username}! 🎰\nOyuna başlamak için butona tıkla!",
    "error": "⚠️ Hata oluştu!",
    "not_allowed_group": "❌ Bu grup için yetki yok!",
    "button_text": "�� Oyuna Başla"
}
```