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.