QUICK_INTEGRATION_GUIDE.md•2.99 kB
# 🚀 Быстрая интеграция Telegram Bot для автоматизации
## Краткое описание
Создана система публикации торговых сигналов в Telegram каналы через Bot API.
---
## 📁 Ключевые файлы
- **`mcp_server/telegram_bot.py`** - основной модуль (класс `TelegramBot`)
- **`send_post.py`** - пример отправки на русском
- **`send_post_en.py`** - пример отправки на английском
---
## 🔑 Конфигурация
```python
BOT_TOKEN = "8003689195:AAGxQsopKvlLS34H2TZ0S1a0K7s4yV4iOBY"
DEFAULT_CHANNELS = [
"-1003382613825", # DIAMOND HEADZH
"-1003484839912", # Hypov Hedge Fund (AI Signals)
]
```
---
## 💻 Минимальный пример использования
```python
import asyncio
from mcp_server.telegram_bot import TelegramBot
async def publish_signal(symbol, entry, sl, tp, rr):
bot = TelegramBot("8003689195:AAGxQsopKvlLS34H2TZ0S1a0K7s4yV4iOBY")
message = f"""<b>⚡ TRADING SIGNAL</b>
<b>📊 {symbol}</b>
<b>Entry:</b> ${entry}
<b>Stop-Loss:</b> ${sl}
<b>Take-Profit:</b> ${tp}
<b>Risk/Reward:</b> {rr}"""
channels = ["-1003382613825", "-1003484839912"]
for chat_id in channels:
await bot.send_message(chat_id, message, parse_mode="HTML")
await bot.close()
# Использование:
asyncio.run(publish_signal("ZEN/USDT", 15.89, 13.58, 20.52, "1:2.0"))
```
---
## 🔌 API методы
### `TelegramBot.send_message(chat_id, text, parse_mode="HTML")`
Отправляет сообщение в канал/группу.
**Параметры:**
- `chat_id` (str) - ID канала (отрицательное число)
- `text` (str) - Текст сообщения (HTML поддерживается)
- `parse_mode` (str) - "HTML" или "Markdown"
**Пример:**
```python
await bot.send_message("-1003382613825", "<b>Текст</b>", parse_mode="HTML")
```
---
## 📝 Формат сообщений
Используется HTML форматирование:
- `<b>текст</b>` - жирный
- `<code>код</code>` - моноширинный
- Эмодзи для визуального разделения
---
## ⚠️ Важные моменты
1. **Все функции async** - используйте `await`
2. **Закрывайте сессию** - вызывайте `await bot.close()`
3. **HTML форматирование** - по умолчанию используется HTML
4. **Обработка ошибок** - система автоматически пробует без форматирования при ошибке
---
## 📦 Зависимости
Уже установлены:
- `aiohttp>=3.9.0`
- `loguru>=0.7.0`
---
## 🔗 Полная документация
См. `TELEGRAM_BOT_INTEGRATION.md` для детальной информации.