Receive real-time notifications and interact with your Haveno instance via Telegram, from order alerts to status updates and commands on demand. Some less technical users may find this easier or more convenient than using haveno on the mobile.
What We’ll Cover in This Guide
| Section | Purpose |
|---|---|
| Bot Setup | Guide users in creating a Telegram bot with @BotFather |
| Chat ID Retrieval | Explain how to get the Telegram ID for message delivery |
| Bot Configuration | Show how to link your bot with the Haveno daemon |
| Notifications | List the real-time updates the bot will push |
| Commands | Define what actions the bot can respond to |
| Security | Provide guidance on keeping tokens and chat IDs secure |
Receive real-time notifications and interact with your Haveno instance via Telegram - from trade alerts to system status updates and beyond.
Introduction
The Haveno Telegram Bot allows you to connect your personal Telegram account to your Haveno app, so you can receive instant alerts and even send commands directly to your Haveno instance via Telegram.
This is especially useful if you:
- Want to monitor trade activity remotely
- Need real-time notifications about deposits, completed trades, or system status
- Prefer to interact with the Haveno daemon without opening the desktop interface
- This is the only way currently to recieve real-time notifications on iOS, the build in notifications system works fine on every other device (iOS does not allow long running background tasks from client to server)
Once configured, the bot will be able to send you a range of updates, including:
- New trade offers
- Order matches
- Disputes and arbitration alerts
- Wallet balance changes
- System status, such as Tor or Monero sync events
And more, depending on your Haveno setup.
Requirements
Before you begin, make sure you meet the following requirements:
1. Installed Haveno (Desktop App or Docker Deployment)
You can use either of the following methods to run Haveno:
Option A: Haveno Multi-Platform Desktop App (Recommended)
Download and install the official Haveno App from:
👉 https://haveno.com
This version includes:
- A user-friendly graphical interface
- Automatic installation and management of the Haveno daemon
- Built-in support for Telegram bot configuration via the Settings screen
🧭 Tip: Open Settings → scroll to the "Telegram" section.
Paste your bot credentials and configure notifications directly in the UI — no manual editing required.
Option B: Docker Compose Deployment (For Advanced/Headless Use)
Alternatively, you can run Haveno via our Docker-based deployment stack, which:
- Starts the Haveno daemon in a containerized environment
- Allows you to configure Telegram integration via environment variables
This option is more suitable for:
- Headless or remote servers
- Privacy-focused users who don’t want a GUI
- Early adopters who are comfortable with command line tools
However:
⚠️ Telegram integration via Docker is currently limited.
While notifications can be enabled via environment variables, command functionality and rich UI config are still under development in this mode.
🧪 Our Recommendation
| User Type | Recommended Setup |
|---|---|
| 🧍 Casual User | Desktop App — easier, full access |
| 👩💻 Advanced User | Docker — use at your own discretion |
| ⚙️ Power User | Desktop for setup, Docker for ops |
We strongly recommend using the Desktop App first to ensure your Telegram bot is working correctly, especially if you’re new to Haveno.
3. Telegram Account
You must have an active Telegram account to:
- Create a bot via @BotFather
- Receive messages from your bot
- Optionally send commands back to the bot
If you don’t have Telegram yet:
👉 Download Telegram
4. Internet Access
The bot and the Haveno app require an internet connection to:
- Send/receive messages via Telegram’s servers
- Access the Monero network over Tor
Make sure your firewall or proxy allows outbound connections.
Perfect — here’s the next section of the guide that explains how to create the Telegram bot, retrieve the token, and prepare it for use in the Haveno App configuration screen.
Step-by-Step: Creating Your Telegram Bot
To send yourself notifications and allow interaction with Haveno through Telegram, you'll need to create a Telegram bot using @BotFather and then connect it to your Haveno App.
Follow these steps carefully:
3.1 Start a Conversation with @BotFather
- Open the Telegram app.
- In the search bar, type '@BotFather' and open the verified account.
- Click Start or send the
/startcommand.
3.2 Create Your New Bot
Once in the chat with @BotFather, do the following:
-
Send the command:
/newbot -
You’ll be prompted to choose a name for your bot.
- This can be anything, like
Haveno Alert Bot.
- This can be anything, like
-
You’ll then choose a username — this must:
- End in
bot(e.g.,haveno_alert_bot) - Be unique (if the name is taken, try a variation)
- End in
-
Once complete, you’ll receive a message that contains:
-
✅ Your Bot Token — a long string that looks like:
123456789:AAE_ExAmPlEtOkEn_AbCdEfGhIjKlMnOp
-
⚠️ Important: Copy this token and store it somewhere safe. You will need it in the Haveno App.
3.3 Optional: Customize Your Bot (Profile, Description, Icon)
You can send other commands to @BotFather to give your bot some polish:
| Command | Purpose |
|---|---|
/setdescription |
Add a short description for the bot |
/setuserpic |
Upload a profile picture |
/setabouttext |
Add info shown on the bot’s profile |
/setcommands |
Predefine a list of supported commands (optional for Haveno use) |
The Haveno app does however already set these configurations, so unless you're doing something really fancy, just skip this completely.
Getting Your Telegram Chat ID
You’ll need your Telegram Chat ID so Haveno knows where to send the notifications.
4.1 Using the Bot’s /start Command (Recommended)
- In Telegram, open a chat with your newly created bot (search using its username).
- Click Start or type
/start.
If your Haveno Telegram bot is correctly configured, it will respond with something like:
Welcome! Your chat ID is: 123456789
Copy this number. You’ll need it for the config.
4.2 Alternative: Use @userinfobot
- Open Telegram.
- Search for '@userinfobot' and start it.
- It will respond with your user ID like:
Your Telegram ID: 123456789
This is your chat ID. Copy it and proceed to configuration.
Configuring the Telegram Bot in the Haveno App
Once you have:
- ✅ Your Telegram bot token from @BotFather
- ✅ Your Telegram chat ID (from
/startor @userinfobot)
You’re ready to configure the bot in the Haveno App.
5.1 Open the Telegram Configuration Panel
- Launch the Haveno App from your system.
- Click to open the Menu drawer by clicing the icon in the top left corner).
- Click Settings from the menu.
- Scroll to find the section labeled "Telegram", this is presented as a separate card or section in the UI at the bottom and looks like this:
5.2 Fill In the Telegram Details
You should see input fields like:
| Field | Description | Required? |
|---|---|---|
| Bot Token | The token given to you by @BotFather (e.g. 123456789:ABC...) |
✅ Yes |
| Chat ID | Your Telegram User ID (e.g. 123456789) |
✅ Yes |
| Notifications Enabled | Enable or disable Telegram notifications globally | ✅ Yes |
| Test Message | (Optional) A button to send a test message to confirm setup | Optional |
| Bot Name | (Optional) Friendly name shown in logs or UI | Optional |
| Command Access | Enable interaction features (commands sent from Telegram) | Optional |
Once you’ve filled in the Bot Token and Chat ID, click Save or Apply (depending on your Haveno App version).
5.3 Test the Bot Connection
- Click the "Send Test Notification" button (if available), or
- Trigger a known event in Haveno (e.g. create a test trade or view wallet sync)
If configured correctly, your Telegram bot will send you a message like:
🧪 Test Notification: Telegram bot setup successful.
⚠️ Never share your bot token publicly. Treat it like a password.
Notifications You Will Receive
The Telegram bot is designed to send you automated alerts whenever important events occur in your Haveno instance. These events are based on data from the Haveno daemon and surfaced in real-time via gRPC.
Here’s a table of default supported notifications:
6.1 Notification Table
| Notification Type | Trigger Event | Example Message |
|---|---|---|
| New Trade Offer | A new buy/sell offer appears that matches your criteria | 🛒 New offer: Sell XMR for BTC |
| Trade Started | A trade is accepted and enters the trading phase | 🤝 Trade started: 0.25 XMR with peer123 |
| Payment Sent/Received | You’ve sent or received fiat/crypto | 💸 Payment received: 150 USD |
| Trade Completed | Trade successfully finalized | ✅ Trade completed: 0.25 XMR |
| Dispute Opened | A dispute has been triggered by you or your peer | ⚠️ Dispute opened with peer123 |
| Wallet Synced | Monero wallet has finished syncing | 🔄 Wallet sync complete |
| Daemon Startup | Haveno daemon is fully started and ready | 🚀 Haveno is ready |
| Daemon Error | Error with the Haveno daemon (e.g., cannot connect to Tor) | ❌ Error: Tor connection failed |
| Balance Update | Your Monero or BTC balance changes | 💰 New balance: 3.274 XMR |
| Offer Taken | Someone accepted your offer | 🧾 Your offer has been taken: 0.1 XMR |
Commands You Can Send to the Bot
Besides notifications, the bot also supports a set of basic Telegram commands. These let you control your Haveno instance remotely in a safe and simplified way, ideal for mobile monitoring or headless operation.
7.1 Command Table
| Command | Description | Notes |
|---|---|---|
/help |
Show available commands | Always available |
/status |
Check if Haveno is online and synced | Pings the daemon |
/balance |
View your current XMR wallet balance | Returns available + locked |
/offers |
View currently available offers | Max 5 shown |
/mytrades |
Show your active trades | Trade ID, amount, peer nickname |
/canceloffer <ID> |
Cancel a specific offer by ID | You’ll be warned first |
/shutdown |
Gracefully shut down the daemon | Restricted use |
/torstatus |
Check Tor connectivity status | gRPC: GetNetworkInfo |
/walletsync |
Trigger wallet sync now | gRPC: SyncWallet |
/version |
Show Haveno version and network | Good for debugging |
7.2 Command Response Examples
/balance
💰 Your XMR Wallet: 3.271 available, 0.029 locked
/offers
🔍 Available Offers:
- Sell 0.5 XMR @ 120 USD/XMR (Offer ID: abc123)
- Buy 0.25 XMR @ 119 USD/XMR (Offer ID: def456)
/canceloffer abc123
⚠️ Are you sure you want to cancel Offer
abc123? (Reply:/yesor/no)
/shutdown
⚠️ Daemon shutdown initiated. Bye 👋
🔐 Permission Note
If command access is enabled in the Haveno Telegram settings, these commands will be allowed only from the authorized chat ID. Messages from any other user will be ignored or logged as suspicious.
Here’s a complete Security & Privacy Tips section tailored to your Telegram bot integration and Haveno setup, written with clarity and realism for non-technical users, but with enough teeth to actually protect them.
Additional Security & Privacy Tips
Using Telegram to interface with Haveno adds convenience — but also introduces serious security considerations. If someone gains access to your bot token, chat ID, or Haveno instance, they could monitor your trades, manipulate your offers, or shut your node down.
Follow these tips to stay protected:
1. Use a Strong App Password (Even If It’s Optional)
When launching Haveno for the first time, you'll be offered to set an app password.
- ✅ Recommended: Set one, this protects access to your wallet, keys, and Telegram configuration.
- ❌ If you skip it: Anyone with access to your computer could read or modify your Telegram token and bot settings from the local config files.
You can still set a password later via the Settings screen.
2. Never Share Your Bot Token
Your Telegram bot token (e.g. 123456789:ABCdef...) is like a master key to send messages as your bot.
- Never paste it in chat messages
- Never upload it to GitHub or other public repositories
- If you think it's been exposed, go to @BotFather and run
/revoketo generate a new one
3. Rotate Tokens and Reset Passwords Regularly (If Exposed)
If at any point you suspect your:
- Telegram bot token
- Haveno app password
- Device itself
Or has been compromised, assume full compromise and:
- Revoke your bot token via @BotFather
- Update your Haveno password
- Check and reconfigure your offers
- Reinstall Haveno if needed
4. Be Wary of Command Abuse
Even though Haveno’s command interface via Telegram is limited and hardened:
- Avoid enabling destructive commands (
/shutdown,/canceloffer) unless necessary - If you’re running in a shared environment, use the app password to prevent UI access
Common Issues & Suggestions
| Issue | Cause | Fix |
|---|---|---|
| Telegram bot not sending messages | Bot token or chat ID incorrect | Double-check both — make sure you started the bot in Telegram |
| Bot sends messages but ignores commands | Command access is disabled in settings | Enable “Command Access” in the Telegram card |
| Wallet not syncing | Monero node or daemon not fully initialized | Wait or check network logs in Haveno app |
| Notifications delayed | Local system slow or heavy load | Restart Haveno, make sure system has enough memory |
| “Bot is blocked” error in logs | You blocked the bot or never clicked /start | Open the bot in Telegram and tap “Start” |