# Telegram Botları — Ana Sunucu Kurulum Dokümanı

**Hazırlanma tarihi:** 2026-10-23
**Kaynak sunucu:** `C:\xampp\htdocs\Telegram Botları` (Windows, IP 94.130.50.174)
**Kapsam:** Aktif çalışan 13 bottan, adı *"Hacked By CyberTroll"* olarak değiştirilmiş 3 tanesi hariç **10 bot**

> Bu doküman botların **yapısını ve çalışma şeklini birebir korumak** için hazırlandı.
> Hiçbir kod değişikliği gerekmez — klasörler olduğu gibi kopyalanır, aşağıdaki ortam kurulur.

---

## 1. Taşınacak botlar

| # | Telegram | Bot adı | Klasör | Komutlar |
|---|---|---|---|---|
| 1 | `@betratg_bot` | Betra Bot | `Python Telegram - Betra` | `/rapor` `/gunsonu` `/bakiye` |
| 2 | `@betrayeni_bot` | Betra Bot | `Python Telegram - Reyna TC` | `/rapor` `/kapanis` `/tc` + `!tc` |
| 3 | `@fiksturtc_bot` | Fikstür Bot | `Python Telegram - Fikstur` | `/btag` `/tc` |
| 4 | `@maximtc_bot` | Maxim TC bot | `Python Telegram - Fikstur - Copy` | `/btag` `/tc` |
| 5 | `@hanedantel_bot` | Hanedan Bot | `Python Telegram - Istinye Telefon - Kopya` | `/tel` |
| 6 | `@hanedantg_bot` | Hanedan Bot | `Python Telegram - Hanedan - Kopya` | `/kontrol` ⚠️ webhook |
| 7 | `@istinyetc_bot` | GO Bot | `Python Telegram - Istinye TC` | `/rapor` `/kapanis` `/tc` + `!tc` ⚠️ webhook |
| 8 | `@jeweltg_bot` | Opera Bot | `Python Telegram - Jewel` | `/rapor` `/gunsonu` `/tc` `/ozet` |
| 9 | `@kaletg_bot` | Kale Bot | `Python Telegram - Betra TC - Copy - Copy` | `/rapor` `/gunsonu` `/tc` |
| 10 | `@meritrc_bot` | Merit Bot | `Python Telegram - Merit` | `/rapor` `/gunsonu` `/tc` ⚠️ webhook |


### Token listesi

| Telegram | Klasör | `sorgu.py` satırı | Token |
|---|---|---:|---|
| `@betratg_bot` | `Python Telegram - Betra` | 23 | `6756846757:AAFfohn9u1NCiaWzWQuHs4ZOR2uH3qcGHvA` |
| `@betrayeni_bot` | `Python Telegram - Reyna TC` | 47 | `8751169273:AAFweyCHWJiYkKGuC8m-fPHgU7lA1_PlrFE` |
| `@fiksturtc_bot` | `Python Telegram - Fikstur` | 79 | `8905492287:AAHT_pQA583CwhjXA91hIfeh3kdOnwwfBMY` |
| `@maximtc_bot` | `Python Telegram - Fikstur - Copy` | 79 | `8609624098:AAEceuLTteg36M9gJHZ1vrUbsiA4fzQ5POM` |
| `@hanedantel_bot` | `Python Telegram - Istinye Telefon - Kopya` | 147 | `8484233300:AAGnbEwSy5bGBB1BJTm83R8zYUr-nUfMyKw` |
| `@hanedantg_bot` | `Python Telegram - Hanedan - Kopya` | 92 | `7824807718:AAFp-BCyP2-odXxbug4jy83534QjWf8siNU` |
| `@istinyetc_bot` | `Python Telegram - Istinye TC` | 47 | `7898800936:AAE8cShKlZE3nyQqtMfcLvHcltr8S1OqQYU` |
| `@jeweltg_bot` | `Python Telegram - Jewel` | 125 | `7465549518:AAF6OEVIV7PY0TkyXwBTkQ2asqPxgxu4-98` |
| `@kaletg_bot` | `Python Telegram - Betra TC - Copy - Copy` | 36 | `8036839379:AAGLgXbKOE570RXxHAzRuZsRhGlx9iIn1BE` |
| `@meritrc_bot` | `Python Telegram - Merit` | 36 | `7572062852:AAEM3ruMjheKCkOC9E84ax3rKQSwR26PNKQ` |

