> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-3.0/readme/telegram-alerts.md).

# Telegram alerts

Alerts through a Telegram bot that is yours, with buttons to act right there; goodcryptoX talks to Telegram directly.

goodcryptoX sends its alerts through a Telegram bot that is yours, with buttons under them to act right there. For some people this is all they need. goodcryptoX talks to Telegram directly; nothing you are told passes through a server of ours.

## Connect

From your computer or your phone, the same steps:

1. Open **Settings › Alerts** and press **Create my Telegram bot**. Telegram opens.
2. Telegram shows your new bot with its name filled in. Confirm it.
3. Press **Start** in your bot's chat. Your bot writes "Your goodcryptoX is now linked to this Telegram chat" and the alerts arrive there. If it stays silent, press **Open your bot** in Settings › Alerts, then **Start**.

You do not set the bot's picture: it appears by itself when you come back from Telegram.

<details>

<summary>With your own bot from BotFather</summary>

If you want no server of ours anywhere, create the bot yourself.

1. In Telegram, start a chat with **@BotFather** and send `/newbot`.
2. Send a name for the bot, then a username ending in `bot`.
3. BotFather answers with a token. Copy it.
4. In **Settings › Alerts**, press **Enter your bot's token**, paste it and press **Connect**.
5. Press **Open your bot**, then **Start** in its chat.

</details>

<details>

<summary>If this does not work</summary>

* Telegram did not open: press **Create my Telegram bot** again. It opens the same link and starts nothing new; after ten minutes, a press starts a new set-up.
* The bot answers "To link a chat, press Open your bot in Settings › Alerts": do that, and press **Start** in the chat that opens.
* Anything else: Settings › Alerts says what happened and what to press.

</details>

## Open your bot

Whichever way you got the bot, until a chat is linked goodcryptoX shows **Open your bot**. It opens your bot's chat in Telegram; press **Start**, and the alerts arrive there.

## Disconnect

Press **Disconnect** in Settings › Alerts. Your chat is told, and nothing more is sent. The bot itself stays yours in Telegram; delete it in BotFather if you no longer want it.

## What you get

Alerts tell you about order fills and triggers, bot activity and anything that needs you. Choose routine alerts in **Settings › Alerts** and each bot's **Notifications**. A reminder arrives every hour while a position is left without its working stop-loss or close. After goodcryptoX was away, one message tells you what happened meanwhile.

## Opening goodcryptoX from a message

With phone access on and a device paired, **Open** at the end of an alert opens its bot, order or proposal in goodcryptoX.

Telegram's built-in browser cannot sign in. Press **Open in Safari** on an iPhone or **Open in Chrome** on Android. The button keeps the alert's destination. If it does nothing, use Telegram's **Open in Browser** instead.

To skip this next time, hold **Open** in Telegram, choose **Open in Browser**, and tick **Always open this site in browser**. On Android, the checkbox says **Always open links from my.goodcrypto.app in browser** (or your phone page's address).

This opens your browser, rather than the goodcryptoX icon saved on your home screen. Sign in there with your passkey.

## Order alerts and bot defaults

In **Settings › Alerts**, choose which routine order events reach Telegram. **Orders placed outside goodcryptoX** includes orders placed in the exchange's app or through another trading tool, rather than through this goodcryptoX.

**Bot defaults** are the alert choices every new bot starts with. Change an individual bot's alerts in its setup form or its details. Changing the defaults does not rewrite the notification choices of bots already running. Errors and problems needing your decision still arrive regardless of routine bot switches.

## Shortcut buttons

Under an alert about one of your bots or orders sit the buttons that fit it:

* **Your order filled** (a buy, or a sell on perpetuals): **TP +5%**, **TP & SL 5%** or **TP & SL 10%** add a take-profit, or a take-profit and a stop-loss, to it.
* **A bot is running**: **Stop bot**, and **Close position** while it holds one.
* **A bot's averaging order failed**: **Stop bot** and **Fix failed**.
* **A bot ended**: **Relaunch** starts a new one with its settings, and **Close position** if its position is still open.
* **An order canceled on the exchange**: **Place again** places its unfilled remainder again; **Leave canceled** closes it in goodcryptoX. Other repairs and bots offer the answers that apply on their page. If you changed it on {venue}, the new order is already there.
* **The hourly reminder**: its item's buttons, and **Silence** to stop the reminders.

Each button does what the same button in the panel does. Two switches in Settings › Alerts, under Telegram, both on at first:

* **Shortcut buttons**: off, the alerts come without them.
* **Confirm before acting**: a button first says what it is about to do, and acts only after you press **Confirm**.

If someone else can use your phone or your Telegram, turn the shortcut buttons off.

## Questions

### How do I connect goodcryptoX to Telegram?

Open **Settings › Alerts**, press **Create my Telegram bot**, confirm the bot Telegram shows, and press **Start** in its chat.

### Do my alerts go through goodcryptoX's servers?

No: goodcryptoX talks to Telegram directly, and nothing you are told passes through a server of ours. For no server of ours anywhere, create your own bot in BotFather.

### Can I act on an alert in Telegram?

Yes: buttons under an alert do what the same button in the panel does, such as **Stop bot**, **Close position** or a take-profit on a filled order. Turn **Shortcut buttons** off in Settings › Alerts if someone else can use your phone or your Telegram.

### Which alerts does goodcryptoX send?

Order fills and triggers, bot activity and anything that needs you. You choose the routine ones in **Settings › Alerts** and in each bot's **Notifications**.
