MT5'ten Telegram'a - Profesyonel Ticaret Bildirimleri Kütüphanesi - MetaTrader 5 için kütüphane

MetaTrader 5 için Telegram Bot entegrasyonunun profesyonel kütüphanesi. Telegram kanallarına ve gruplarına alım satım sinyalleri, ekran görüntüleri, raporlar ve gerçek zamanlı bildirimler göndermek için eksiksiz bir çözüm.

Ana Özellikler

• 📨 Gerçek zamanlı işlem bildirimleri - Pozisyon açma/kapama/değiştirme ile ilgili anlık uyarılar
• 📸 Grafik ekran görüntüleri - Ek açıklamalı grafikleri otomatik olarak yakala
• 📊 Hesap Raporları - Günlük, haftalık ve aylık performans raporları
• ⚠️ Risk Yönetimi Uyarıları - Düşüş, marj seviyesi ve stop-out uyarıları
• 🔄 Mesaj kuyruk sistemi - Yeniden deneme mekanizması ile güvenilir teslimat
• 👥 Çoklu kanal desteği - Birden fazla Telegram sohbetine/kanalına gönderin
• 📝 Şablon sistemi - Özelleştirilebilir mesaj şablonları
• 🎯 Akıllı hız sınırlama - API engellemesini önleme

Gereksinimler