> Bu dosya **canlı token içerir**. Paylaşılan klasöre, e-postaya veya sürüm kontrolüne koymayın.
> Bölüm 7'deki `/revoke` adımından sonra bu tablodaki değerler geçersiz olur; yenileriyle güncelleyin.

**Klasör adları bot adlarıyla uyuşmuyor** (tarihsel sebeplerle). Tabloya göre eşleştirin, klasör adlarını **değiştirmeyin** — başlatıcı betikler klasör adına göre çalışır.

### Taşınmayan 3 bot

`@casinoburadafs_bot` · `@casinoburadatg_bot` · `@showbahistg_bot` — üçünün de adı **"Hacked By CyberTroll"** olarak değiştirilmiş. Bot adını yalnızca BotFather üzerinden sahibi hesap değiştirebilir. Taşımadan önce hesap güvenliği ele alınmalı (bkz. bölüm 7).

---

## 2. Çalışma ortamı

### Python

```
Python 3.14.2  (Windows x64)
Kurulum yolu : C:\Users\admin\AppData\Local\Programs\Python\Python314\
```

### Paketler — sürümler birebir aynı olmalı

```bash
pip install python-telegram-bot==22.8 requests==2.34.2 aiohttp==3.14.3 APScheduler==3.11.3 psutil==7.2.2 mysql-connector-python==9.4.0
```

| Paket | Sürüm | Not |
|---|---|---|
| python-telegram-bot | 22.8 | |
| requests | 2.34.2 | |
| aiohttp | 3.14.3 | Fikstur ve Fikstur - Copy kullanır |
| APScheduler | 3.11.3 | PTB job-queue için |
| psutil | 7.2.2 | başlatıcı/süpervizör için |
| mysql-connector-python | **9.4.0 — YÜKSELTMEYİN** | 26.x sürümü botları `ACCESS_VIOLATION` (exit 3221225477) ile çökertiyor |
| httpx | 0.28.1 | PTB ile gelir |

> **mysql-connector-python kritik:** `pip list --outdated` bu paketi sürekli güncellenebilir gösterir. 26.x'e yükseltmek MySQL kullanan botları sessizce öldürür — Python traceback bırakmaz, sadece süreç kapanır. 9.4.0'da kalın.

### Klasör yapısı

Her bot klasörü şunları içerir:

```
Python Telegram - <isim>\
    sorgu.py        <- botun tamami (token kodun icinde gomulu)
    token.txt       <- KULLANILMIYOR, eski kalinti. Icerigi yanlis.
    commands.log    <- sadece bazi botlarda, calisirken olusur
```

`token.txt` dosyalarının **hepsi aynı ve geçersiz** bir token içeriyor. Hiçbir bot onu okumuyor; gerçek token `sorgu.py` içinde gömülü. Kafa karışıklığı yaratmasın diye silebilirsiniz.

---

## 3. Bot bot teknik döküm

Her botun token'ı `sorgu.py` içinde, belirtilen satırda `.token("...")` biçiminde.

### 1 — `@betratg_bot` → `Python Telegram - Betra`

| | |
|---|---|
| Token satırı | 23 |
| **Token** | `6756846757:AAFfohn9u1NCiaWzWQuHs4ZOR2uH3qcGHvA` |
| Bağımlılık | `requests`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/gunsonu` `/bakiye` |
| Veritabanı | yok |

```
/rapor    -> https://telegram.betra.app/anasayfa/saatlik_deposit
/gunsonu  -> https://telegram.betra.app/anasayfa/gunluksorgu
/bakiye   -> https://telegram.betra.app/anasayfa/rapor_sistemi
```

---

### 2 — `@betrayeni_bot` → `Python Telegram - Reyna TC`

| | |
|---|---|
| Token satırı | 47 |
| **Token** | `7898800936:AAE8cShKlZE3nyQqtMfcLvHcltr8S1OqQYU` |
| **Token** | `8751169273:AAFweyCHWJiYkKGuC8m-fPHgU7lA1_PlrFE` |
| Bağımlılık | `requests`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/kapanis` `/tc` |
| Ek tetikleyici | `MessageHandler(filters.TEXT & filters.Regex(r"^!tc\b"))` — `!tc` ile de çalışır |
| Veritabanı | yok |

```
/rapor    -> https://telegram.hepbetbonus.app/anasayfa/saatlik_deposit
/kapanis  -> https://telegram.hepbetbonus.app/anasayfa/gunluk_deposit_test
/tc       -> https://telegram.betra.app/anasayfa/tcsorgu?username={username}
```

