Telegram Bot Reference

Commands (14 komut)

v1 Komutlar

Command	Description
/start	Ana menu
/status	Sistem durumu
/manual	Manuel icerik
/stats	Analytics ozeti
/next	Siradaki icerik
/schedule	Haftalik takvim
/sync	Insights sync
/prompts	Prompt istatistikleri

v2 Komutlar

Command	Description
/pool	Icerik firsati havuzu durumu
/brain	Brain Agent son kararlari ve durumu
/feeds	Feed aggregator durumu
/pause	Sistemi duraklat (Brain + uretim)
/resume	Sistemi devam ettir
/force	Belirli firsati hemen uret (opp_id + type)

Main Menu

[Gunluk Icerik] [Reels]
[Carousel] [Otonom]
[Siradaki] [Analytics]
[Sync] [Yardim]

Key Callbacks

Callback	Action
start_daily	Gunluk pipeline
create_reels	Reels pipeline
approve_topic	Konu onayla
approve_content	Icerik onayla
approve_visual	Gorsel onayla
publish_now	Hemen yayinla
regenerate_*	Yeniden uret
cancel	Iptal

Approval Flow

1. Topic → [Onayla] [Baska Oner] [Iptal]
2. Content → [Onayla] [Yeniden Yaz] [Iptal]
3. Visual → [Onayla] [Yeniden Uret] [Iptal]
4. Final → [YAYINLA] [Zamanla] [Iptal]

v2 Integration

# main.py'de v2 bilesenleri Telegram modülüne set edilir:
import app.telegram_pipeline as telegram_pipeline_mod
telegram_pipeline_mod.brain_agent = brain
telegram_pipeline_mod.feed_aggregator = aggregator

# /brain komutu
decisions = brain.get_last_decisions(limit=5)

# /force komutu
result = await brain.force_produce(opp_id=42, content_type="reels")

Pipeline Integration

pipeline.set_approval({
    "action": "approve_topic",
    "edited_topic": "...",  # optional
    "feedback": "..."       # optional
})

Send Message

await update.message.reply_text("*Bold*", parse_mode="Markdown")

# With buttons
keyboard = [[InlineKeyboardButton("OK", callback_data="ok")]]
await update.message.reply_text("?", reply_markup=InlineKeyboardMarkup(keyboard))

Error Handling

try:
    await bot.send_message(text, parse_mode="Markdown")
except:
    await bot.send_message(text.replace("*", ""))  # Fallback

Environment

TELEGRAM_BOT_TOKEN=...
TELEGRAM_ADMIN_CHAT_ID=...
TELEGRAM_ADMIN_USER_IDS=123,456  # Optional extra admins

Deep Links

• app/telegram_pipeline.py - Bot + 14 komut handler
• app/scheduler/pipeline.py - v1 pipeline integration
• app/agents/brain.py - Brain Agent (/brain, /force)
• app/sources/feed_aggregator.py - Feed (/feeds)