ExMachina Telegram Bridge - sistema esperto per MetaTrader 5

COSA FA

L'EA rileva gli eventi di trading attraverso due meccanismi indipendenti: il gestore OnTradeTransaction per il rilevamento in tempo reale e una scansione periodica della cronologia delle transazioni come ripiego. Un sistema di deduplicazione assicura che non si riceva mai due volte la stessa notifica, anche se entrambi i meccanismi si attivano sullo stesso evento.

Notifiche supportate:

- Apertura dell'operazione: simbolo, direzione (ACQUISTO/VENDITA), volume, prezzo, SL, TP, numero magico, ticket dell'operazione.

- Trade chiuso: simbolo, volume, prezzo di chiusura, P/L lordo, commissione, swap, P/L netto, saldo aggiornato

- SL/TP modificati: i vecchi e i nuovi valori vengono visualizzati uno accanto all'altro (ad es. SL: 1924.00 → 1926.50)

- Ordini pendenti piazzati: tipo (Buy Limit, Sell Limit, Buy Stop, Sell Stop, Buy Stop Limit, Sell Stop Limit), prezzo, volume

- Inversione di posizione: nuova direzione, P/L chiuso

- Depositi e prelievi: importo e saldo aggiornato

- Riassunti periodici del conto: saldo, patrimonio netto, margine libero, P/L fluttuante, P/L di sessione, posizioni aperte, patrimonio netto alto/basso del giorno, percentuale di drawdown

- Messaggi di connessione e disconnessione con statistiche di sessione

CONFIGURAZIONE - PASSO DOPO PASSO

Sono necessari due elementi da Telegram: un Token Bot e il vostro ID Chat.

Passo 1: Creare un Bot Telegram

Aprite Telegram, cercate @BotFather e iniziate una conversazione. Inviate il comando /newbot. BotFather vi chiederà di scegliere un nome visualizzato (qualsiasi cosa vi piaccia) e un nome utente (che deve finire con "bot"). Una volta creato, BotFather invia un token API, una lunga stringa che assomiglia a 7123456789:AAH1bCdEfGhIjKlMnOpQrStUvWxYz. Copiate questo token.

Fase 2: Ottenere l'ID della chat

In Telegram, cercate @userinfobot (o @getmyid_bot) e inviategli un messaggio. Risponderà con il vostro ID di chat numerico (ad esempio, 123456789). Copiate questo numero.

Per le notifiche di gruppo: aggiungete il vostro bot a un gruppo Telegram, quindi usate @getidsbot nel gruppo per ottenere l'ID di chat del gruppo (numero negativo, ad esempio -1001234567890).

Fase 3: Iniziare una conversazione con il bot

Questo passo è facile da dimenticare. Trovate il vostro bot con il suo nome utente nella ricerca di Telegram, apritelo e premete Avvia. Se saltate questo passaggio, l'API di Telegram rifiuterà tutti i messaggi.

Passo 4: Consentire WebRequest in MetaTrader 5

In MT5, andate su Strumenti → Opzioni → Expert Advisors. Selezionate "Consenti WebRequest per gli URL elencati". Fare clic su Aggiungi e inserire esattamente: https://api.telegram.org - quindi fare clic su OK. Si tratta di una configurazione unica. Se si salta questo passaggio, nella scheda Esperti verrà visualizzato l'errore 4014 di WebRequest e non verrà inviato alcun messaggio.

Passo 5: Installare l'EA

Copiate ExMachina_TelegramBridge.mq5 nella cartella MQL5/Experts/ (accesso tramite File → Apri cartella dati in MT5). Aprite MetaEditor (F4), navigate fino al file e premete Compile (F7). Dovreste vedere 0 errori e 0 avvertimenti.

Fase 6: collegamento a un grafico

Trascinate l'EA dal pannello Navigator su un grafico qualsiasi. Nella finestra di dialogo delle impostazioni, incollate il vostro Bot Token e il vostro Chat ID. Fare clic su OK. Entro pochi secondi, si dovrebbe ricevere un messaggio di connessione in Telegram che mostra il numero di conto, il server, il saldo, il patrimonio netto e il numero di posizioni aperte.

PARAMETRI DI INPUT

Configurazione di Telegram:

- Token Bot: il token API di @BotFather (obbligatorio).

- ID chat: l'ID numerico della chat (obbligatorio, può essere l'ID di un gruppo).

Impostazioni di notifica:

- Notifica all'apertura dell'operazione: vero/falso (default: vero)

- Notifica alla chiusura dell'operazione: vero/falso (default: vero)

- Notifica su modifica SL/TP: vero/falso (predefinito: vero)