> Dikkat: `/tc` farklı bir domaine gidiyor (`betra.app`), diğer ikisi `hepbetbonus.app`'e. Bu kasıtlı, değiştirmeyin.

---

### 3 — `@fiksturtc_bot` → `Python Telegram - Fikstur`

| | |
|---|---|
| Token satırı | 79 |
| **Token** | `8609624098:AAEceuLTteg36M9gJHZ1vrUbsiA4fzQ5POM` |
| **Token** | `8905492287:AAHT_pQA583CwhjXA91hIfeh3kdOnwwfBMY` |
| Bağımlılık | `aiohttp`, `datetime`, `telegram`, `telegram.ext` |
| Komutlar | `/btag` `/tc` |
| Özellik | Çalıştığı klasöre `commands.log` yazar |
| Veritabanı | yok |

```
/btag  -> https://fiksturbetbot.com/anasayfa/btagsorgu
/tc    -> https://fiksturbetbot.com/anasayfa/tcsorgu
```

HTTP çağrıları `aiohttp` ile **asenkron ve 10 sn zaman aşımlı** — event loop'u bloklamaz.

---

### 4 — `@maximtc_bot` → `Python Telegram - Fikstur - Copy`

Yapısı 3 numarayla birebir aynı, sadece domain farklı.

| | |
|---|---|
| Token satırı | 79 |
| Komutlar | `/btag` `/tc` |
| Çalıştığı grup | `-1003401329800` |

```
/btag  -> https://maximcasinobot.com/anasayfa/btagsorgu
/tc    -> https://maximcasinobot.com/anasayfa/tcsorgu
```

---

### 5 — `@hanedantel_bot` → `Python Telegram - Istinye Telefon - Kopya`

| | |
|---|---|
| Token satırı | 147 |
| **Token** | `8484233300:AAGnbEwSy5bGBB1BJTm83R8zYUr-nUfMyKw` |
| Bağımlılık | `asyncio`, `logging`, `re`, `requests`, `urllib.parse`, `telegram`, `telegram.ext` |
| Komutlar | `/tel` |
| Özellik | `logging` aktif — stdout'a `INFO` seviyesinde yazar |
| Veritabanı | yok |

```
/tel  -> https://hanedanbet.app/anasayfa/telegramyenibott?username={param}
```

---

### 6 — `@hanedantg_bot` → `Python Telegram - Hanedan - Kopya` ⚠️

| | |
|---|---|
| Token satırı | 92 |
| **Token** | `7824807718:AAFp-BCyP2-odXxbug4jy83534QjWf8siNU` |
| Bağımlılık | `logging`, `re`, `requests`, `urllib.parse`, `telegram`, `telegram.ext` |
| Komutlar | `/kontrol` |
| Özellik | `logging` aktif |

```
/kontrol -> https://hanedanbet.app/anasayfa/telegramyenibot?username={param}
```

> **⚠️ Bu bota webhook kurulu:**
> `https://hanedanbet.app/kb-tg?key=kb-hanedan-webhook-2026`
> Webhook varken `getUpdates` (polling) **çalışmaz**. Bölüm 5'e bakın.

---

### 7 — `@istinyetc_bot` → `Python Telegram - Istinye TC` ⚠️

| | |
|---|---|
| Token satırı | 47 |
| Bağımlılık | `requests`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/kapanis` `/tc` + `!tc` regex tetikleyicisi |

```
/rapor    -> https://telegram.istinyecasinoortaklik.com/anasayfa/saatlik_deposit
/kapanis  -> https://telegram.istinyecasinoortaklik.com/anasayfa/gunluk_deposit_test
/tc       -> https://telegram.istinyecasinoortaklik.com/anasayfa/tcsorgu?username={username}
```

> **⚠️ Webhook kurulu:** `https://telegram.grandoperabonus.com/smsbot/webhook`
> Bu bot **ayrı bir yerde** webhook ile çalışıyor. Ana sunucuda polling ile açarsanız çakışır.

---

### 8 — `@jeweltg_bot` → `Python Telegram - Jewel`

En karmaşık bot. **Dört ayrı gruba** hizmet ediyor.

