# Telegram notifications

DarkBot.io offers seamless [integration with Telegram](https://docs.darkbot.io/user-profile/how-to-connect-disconnect-telegram-account), allowing users to receive real-time notifications related to their trading activities. With flexible notification settings, users have full control over their notification preferences, enabling them to stay informed about different categories of trading events. Whether it's deals, trailing, trade requests, credentials, or security, DarkBot.io provides a comprehensive range of notification templates to cater to each user's needs. (You can read how to set up notifications [here](https://docs.darkbot.io/configuring-and-managing-telegram-notifications/setting-up-notifications)!)

**Types and templates of available notifications:**

Category: **Deals**&#x20;

*Notification Templates:*

1. New deal for {market} was started at {exchange} exchange.
2. Deal for {market} was completed at {exchange} exchange. Invested {invested}. #Profit {profit} {percent}%.
3. Deal for {market} was force completed at {exchange} exchange. Invested {invested}. #Profit {profit} {percent}%.
4. Deal for {market} was canceled at {exchange} exchange. {comment}.
5. Stop loss initialized for market {market}.
6. Please note that the deal was completed with unsold amount {unsold} {asset}. During the next deal on market {market}, this amount will be sold.

Category: **Trailing**&#x20;

*Notification Templates:*

1. Trailing {type} for market {market} was created at price {initialPrice}. Trailing {trailingPrice}.
2. Trailing {type} for market {market} was changed from {old} to {new}.
3. Trailing {type} for market {market} was completed at {finalPrice}. Initial price was {initialPrice}.

Category: **Trade Requests**&#x20;

*Notification Templates:*

1. Trade request #{side} was created on market {market} at {exchange} exchange with a rate of {rate}. Planned quantity: {quantity}. Planned amount: {amount}.
2. Trade request #{side} was completed on market {market} at {exchange} exchange. Executed quantity: {quantity}. Executed amount: {amount}.
3. Trade request #{side} was canceled on market {market} at {exchange} exchange.
4. Trade request #{side} on market {market} was failed at {exchange} exchange. Error: {error}.
5. Order {side} with price {price} and total {total} was created on the {market} market at {exchange}.
6. Order {side} with price {price} was canceled on the {market} market at {exchange}.

Category: **Credentials**&#x20;

*Notification Templates:*

1. Your account at {exchange} exchange was successfully connected.
2. Balance {amount} {currency} was saved for credentials at {exchange} exchange. Total holdings value: {holdings}.
3. Rebalancing started on {exchange} exchange.
4. Rebalancing completed on {exchange} exchange.
5. Rebalancing failed on {exchange} exchange. Error: {error}.

Category: Security Notification Templates:

1. New login from {city}, {country}. IP: {ip}.

With DarkBot.io's Telegram notification feature, users can effortlessly manage and monitor their trading activities. Whether they prefer to receive notifications for every category or selectively enable specific notifications, DarkBot.io ensures that users stay up to date with the latest market events and trading-related updates.

**Telegram Notification Display Example:**

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2F5zi7dtOOQJ7dAdWwJZ7B%2Fimage.png?alt=media&#x26;token=55434652-7c06-4481-aa59-501220480b52" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.darkbot.io/features/telegram-notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