- Notifica sugli ordini in sospeso: vero/falso (predefinito: vero)

- Notifica su deposito/prelievo: vero/falso (predefinito: vero)

Riepilogo del conto:

- Intervallo del rapporto di riepilogo: Off, Ogni 1 ora, Ogni 4 ore, Ogni 8 ore, Ogni 24 ore (default: Ogni 4 ore)

- Includi il capitale nel riepilogo: vero/falso (valore predefinito: vero)

- Includi informazioni sul drawdown: vero/falso (impostazione predefinita: vero)

Visualizzazione e stile:

- Stile del messaggio: Minimo (una riga compatta), Dettagliato (informazioni complete con etichette) o Ricco di emoji (dettagliato con icone Unicode). Predefinito: Ricco di emoji.

- Mostra Dashboard su Grafico: vero/falso (predefinito: vero)

- Sfondo del cruscotto, colore del testo e colore dell'accento: personalizzabili. L'impostazione predefinita prevede l'uso della tavolozza d'acciaio di ExMachina.

Filtri:

- Filtro simbolo: elenco separato da virgole di simboli da monitorare. Lasciare vuoto per tutti i simboli. Esempio: "EURUSD,XAUUSD".

- Min Lot Size to Notify: volume minimo per attivare una notifica. 0 = nessun filtro. Utile per ignorare i micro-lotti.

- Filtro numero magico: notifica solo le operazioni con questo numero magico specifico. -1 = tutte le operazioni (anche quelle manuali).

STILI DI MESSAGGIO

Minimal - formato compatto a riga singola:

XAUUSD | BUY | 0,50 lotti @ 1928,45

Dettagliato - strutturato con campi etichettati:

OPERAZIONE CHIUSA

━━━━━━━━━━━━━━━━━━━━

Simbolo: XAUUSD

Chiusura: VENDERE (chiusura ACQUISTO)

Volume: 0,50 lotti

Prezzo: 1935.20

───────────────────

P/L lordo: +$340,00

Commissione: -$2,50

Scambio: -$0,00

P/L netto: +$337,50

Saldo: $10.585,00 USD

Offerta #182947363

Ricco di emoji (predefinito) - uguale a Dettagliato ma con icone Unicode per ogni campo. L'apertura dell'operazione mostra un cerchio verde per l'ACQUISTO e un cerchio rosso per la VENDITA. Le chiusure mostrano un segno di spunta per i profitti e una croce per le perdite.

FILTRI

Il filtro Magic Number è particolarmente utile se si gestiscono più EA sullo stesso conto. Impostatelo sul numero magico di un EA specifico per ricevere solo le notifiche di quell'EA. Impostandolo a -1 si riceverà tutto (comprese le operazioni manuali).

Il filtro Simbolo accetta un elenco separato da virgole: "XAUUSD,EURUSD,GBPUSD". Solo le operazioni su questi simboli genereranno notifiche. Lasciare vuoto per monitorare tutti i simboli.

RIEPILOGHI DEL CONTO

I riepiloghi periodici includono: saldo, patrimonio netto, margine libero, numero di posizioni aperte, P/L totale fluttuante (compreso lo swap), P/L di sessione dall'avvio dell'EA, patrimonio netto massimo del giorno, patrimonio netto minimo del giorno e percentuale di drawdown calcolata dal massimo del giorno.

Utile per i trader di società di investimento che devono monitorare i limiti di drawdown giornalieri da remoto. Impostare l'intervallo a 1 ora durante le sessioni attive.

CRUSCOTTO SUL GRAFICO

Un pannello di stato compatto nell'angolo superiore sinistro del grafico mostra:

- Stato della connessione: CONNESSO (verde) o DISCONNESSO (rosso).

- Nome utente del bot

- Contatori in esecuzione: messaggi inviati e non riusciti

- Tagline di ExMachina

La dashboard utilizza la tavolozza d'acciaio di ExMachina per impostazione predefinita (sfondo C'8,10,18', accento C'0,180,220') e può essere personalizzata o disattivata tramite gli ingressi del display.

COME TESTARE

Fase 1: Collegare l'EA a un grafico qualsiasi su un conto demo. Controllate la scheda Esperti per trovare "Connesso al bot @YourBotName". Controllate il messaggio di connessione su Telegram.

Fase 2: aprire manualmente un piccolo ordine di mercato (ad es. 0,01 lotti EURUSD). Dovreste ricevere una notifica "TRADE OPENED".

Fase 3: modificare lo SL o il TP della posizione aperta (clic destro → Modifica). Si riceverà una notifica "SL/TP MODIFICATO" che mostrerà i vecchi valori → i nuovi.