| | |
|---|---|
| Token satırı | 125 |
| **Token** | `7465549518:AAF6OEVIV7PY0TkyXwBTkQ2asqPxgxu4-98` |
| Bağımlılık | `asyncio`, `datetime`, `pathlib`, `requests`, `time`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/gunsonu` `/tc` `/ozet` |
| Veritabanı | yok |

```
/rapor    -> https://telegram.grandoperabonus.com/anasayfa/saatlik_deposit
/gunsonu  -> https://telegram.grandoperabonus.com/anasayfa/gunluksorgu
/tc       -> https://telegram.grandoperabonus.com/anasayfa/tcsorgu?username=
/ozet     -> https://telegram.grandoperabonus.com/anasayfa/uye_ozet?username=
```

**Önemli davranışlar — bozulmamalı:**

- **Sadece gruplarda çalışır.** `is_group()` kontrolü var; özel mesajda hiçbir komut cevap vermez, sessizce yoksayar. Test ederken bunu unutmayın.
- **`commands.log` yazar** — her komutu tarih/kullanıcı/grup ile kaydeder, ayrıca site çağrısının HTTP sonucunu `SITE | command=... | sonuc=HTTP 200 | sure=2.2s` biçiminde loglar. Sorun ayıklamada kritik.
- **HTTP çağrıları `asyncio.to_thread(requests.get, url, timeout=120)` ile yapılır.** Bu bilinçli bir düzeltme: düz `requests.get()` event loop'u blokluyordu ve site yavaşladığında bot tamamen donuyordu. **Bu yapıyı koruyun.**

Hizmet verdiği gruplar:

| Grup ID | Ağırlıklı komut |
|---|---|
| `-1002159422959` | `/tc` |
| `-1002180460897` | `/rapor` |
| `-1002563844585` | `/rapor` |
| `-1003876191309` | `/ozet` |

---

### 9 — `@kaletg_bot` → `Python Telegram - Betra TC - Copy - Copy`

| | |
|---|---|
| Token satırı | 36 |
| **Token** | `7572062852:AAEM3ruMjheKCkOC9E84ax3rKQSwR26PNKQ` |
| **Token** | `8036839379:AAGLgXbKOE570RXxHAzRuZsRhGlx9iIn1BE` |
| Bağımlılık | `requests`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/gunsonu` `/tc` |

```
/rapor    -> https://telegram.kalebonus.com/anasayfa/saatlik_deposit
/gunsonu  -> https://telegram.grandoperabonus.com/anasayfa/gunluksorgu
/tc       -> https://telegram.kalebonus.com/anasayfa/tcsorgu?username=
```

> Dikkat: `/gunsonu` **farklı bir domaine** (`grandoperabonus.com`) gidiyor. Bu mevcut yapı, değiştirmeyin.

---

### 10 — `@meritrc_bot` → `Python Telegram - Merit` ⚠️

| | |
|---|---|
| Token satırı | 36 |
| Bağımlılık | `requests`, `telegram`, `telegram.ext` |
| Komutlar | `/rapor` `/gunsonu` `/tc` |

```
/rapor    -> https://tc.democu.online/telegram.php?daily=yes
/gunsonu  -> https://tc.democu.online/telegram.php?gunsonu=yes
/tc       -> https://tc.democu.online/telegram.php?username=
```

> **⚠️ Webhook kurulu:** `https://redlabonus.click/anasayfa/telegram_tc`

---

## 4. Ortak mimari — nasıl çalışıyorlar

Botların **tamamı aynı deseni** kullanıyor:

1. Kullanıcı gruba komut yazar
2. Bot anında bir bilgilendirme mesajı gönderir (*"Raporunuzu hazırlıyorum..."*, *"sorgulanıyor 🔍"*)
3. Bot ilgili site adresine **HTTP GET** atar
4. **Sonucu gruba site gönderir, bot değil** — bot HTTP cevabını çoğunlukla okumaz

Bu yüzden her sitenin kendi tarafında **bir bot token'ı ve chat_id ayarı** bulunur. Bot token'ı yenilediğinizde **sitedeki token'ı da güncellemeniz gerekir**, yoksa sonuç mesajları gruba ulaşmaz.

> Tek istisna: `@maximtc_bot` ve `@fiksturtc_bot`'un çağırdığı adresler sonucu HTTP gövdesinde de döndürüyor, ama kod bunu okumuyor. Sonuç yine siteden gidiyor.

---

## 5. Webhook'lu 3 bot — taşımadan önce karar verin

`@hanedantg_bot`, `@istinyetc_bot`, `@meritrc_bot`

Telegram'da bir bot **ya webhook ya polling** kullanır, ikisi birden olmaz. Bu üçünde webhook kurulu olduğu için ana sunucuda `sorgu.py` ile polling başlatırsanız bot çalışmaz.

İki seçenek:

**A) Webhook kalsın** — bu üç botu ana sunucuda çalıştırmayın. Klasör adlarının başına `KAPALI - ` ekleyin, başlatıcı atlar:

