Domande frequenti
Non trovi la risposta? Chiedi al chatbot di supporto (in basso a destra) o scrivici dalla pagina Contatti.
Installazione e requisiti
Che computer serve?
Windows 10/11 a 64 bit col tuo software di betting (XTrader / Betting Toolkit) installato sulla stessa
macchina: comunicano tramite un file CSV locale. L'EXE include già tutto (non serve installare Python).
Qualsiasi PC recente va bene.
Posso usare un VPS?
Sì, è la scelta tipica per il 24/7: un VPS Windows con 2 vCPU, 4 GB di RAM e 50 GB SSD basta.
Configura autologon e avvio automatico, e ricorda: chiudendo la sessione RDP chiudi solo la finestra,
senza fare logout. Se il tuo conto ha vincoli territoriali (es. Betfair.it), preferisci un VPS con IP
di quel paese.
Cosa mi serve prima di iniziare?
Un bot Telegram creato con @BotFather (ti dà il token), il bot aggiunto alla chat/canale
dei segnali, il Chat ID di quella chat, il software configurato per monitorare il CSV, e un
conto Betfair attivo.
Configurazione
Come faccio la prima configurazione?
Usa il 🧙 Wizard prima configurazione: 5 passi con verifiche dal vivo — token (prova
connessione), Chat ID (messaggio di prova), parser su un segnale reale con anteprima della
riga CSV, verifica del percorso CSV e checklist finale. Il wizard non attiva mai la modalità
Reale.
Il mio canale scrive i segnali in un formato particolare: funziona?
Sì, è il lavoro del 🧩 Parser Personalizzato: per ogni campo definisci come estrarlo dal
messaggio («Inizia dopo» / «Finisce prima», valori fissi, traduzioni). Con «🧪 Prova messaggio»
vedi subito la riga CSV che verrebbe generata. Il parser non inventa dati: se manca un campo
obbligatorio, nessuna riga viene scritta.
Posso usare più canali insieme?
Sì: da 🧰 Strumenti → 📡 Chat sorgenti aggiungi più chat, ognuna con il suo parser e
provider. Il bridge ascolta solo le chat configurate.
Dove vengono salvate le impostazioni?
In
%APPDATA%\XTraderBridge\config.json. Il token Telegram è salvato nel keyring
di Windows (Credential Manager), non in chiaro. Le impostazioni sopravvivono alla
reinstallazione del programma.Sicurezza e modalità
Il bridge piazza scommesse da solo?
No. Il bridge scrive solo il CSV che il software monitora: è il software a piazzare. E di default il
bridge parte in 🧪 Simulazione, dove il CSV operativo non viene nemmeno scritto.
Come si passa alla modalità reale?
Dalla tab 🛡️ Sicurezza, con attrito intenzionale: il passaggio a 🔬 Collaudo
chiede una conferma Sì/No; la modalità ⚠️ Reale richiede di digitare la parola
REALE, mostra un banner rosso persistente e chiede conferma a ogni avvio del
listener.Rischio di ripetere scommesse vecchie?
No: un solo segnale attivo (nel design predefinito), timeout configurabile, svuotamento
automatico del CSV e anti-duplicato persistente. Dopo un crash o blackout, un CSV stantio
viene ripulito al successivo avvio, prima che qualsiasi cosa possa scrivere di nuovo.
Cosa succede se cade la connessione?
Il bridge si riconnette da solo con attese crescenti (2s → 60s) mostrando
RICONNESSIONE…. I messaggi più vecchi di
max_signal_age (default 120s)
vengono ignorati: gli arretrati non diventano scommesse vecchie. Un errore non recuperabile
(es. token non valido) ferma il bridge e mostra l'errore.Problemi comuni
Il bridge non parte: perché?
Il motivo esatto è sempre nel 📋 Log. Cause tipiche: Bot Token mancante, CSV Path
mancante, Timeout non valido, nessuna chat configurata, oppure nessun Parser Personalizzato
attivo. La tab 🚦 Salute mostra 7 semafori con lo stato di ogni requisito.
Non scrive niente nel CSV
Se sei in Simulazione è normale: è il comportamento di sicurezza predefinito. Per scrivere
davvero passa a Collaudo o Reale (con i gate di conferma).
Posso aprire due istanze del bridge?
No: la seconda istanza viene rifiutata all'avvio con un avviso. Due istanze potrebbero
scrivere lo stesso CSV e piazzare scommesse doppie.
Devo tenere il programma aperto?
Sì, deve girare (anche minimizzato) mentre vuoi ricevere segnali. Con
auto_start_listener può partire da solo all'apertura — in modalità Reale chiede
prima conferma.