Using Telegram to Manage your Haveno Account

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.


📑 Table of Contents

  1. Introduction
  2. Requirements
  3. Step-by-Step: Creating Your Telegram Bot
  4. Getting Your Telegram Chat ID
  5. Configuring the Bot with Haveno
  6. Notifications You Will Receive
  7. Commands You Can Send to the Bot
  8. Security & Privacy Tips
  9. Troubleshooting
  10. Feedback & Contributions

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:


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

  1. Open the Telegram app.
  2. In the search bar, type @BotFather and open the verified account.
  3. Click Start or send the /start command.

3.2 Create Your New Bot

Once in the chat with @BotFather, do the following:

  1. Send the command:

    /newbot
    
  2. You’ll be prompted to choose a name for your bot.

    • This can be anything, like Haveno Alert Bot.
  3. 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)
  4. 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)

Getting Your Telegram Chat ID

You’ll need your Telegram Chat ID so Haveno knows where to send the notifications.


  1. In Telegram, open a chat with your newly created bot (search using its username).
  2. 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

  1. Open Telegram.
  2. Search for @userinfobot and start it.
  3. It will respond with your user ID like:
    Your Telegram ID: 123456789
    

This is your chat ID. Copy it and proceed to configuration.


Great — let's continue by walking users through how to supply the Telegram bot token and chat ID into the Haveno App, using the built-in configuration panel. We’ll cover where to find the settings, what each field means, and how to test it.


Configuring the Telegram Bot in the Haveno App

Once you have:

  • ✅ Your Telegram bot token from @BotFather
  • ✅ Your Telegram chat ID (from /start or @userinfobot)

You’re ready to configure the bot in the Haveno App.


5.1 Open the Telegram Configuration Panel

  1. Launch the Haveno App from your system.
  2. Click to open the Menu drawer by clicing the icon in the top left corner).
  3. Click Settings from the menu.
  4. Scroll to find the section labeled "Telegram Integration", 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:

  1. Sell 0.5 XMR @ 120 USD/XMR (Offer ID: abc123)
  2. Buy 0.25 XMR @ 119 USD/XMR (Offer ID: def456)
/canceloffer abc123

⚠️ Are you sure you want to cancel Offer abc123? (Reply: /yes or /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 /revoke to 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:

  1. Revoke your bot token via @BotFather
  2. Update your Haveno password
  3. Check and reconfigure your offers
  4. 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”