```
KAPALI - Python Telegram - Hanedan - Kopya
```

**B) Polling'e dönün** — webhook'u silin, sonra polling başlatın:

```bash
curl "https://api.telegram.org/bot<TOKEN>/deleteWebhook"
```

Bu, webhook'un bağlı olduğu entegrasyonu (örn. Istinye'deki `smsbot`) kırar. Önce o tarafın hâlâ kullanılıp kullanılmadığını doğrulayın.

---

## 6. Başlatma

### Tek bot elle

```bash
cd "C:\...\Python Telegram - Jewel"
python sorgu.py
```

### Hepsi birden — `botlar.py`

Kaynak sunucudaki `botlar.py` tüm `Python Telegram - ` önekli klasörleri tarar, önce çalışanları kapatır, sonra hepsini başlatır. Loglar `logs\<klasor>_<zaman>.log` dosyalarına yazılır.

Yeni sunucuda iki yolu güncelleyin:

```python
BASE_DIR   = r"<yeni yol>\Telegram Botları"
PYTHON_EXE = r"<yeni python yolu>\python.exe"
```

### Önerilen — `baslat.py`

`botlar.py`'nin akıllı sürümü. Bir botu başlatmadan **önce Telegram'a sorar**:

- token geçersiz mi → başlatmaz, raporlar
- başka bir kurulum aynı token'ı çekiyor mu (409 Conflict) → uyarır
- temiz mi → başlatır

Ölü tokenli botların boşuna CPU ve log yakmasını engeller.

### Kalıcılık — `supervizor.py` (şiddetle önerilir)

Kaynak sunucuda botlar düzenli olarak düşüyordu. Sebebi koddan değil **ağ kartının sürekli bağlantı kaybetmesinden** kaynaklanıyordu:

```
10-17: 126 kopma    10-20: 117 kopma
10-18: 111 kopma    10-21: 126 kopma
10-19: 108 kopma    10-22:  99 kopma
```

Her kopmada DNS çöküyor, bot logunda `httpx.ConnectError: [Errno 11001] getaddrinfo failed` görünüyor, PTB birkaç deneme sonrası pes edip süreci kapatıyor. **Ağ düzelse bile bot kendiliğinden geri gelmiyor.**

`supervizor.py` bunu çözüyor:

- 30 saniyede bir tüm klasörleri tarar, düşen botu yeniden başlatır
- Ölü tokenli botlar saniyeler içinde çöktüğü için **karantinaya** alınır (üst üste 3 hızlı ölüm → 30 dakikada bir denenir), sonsuz döngü oluşmaz
- Kilit dosyasıyla tek kopya çalışır
- Botları `DETACHED_PROCESS` ile açar — süpervizör ölse bile botlar yaşar
- Tüm olayları `supervizor_durum.log` dosyasına yazar

Süpervizörün kendisi de ölebildiği için Windows zamanlanmış görevi eklendi (5 dakikada bir + oturum açılışında):

```bash
schtasks /create /tn "TelegramBotSupervizor" /tr "C:\xampp\htdocs\telegram_bot_supervizor.bat" /sc minute /mo 5 /f
```

`.bat` içeriği (Türkçe karakterli yol `schtasks` tarafından parse edilemediği için **8.3 kısa yol** kullanıldı):

```bat
@echo off
start "" /b "C:\...\PYTHON~1\pythonw.exe" "C:\xampp\htdocs\TELEGR~1\SUPERV~2.PY"
```

Oluşan koruma zinciri:

```
Zamanlanmis gorev (5 dk)  ->  Supervizor (30 sn)  ->  Botlar
```

---

## 7. Taşımadan önce mutlaka yapılması gerekenler

### Telegram hesap güvenliği — en öncelikli

Üç botun adı **"Hacked By CyberTroll"** olarak değiştirilmiş. Bot adını yalnızca BotFather üzerinden, **botun sahibi hesap** değiştirebilir. Bu, hesaba yetkisiz erişim olduğunu gösterir.

Aynı dönemde yaşanan ve bununla tutarlı olaylar:

- 2026-08-14 12:39:56'dan itibaren 20 botta sürekli `409 Conflict` — başka bir kurulum aynı token'ları çekiyordu. Yerel sunucudaki tüm süreçler durdurulup doğrulandı: kaynak bu makine değildi.
- Yeni oluşturulan `@grandtc_bot` **18 saat içinde** ele geçirildi ve gruplara spam atmaya başladı.
- Bir bota (`@istinyetc_bot`) bizim silmemizden sonra webhook **yeniden kuruldu**.