Fase 4: chiudere la posizione. Dovreste ricevere una notifica "TRADE CLOSED" con la ripartizione del P/L.

Fase 5: inserire un ordine pendente (ad es. Buy Limit). Si dovrebbe ricevere la notifica "ORDINE IN ATTESA INSERITO".

Fase 6: rimuovere l'EA dal grafico. Si dovrebbe ricevere un messaggio "Disconnesso" con le statistiche della sessione.

Test rapido del browser: per verificare il token e l'ID della chat prima di utilizzare l'EA, incollate questo URL in qualsiasi browser (sostituite i segnaposto):

https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage?chat_id=<YOUR_CHAT_ID>&text=Test

Se nella risposta viene visualizzato {"ok":true}, le credenziali sono corrette.

Uno script di test rapido: salvatelo come script (non EA) in MQL5/Scripts/, compilatelo ed eseguitelo su un grafico demo:

#include <TradeTrade.mqh>

void OnStart()

{

CTrade trade;

trade.Buy(0.01, "EURUSD");

Sleep(3000);

for(int i = PositionsTotal()-1; i >= 0; i--)

{

se(PositionGetSymbol(i) == "EURUSD")

trade.PositionClose(PositionGetTicket(i));

}

}

Dovreste ricevere una notifica di apertura e chiusura in Telegram.

Importante: questo EA non funziona nello Strategy Tester. Lo Strategy Tester non supporta WebRequest (chiamate di rete). L'EA deve essere eseguito su un grafico live o demo con accesso a Internet.

Esecuzione accanto ad altri EA

MT5 consente un solo EA per grafico. Collegare il Telegram Bridge a un grafico separato (qualsiasi simbolo). L'EA monitora l'intero conto, non solo il grafico a cui è collegato. Tutte le operazioni di tutti gli EA e le operazioni manuali saranno rilevate indipendentemente dal grafico su cui è in esecuzione il ponte.

Utilizzare il filtro Magic Number per limitare le notifiche a un EA specifico.

RISOLUZIONE DEI PROBLEMI

Nessun messaggio ricevuto:

1. Verificare che https://api.telegram.org sia in Strumenti → Opzioni → Expert Advisors → Consenti WebRequest.

2. Verificare che il Bot Token e il Chat ID siano corretti (senza spazi aggiuntivi).

3. Assicuratevi di aver premuto Avvia nella chat Telegram del vostro bot.

4. Controllare la scheda Esperti (Visualizza → Casella degli strumenti → Esperti) per i messaggi di errore

Errore 4014 di WebRequest: l'URL di Telegram non è nell'elenco consentito. Questo è il problema più comune.

HTTP 401 Unauthorized: token bot non valido. Copiatelo di nuovo da @BotFather.

HTTP 400 Bad Request: ID chat errato, oppure non è stata avviata una conversazione con il bot.

HTTP 429 Troppe richieste: Limite di velocità di Telegram. L'EA ha una logica di retry integrata con backoff. Questo accade solo con una frequenza di trading estremamente elevata.

L'EA mostra INIT_PARAMETERS_INCORRECT: Bot Token e Chat ID sono entrambi richiesti. Assicuratevi che nessuno dei due campi sia vuoto.

La dashboard non viene visualizzata: assicuratevi che "Show Dashboard on Chart" sia impostato su true negli input dell'EA.

DETTAGLI TECNICI

- Rilevamento delle operazioni: doppio meccanismo tramite OnTradeTransaction (in tempo reale) + polling della cronologia delle operazioni ogni 2 secondi (fallback).

- Deduplicazione: operazioni elaborate memorizzate (ultime 500 operazioni monitorate)

- Rilevamento SL/TP: array di istantanee della posizione confrontate a ogni tick, con attivazione di qualsiasi cambiamento

- API di Telegram: HTTPS POST tramite WebRequest, payload codificato in URL, modalità di analisi Markdown

- Logica dei tentativi: fino a 3 tentativi per messaggio, ritardo di 1 secondo tra i tentativi, ritardo di 3 secondi su HTTP 429

- Test di connessione: endpoint /getMe chiamato all'avvio per convalidare il token e recuperare il nome del bot

- Timer di riepilogo: EventSetTimer(60) controlla se l'intervallo configurato è trascorso.

- Oggetti del grafico: tutti gli oggetti del cruscotto utilizzano il prefisso "EXTB_" e vengono ripuliti all'avvio.

- Nessuna DLL esterna, nessun server di terze parti. Comunicazione diretta MT5 → Telegram su HTTPS.

Questo EA è gratuito e open source. Feedback, valutazioni e suggerimenti sono benvenuti.

ExMachina Trading Systems - La precisione prima del profitto.