> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ordsbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Telegram notifications — coming soon

<Note>
  Telegram notifications are **coming soon**. The notification system is built and ready — it will be connected to the bot in an upcoming update.
</Note>

## Planned notification events

Once live, OrdsBot will send Telegram alerts for the following events:

| Event         | Description                             |
| ------------- | --------------------------------------- |
| Bid filled    | A bid was accepted — inscription bought |
| Floor crash   | Floor dropped >15%, all bids cancelled  |
| Outbid        | A competitor placed a higher bid        |
| Bid cancelled | Bids cancelled due to market change     |
| Low balance   | Bidding wallet balance is running low   |
| Task error    | Worker cycle failed                     |

## How it will work

You will configure a Telegram bot token and chat ID in **Settings → Notifications**. The bot will then send messages to your Telegram for each of the events above.

To prepare your Telegram bot in advance:

1. Message [@BotFather](https://t.me/BotFather) and run `/newbot`
2. Copy the token it gives you
3. Get your Chat ID by sending a message to the bot, then visiting:
   `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
4. Find `"chat":{"id":XXXXXXXXX}` — save that number