Adımlar:

1. Telegram → **Ayarlar → Cihazlar → diğer tüm oturumları sonlandır**
2. **İki Aşamalı Doğrulama**'yı aç
3. BotFather'da taşınacak **10 botun tamamını `/revoke`** et
4. Yeni token'ları `sorgu.py` dosyalarına yaz (her botun token satırı bölüm 3'te)
5. **Sitelerdeki bot token ayarlarını da güncelle** — yoksa sonuç mesajları gruba ulaşmaz (bkz. bölüm 4)

> Hesap güvene alınmadan token yenilemek işe yaramaz; bugüne kadar olan tam olarak budur.

### Eski sunucuyu kapatın

Ana sunucuda botlar açıldıktan sonra kaynak sunucudaki kopyaları **mutlaka durdurun**. İki kurulum aynı token'ı çekerse Telegram sürekli `409 Conflict` verir ve mesajların yarısı kaybolur.

Kaynak sunucuda ayrıca iki eski kopya daha var — bunların da çalıştırılmadığından emin olun:

```
C:\Users\admin\Downloads\Telegram Botları\
C:\Users\admin\Desktop\Telegram Botları\Telegram Botları\
```

---

## 8. Kurulum adımları — özet

```bash
# 1. Python 3.14.2 kur

# 2. Paketleri kur (surumler birebir)
pip install python-telegram-bot==22.8 requests==2.34.2 aiohttp==3.14.3 APScheduler==3.11.3 psutil==7.2.2 mysql-connector-python==9.4.0

# 3. 10 bot klasorunu kopyala (klasor adlarini DEGISTIRMEDEN)

# 4. botlar.py / baslat.py / supervizor.py icindeki BASE_DIR ve PYTHON_EXE yollarini guncelle

# 5. logs klasorunu olustur
mkdir logs

# 6. Tokenleri yenile (bolum 7) ve sorgu.py dosyalarina yaz

# 7. Test: once tek bot
python "Python Telegram - Jewel\sorgu.py"

# 8. Hepsi birden
python baslat.py

# 9. Supervizoru kur ve zamanlanmis gorevi ekle
```

---

## 9. Sorun giderme — kaynak sunucuda karşılaşılanlar

| Belirti | Sebep | Çözüm |
|---|---|---|
| `409 Conflict: terminated by other getUpdates` | Aynı token'ı başka bir kurulum çekiyor | Diğer kurulumu kapatın veya `/revoke` |
| `401 Unauthorized` / `InvalidToken` | Token revoke edilmiş | BotFather'dan yeni token alın |
| `getaddrinfo failed` | DNS/ağ kesintisi | Süpervizör otomatik toparlar; ağ donanımını kontrol edin |
| Süreç traceback bırakmadan kapanıyor, exit `3221225477` | mysql-connector C eklentisi çökmesi | `use_pure: True` ekleyin, 9.4.0'da kalın |
| `UnicodeEncodeError: 'charmap' ... '\u0131'` | Log dosyası cp1252 açılmış | `FileHandler(..., encoding="utf-8")` |
| `BadRequest: Message is too long` | Site hata sayfası (HTML) kullanıcıya gönderilmeye çalışılıyor | Site cevabını 4096 karaktere kırpın |
| Bot ayakta ama hiç istek atmıyor | PTB polling döngüsü sessizce ölmüş | Yeniden başlatın; süpervizör bunu yakalar |
| Komut geliyor ama cevap yok | Site tarafındaki bot token'ı eski | Sitedeki token ayarını güncelleyin |
| Grupta hiç cevap yok | Bot gruptan çıkarılmış veya yönetici değil | Gruba ekleyin, yönetici yapın |

---

## 10. Ek notlar

- **`/start` handler'ı hiçbir botta yok.** Test ederken `/start` yazmayın, cevap gelmez. Bölüm 3'teki gerçek komutları kullanın.
- **Jewel sadece gruplarda çalışır** — özel mesajda test etmeyin.
- Bazı botlarda `except: pass` ile hatalar gizleniyor. Sorun ayıklarken bunu geçici olarak açmak gerekebilir.
- `commands.log` dosyaları büyüyebilir (kaynak sunucuda Jewel'inki 3.9 MB'a ulaştı). Periyodik arşivleme önerilir.
- Kaynak sunucudaki `bot_errors.log` dosyalarından bazıları **168 MB**'a kadar çıkmış. Yeni sunucuya kopyalamayın.