• MetaTrader 5 sürüm 2375 veya üstü
• Telegram Bot belirteci (@BotFather'dan alın)
• Sohbet veya kanal kimliği
• İnternet bağlantısı

Kurulum

Adım 1: Bir Telegram Botu Oluşturun

1. Telegram'ı açın ve @BotFather'ı bulun
2. Komutu gönder /newbot
3. Botunuz için bir isim seçin
4. Kullanıcı adını seçin ('bot' ile bitmelidir)
5. BotFather tarafından sağlanan belirteci kaydedin

Adım 2: Bir Sohbet Kimliği Alın

1. Botu bir gruba/kanala ekleyin veya özel bir sohbet odası başlatın
2. Bot'a herhangi bir mesaj gönderin
3. Şu adrese gidin: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
4. Yanıtta sohbet kimliğini bulun

Adım 3: MT5'i Kurun

1. MT5 → Servis → Ayarlar → Uzman Danışmanlar'ı açın
2. "Aşağıdaki URL'ler için WebRequest'e izin ver" kutusunu işaretleyin
3. URL ekle: https://api.telegram.org
4. Tamam'a tıklayın

Adım 4: Dosyaları yükleyin

1. TelegramBot.mqh dosyasını MQL5/Include/ klasörüne kopyalayın.
2. TelegramBot_Example.mq5 dosyasını MQL5/Experts/ klasörüne kopyalayın.
3. Her iki dosyayı da derleyin

Hızlı Başlangıç

#include <TelegramBot.mqh>

CTelegramBot bot;

int OnInit()
{
    // Botun başlatılması
    if(!bot.Initialize("SİZİN_TOKENİNİZ"., "YOUR_CHAT_ID"))
    {
        Print("Bot başlatılamadı");
        return INIT_FAILED;
    }
    
    // Bir test mesajı gönderme
    bot.SendMessage("Bot başarıyla bağlandı!");
    
    // Grafiğin ekran görüntüsünü gönder
    bot.SendChartScreenshot("Mevcut piyasa durumu.");
    
    return INIT_SUCCEEDED;
}

API Referansı

Temel Mesajlar

bool SendMessage(string text);
bool SendHTMLMessage(string text);
bool SendMarkdownMessage(string text);
bool SendMessageToAll(string text);

Ticaret Sinyalleri

bool SendTradeSignal(ENUM_SIGNAL_TYPE type, string symbol, double price);
bool SendPositionOpened(ulong ticket, string symbol, ENUM_POSITION_TYPE type, double volume, double price);
bool SendPositionClosed(ulong ticket, string symbol, double profit, double commission, double swap);

Medya dosyaları

bool SendPhoto(string file_path, string caption);
bool SendDocument(string file_path, string caption);
bool SendChartScreenshot();
bool SendChartScreenshot(string caption);

Raporlar

bool SendAccountStatus();
bool SendDailyReport();
bool SendWeeklyReport();
bool SendMonthlyReport();

Risk Yönetimi

bool SendRiskAlert(double drawdown_percent);
bool SendMarginWarning(double margin_level);
bool SendStopOutWarning();

Uzman Danışman örneği

Paket, Uzman Danışmanın tamamen işlevsel bir örneğini içerir ve bunu gösterir:

• Bildirimlerle pozisyon izleme
• Ticaret etkinliklerinde otomatik ekran görüntüleri
• Periyodik hesap durumu güncellemeleri
• Risk yönetimi uyarıları
• Günlük raporlar
• Demo ticaret sinyalleri

Mesaj biçimlendirme

HTML formatı (önerilir)

string message = "<b> Жирный текст</b>\n";
message += "<i> Курсив</i>\n";
message += "<code> Моноширинный код</code>\n";
message += "<a href='http://example.com'> Ссылка</a>";
bot.SendHTMLMessage(message);

Markdown biçimi

string message = "Kalın metin{\n}";
message += "İtalik.";
message += "Tek aralıklı kod.";
message += "[Link](http://example.com)";
bot.SendMarkdownMessage(message);

Performans

• Mesaj Hızı: Dakikada 30 mesaja kadar
• Dosya boyutu sınırı: Dosya başına 50MB
• Mesaj uzunluğu: 4096 karakter
• İmza uzunluğu: 1024 karakter
• Kuyruk boyutu: 100 mesaj
• Ortalama yanıt süresi: 50-200 ms

Hata işleme

Kütüphane karmaşık hata işlemeyi içerir:

• Bağlantı kontrolü
• Limit aşım koruması
• Arıza durumunda otomatik yeniden deneme
• Başarısız mesajlar için kuyruk sistemi
• Detaylı hata kaydı

Destek

• Dokümantasyon: Tam API dokümantasyonu kaynak koduna dahil edilmiştir
• EA örneği: Tüm özellikleri içeren çalışma örneği
• Hata AyıklamaModu: Sorun giderme için yerleşik hata ayıklama

Sürüm Geçmişi

Sürüm 1.0.0 (2024)

• İlk sürüm
• Telegram Bot API'sinin tam entegrasyonu
• Birden fazla kanal için destek
• Kuyruk sistemi
• Şablon motoru
• Risk yönetimi uyarıları

Ruhsat

Bu kütüphane MetaTrader 5'te kullanılmak üzere "olduğu gibi" sağlanmıştır. Kişisel ve ticari kullanım için ücretsizdir.

Yazar

Forex Ticaret Planı
(Stepan Sinic)

Sorumluluk Reddi

Bu yazılım herhangi bir garanti olmaksızın "olduğu gibi" sağlanmaktadır. Alım satım önemli bir kayıp riski içerir ve tüm yatırımcılar için uygun değildir. Geçmiş performans gelecekteki sonuçların bir göstergesi değildir.

---

Bu kütüphaneyi faydalı bulursanız, lütfen MQL5 CodeBase'de değerlendirin!

Ayrıntılı kurulum talimatları

Telegram'da bot oluşturma

1. BotFather'ı bulun

   • Telegram'ı Aç
   • Aramaya @BotFather yazın
   • BAŞLAT'a basın

2. Yeni bir bot oluşturun

   • Komutu gönder /newbot
   • Botun adını girin (örneğin: "Ticaret Botum")
   • Botun kullanıcı adını girin (örneğin: my_trading_bot)
   • Formun belirtecini kaydedin: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3. Botu yapılandırma

   • setprivacy öğesini gönderin ve DISABLE öğesini seçin (gruplarda çalışmak için).
   • /setjoingroups öğesini gönderin ve ENABLE (gruplara eklemek için) öğesini seçin

Sohbet Kimliği Alma

Özel mesajlar için:

1. Botunuzla bir diyalog başlatın
2. Herhangi bir mesaj gönderin
3. Tarayıcınızda açın: https://api.telegram.org/bot<TOKEN>/getUpdates
4. "chat":{"id":123456789} bulun - bu sizin Sohbet Kimliğinizdir

Bir grup için:

1. Botu bir gruba ekleme
2. Grup içinde bir mesaj gönderin
3. Bir tarayıcıda açın: https://api.telegram.org/bot<TOKEN>/getUpdates
4. Gruplar için "chat":{"id":-123456789} negatif bir sayıdır

Kanal için:

1. Kanal yöneticisi olarak bir bot ekleme
2. Kanala bir mesaj gönderin
3. Veya Sohbet Kimliği olarak kanalın @kullanıcıadını kullanın

Sık Karşılaşılan Sorun Çözümü

WebRequest hatası:

Çözüm: 1. Araçlar → Ayarlar → Danışmanlar 2. Araçlar → Ayarlar → Danışmanlar Aşağıdaki URL'ler için WebRequest'e izin ver 3. Ekle: https://api.telegram.org 4. MT5'i yeniden başlatın

Bot yanıt vermiyor:

Kontrol edin: 1. Doğru belirteç 2. Sohbet kimliği doğru Sohbet kimliği doğru 3. İnternet bağlantısı 4. WebRequest ayarları

Mesajlar iletilmiyor:

Olası nedenler: 1. API sınırı aşıldı (30 mesaj/dakika) 2. Mesajda yanlış HTML formatı 3. Mesaj çok uzun (>4096 karakter)

Kullanım Örnekleri

Satın alma sinyali gönderme

bot.SendTradeSignal(SIGNAL_BUY, "EURUSD", 1.1850, 1.1800, 1.1900);

Ek açıklamalı bir ekran görüntüsü gönderme

string caption = "<b> Точка входа</b>\n";
caption += "Пара: EURUSD\n";
caption += "Тип: BUY\n";
caption += "Цена: 1.1850";
bot.SendChartScreenshot(caption);

Hesap durumunu gönderme

bot.SendAccountStatus();
// Otomatik olarak bakiye, öz sermaye, marj vb. gönderin.

Günlük raporların ayarlanması

// OnTimer() danışmanı içinde
if(TimeHour(TimeCurrent()) == 23 && TimeMinute(TimeCurrent()) == 0)
{
    bot.SendDailyReport();
}

Düşüş uyarısı

double drawdown = CalculateDrawdown(); // Hesaplama işleviniz
if(drawdown > 20.0) // Düşüş %20'den fazla
{
    bot.SendRiskAlert(drawdown);
}

Mesaj yapısı

Açık pozisyon

[POSITION OPENED] ↑
================
Ticket: #12345678
Symbol: EURUSD
Type: BUY
Volume: 0.10
Price: 1.18500
Time: 2024.01.15 10:30
================

Pozisyon kapalı

[POSITION CLOSED]
================
Ticket: #12345678
Symbol: EURUSD
Profit: +125.50 USD
Commission: -2.00
Swap: -0.50
Total: +123.00 USD
Time: 2024.01.15 14:45
================

Günlük rapor

[DAILY REPORT]
================
Date: 2024.01.15

ACCOUNT SUMMARY
----------------
Balance: 10,125.50 USD
Equity: 10,250.00 USD
Floating P/L: +124.50 USD

TRADING ACTIVITY
----------------
Trades Today: 5
Today's Result: +250.00 USD
Open Positions: 2

BOT STATISTICS
----------------
Messages Sent: 45
Signals Sent: 8
Success Rate: 98.5%
================