User Documentation - TMFX AI Bot

1.1 Description

TMFX AI Bot is a desktop application that receives trading signals from Telegram channels and sends them automatically to your MetaTrader 4 and 5 terminals for execution.

1.2 What the bot does

1. Receives the signal from the Telegram channel in real time
2. Applies your configuration (lot size, take profits, asset mapping, etc.)
3. Writes the signal to MetaTrader's files folder
4. The Expert Advisor (EA) in MetaTrader reads and executes the order

1.3 What the bot does NOT do

• Does not generate signals — Only copies and executes signals from channels you subscribe to
• Does not trade by itself — You need to have the EA attached to a chart in MetaTrader

1.4 Main features

• Multi-platform: MetaTrader 4 and MetaTrader 5
• Multiple instances: One channel can send signals to several MT4/MT5 accounts at once
• Configuration per channel + instance: Each channel + MetaTrader combination has its own configuration
• Up to 5 Take Profits: Opens a separate operation for each TP selected
• Automatic EA installation: The app installs the EA in each MetaTrader you add
• Languages: Spanish and English

1.5 Requirements

• Operating system: Windows or macOS
• MetaTrader: MT4 or MT5 installed
• Telegram: Active Telegram account
• Subscription: TMFX AI Bot (verify with email + Hotmart transaction code)

2.1 Verify subscription

1. Open the TMFX AI Bot application 2. Enter your email (the same one you used to purchase) 3. Enter your Hotmart transaction code (e.g. HP2175063343) 4. Click Verify Subscription You only need to do this once. The app will save your subscription and validate it automatically on each startup.

2.2 Log in to Telegram

1. Enter your phone number (with country code, e.g. +34 612 345 678) 2. You will receive a verification code in Telegram 3. Enter the code 4. If you have two-step verification, enter your password Your Telegram account is linked to your subscription to receive signals.

2.3 Add MetaTrader instances

1. Go to the MetaTraders tab 2. The app automatically detects MT4 and MT5 installations 3. If it doesn't appear, click Add instance manually 4. Select the data folder of each terminal you want to use Important: The EA is installed automatically in each instance you add.

2.4 Subscribe to channels

1. Go to the Channels tab 2. In My Channels you'll see the Telegram channels you have access to 3. Click Subscribe on the signal channels you want to copy 4. Status will change from not listening → configuration pending → active (when configured)

2.5 Configure each channel

1. In My Channels, click Configure on the channel you want 2. Select the MetaTrader instance to send signals to 3. Complete Quick Setup (required): Lot size (fixed or risk %), Take Profits (TP1, TP2, TP3, TP4 and/or TP5) 4. Click Save and Start Copying

2.6 Attach the EA in MetaTrader

1. Open MetaTrader 4 or 5 2. Go to Navigator → Expert Advisors 3. Find TMFX-AI-Bot-M4 (MT4) or TMFX-AI-Bot-M5 (MT5) 4. Right-click → Attach to chart (or drag the EA onto a chart) 5. Make sure AutoTrading is enabled (green button in the top bar) The chart will show a dark panel with connection status. When it says Connected, listening for new signals, you're all set.

4.1 Quick Setup (required)

Lot size: Fixed lot (e.g. 0.5) or lot by balance percentage (e.g. 2% per trade). Minimum 0.01. If you select multiple TPs, the lot is divided among them.

Take Profits: TP1 = one operation; TP1+TP2 = two operations; TP1 to TP5 = five operations. Each operation uses the same lot divided by the number of active TPs.

4.2 Advanced configuration

Asset mapping: If your broker uses different names (e.g. XAUUSD→GOLD). Format: XAUUSD=GOLD, EURUSD=EURUSDi. Comma separated.

Blacklist (Pro/VIP): Assets to ignore. Format: XAUUSD, BTCUSD. Pro and VIP only.

Replace SL (Pro/VIP): Calculate SL from distance to TP. Reference TP + multiplier (×0.5, ×1, ×2, ×3).

Break-even protection (Pro/VIP): By default moves SL to break-even when TP1 is reached. You can disable it in Pro/VIP.

5.1 Installation

The app installs the EA automatically when adding an instance. Files in: MT4: [Data folder]/MQL4/Experts/ — MT5: [Data folder]/MQL5/Experts/

5.2 Chart panel

When attaching the EA you'll see: TMFX AI BOT V1.1.0, Status (Connected/Disconnected/Not validated), Last Bot Validation, Last Signal Verification.

5.3 EA states

• Connected, listening for new signals: All good. The EA is ready.
• Disconnected: No signal file. Check that the app is open and the channel is configured.
• Not validated: This instance is not registered. Add it in the MetaTraders tab.

5.4 Symbol resolution

The EA resolves symbols: 1) Cache if already resolved, 2) Exact match, 3) Clean match (no bars), 4) Fuzzy match. The mapping is saved permanently.

6.1 Signal notifications

Sound: beep when signal arrives. Toast: on-screen notification (e.g. BUY EURUSD). Errors: toast with details if send fails.

6.2 Updates

The app checks every 30 min for new version. If update available: modal with download, install steps, reminder to re-attach EA. Important: After updating, re-attach the EA on each chart.

7.1 Profile information

In Profile (user icon): Telegram account (name, username, phone, ID), Subscription (email, plan, next billing), App version.

7.2 Log out

Logging out removes: subscription config, subscribed channels, MT instances, channel config, saved signals. The app restarts completely. You'll need to verify subscription and log in again.

8.1 What happens if I close the app?

Signals will not be sent. The app must be open to receive signals. MetaTrader can be closed if you use a VPS.

8.2 Can I use multiple MetaTraders?

Yes. In Pro/VIP you can add unlimited instances. Each channel can send to multiple instances with different configuration.

8.3 Does the EA work on demo accounts?

Yes. The EA works the same on demo and real accounts.

8.4 What if the symbol is not found?

1) Use Asset mapping in channel config (e.g. XAUUSD=GOLD). 2) Verify the exact symbol name in your broker. 3) Check MetaTrader log (Experts tab).

8.5 What broker can I use?

Any broker that supports MetaTrader 4 or 5. The EA uses the standard MetaTrader API.

8.6 Can I unsubscribe from a channel?

Yes. In Channels, click Unsubscribe. All associated configuration will be removed.

8.7 How do I update the EA?

1) Update the app when a new version is available. 2) In MetaTrader, remove the EA from the chart. 3) Re-attach the EA from Navigator → Expert Advisors. 4) Verify it shows the correct version (e.g. V1.1.0).