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

# Telegram

> Connect the StratAlerts Telegram bot to receive in-force and simultaneous break alerts as messages in a dedicated bot conversation, free on any device.

Telegram is a free messaging app available on iOS, Android, and desktop. When you connect StratAlerts to Telegram, alerts arrive as messages in a private bot conversation — giving you a persistent, scrollable alert log alongside a direct link back into the setup workflow in the app. Unlike email, Telegram notifications are instant and can be pinned to the top of your conversations for quick access during the trading session.

<Note>
  Push notifications require the **Founders Plan**. Basic plan subscribers do not have access to alert delivery through Pushover or Telegram. [Compare plans →](/pricing)
</Note>

## What you need

* The Telegram app installed on your device ([telegram.org](https://telegram.org))
* A Telegram account
* An active StratAlerts Founders Plan subscription

## Setup

<Steps>
  <Step title="Install Telegram and create an account">
    Download Telegram from the App Store or Google Play (or use the desktop or web client). Sign up with your phone number and complete verification.
  </Step>

  <Step title="Start a conversation with the StratAlerts bot">
    Search for **@StratAlertsBot** in Telegram or open the link provided in StratAlerts under **Alerts → Settings → Telegram**. Tap **Start** to open the conversation. The bot will respond with your unique chat ID.
  </Step>

  <Step title="Copy your chat ID or token and enter it in StratAlerts">
    The bot's welcome message includes your **Chat ID**. Copy it, then paste it into the **Telegram Chat ID** field in StratAlerts under **Alerts → Settings → Telegram**. Save the settings — StratAlerts will send a test message to confirm.
  </Step>

  <Step title="Configure your alert groups">
    Under **Alerts → Settings**, create or edit an alert group with the symbols, timeframes, and optionally specific setups you want to receive. If you leave the **Setup** selector on **All**, every matching setup triggers a notification. To narrow delivery, select specific setups like `1-2`, `3-2`, or `2d-green (failed)` from the dropdown.
  </Step>
</Steps>

<Note>
  If the test message doesn't arrive, make sure you tapped **Start** in the bot conversation. Telegram bots cannot send messages to users who haven't initiated the conversation first.
</Note>

## Market selection

Each delivery method has its own market filter that controls which asset classes can trigger alerts. Under **Alerts → Settings → Telegram**, you will see checkboxes for:

* **Stocks** — equities alerts (e.g., `SPY`, `AAPL`)
* **Futures** — futures alerts (e.g., `NQ=F`, `ES=F`)
* **Crypto** — cryptocurrency alerts (e.g., `BTC-USD`)

Check the markets you want to receive on this channel and save. Only alerts for enabled markets are delivered — alerts for unchecked markets are silently filtered out.

<Warning>
  Sim Break Alerts scan futures instruments. If you want to receive Sim Break alerts through Telegram, make sure **Futures** is enabled here.
</Warning>

## What alerts you receive

Once connected, the StratAlerts bot delivers two types of alerts:

<CardGroup cols={2}>
  <Card title="In-force alerts" icon="bell">
    Sent when a setup goes in-force — price has cleared the trigger level and the trade is active. Includes symbol, timeframe, setup, and direction with a deep link back into the app.
  </Card>

  <Card title="Simultaneous break alerts" icon="bolt">
    Sent when multiple instruments break together within a short window, flagging potential broad market participation.
  </Card>
</CardGroup>

## Alert message format

Each Telegram alert includes full setup context and a tap-to-open link back into StratAlerts:

```text example alert theme={null}
📈 SPY — Daily — 2U — Up
In-force at 561.40

View setup → https://app.stratalerts.com/...
```

The deep link opens the Setups Table with the clicked symbol prefiltered and all timeframes visible, so you can review TFC context, target levels, and candle state without navigating manually.

<Tip>
  The deep link in each alert takes you straight to the Setups Table filtered to that symbol across all timeframes. Tapping it from your phone opens the StratAlerts mobile view at the correct symbol.
</Tip>

## Tips

<AccordionGroup>
  <Accordion title="Pin the StratAlerts bot conversation">
    Long-press the StratAlerts bot conversation in your Telegram chat list and select **Pin**. This keeps the alert feed at the top of your screen, one tap away during the session.
  </Accordion>

  <Accordion title="Enable notifications specifically for the bot">
    If you've muted Telegram globally or use focus modes, make sure the StratAlerts bot conversation has notifications enabled. Open the conversation, tap the bot name at the top, and verify **Notifications** is set to **On**.
  </Accordion>

  <Accordion title="Use Telegram on desktop during extended sessions">
    The Telegram desktop app (Mac, Windows, Linux) or web client lets you track the alert feed alongside your charting platform without picking up your phone. All alerts sync across devices in real time.
  </Accordion>

  <Accordion title="Use both Pushover and Telegram together">
    You can connect both Pushover and Telegram simultaneously. Some traders prefer Pushover for high-priority lock-screen alerts and Telegram for the searchable message history and deep links.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Pushover notifications" icon="mobile" href="/notifications/pushover">
    Set up Pushover for high-priority lock-screen alerts with configurable sound profiles.
  </Card>

  <Card title="Alerts settings" icon="sliders" href="/scanner/alerts">
    Control which setups, timeframes, and markets trigger your push notifications.
  </Card>
</CardGroup>