> For the complete documentation index, see [llms.txt](https://docs.squadswap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.squadswap.com/platform/products/automated-liquidity-manager/automated-liquidity-manager-for-advanced-users/telegram-bot-integration.md).

# Telegram Bot Integration

#### **Manage Your Liquidity Strategies in Your Pocket!**

The Automated Liquidity Manager Telegram Bot provides instant access to your liquidity strategies no matter where you are. Get real-time alerts, performance snapshots, interactive charts, and a comprehensive suite of management tools directly on Telegram.\
\
**1. Setup and Connection**

You can link your Telegram account to Automated Liquidity Manager in **two alternative ways**:

* By entering your Telegram ID in the dashboard
* Or directly from the Telegram bot using the `/link` command

Both methods are secure and lead to the same result.

**Method 1 – Link via Dashboard (Enter Telegram ID manually)**

1. Find your Telegram User ID:
   * Search for **@userinfobot** or **@GetMyIDBot** in Telegram
   * Tap **Start** or send /start
   * The bot will immediately reply with your numeric ID (e.g. 123456789). Copy this number.

<div align="center"><figure><img src="/files/ZcLwQiHKKnE5c5YqhmNi" alt="" width="563"><figcaption></figcaption></figure></div>

2. Log in to your **Automated Liquidity Manager Dashboard**.
3. Click your **Profile icon** (top-right) → go to the **Account** tab.
4. Paste your Telegram ID into the **Telegram ID** field and click **Save Changes**.

<figure><img src="/files/8iQllDcHvMypLlZF2U4m" alt=""><figcaption></figcaption></figure>

5. Now open Telegram again:

* Search for the official bot: **@SquadPosmanBot**
* Tap **Start**

→ Connection complete! You’ll start receiving alerts automatically, and all commands will become available.

**Method 2 – Link directly in the bot (Recommended – usually faster)**

1. In Telegram, search for **@SquadPosmanBot** and tap **Start**.
2. Go back to your **Automated Liquidity Manager Dashboard** → **Account** tab (or profile settings).
3. Find your unique **linking code** displayed there (it looks like: **12345abc**).

<figure><img src="/files/zX50kC6pskWkuwuQmipg" alt=""><figcaption></figcaption></figure>

4. Send the `/link` command followed by your unique code:

```
/link 12345abc
```

5. Once the bot confirms the link (usually within seconds), you’re all set.

→ Alerts and management commands will start working immediately.

#### 2. Instant Management Commands

Use these commands to interact with your strategies instantly. Every command response includes interactive inline keyboard buttons for quick navigation between related commands.

<table><thead><tr><th width="149.2890625">Command</th><th width="158.5">Action</th><th>Description</th></tr></thead><tbody><tr><td><code>/summary</code></td><td>Portfolio Snapshot</td><td>Displays high-level information including Total TVL, total fees collected, Win Rate, and the number of total/active/archived V4 strategies. Shows an alert if any strategies are currently closed.</td></tr><tr><td><code>/performance</code></td><td>Profit Tracking</td><td>Provides a breakdown of position updates and fees collected (in USD) over the last 24 hours, 7 days, and 30 days, plus all-time totals, Win Rate, and Total TVL.</td></tr><tr><td><code>/strategies</code></td><td>All V4 Strategies</td><td>Provides a complete list of all your V4 strategies (active and closed) with status indicators (✅/❌) and clickable links to each strategy's detailed report page on the dashboard.</td></tr><tr><td><code>/top</code></td><td>The Leaderboard</td><td>Lists your <strong>top 5</strong> V4 strategies ranked by TVL, showing pair names, repositioning counts (30-day), and TVL values.</td></tr><tr><td><code>/active</code></td><td>List Active V4 Strategies</td><td>Provides a list of active V4 strategies with pair names, TVL values, and short strategy IDs.</td></tr><tr><td><code>/status</code></td><td>Portfolio Status</td><td>Displays portfolio metrics with a visual status breakdown: total, running, and archived strategy counts. Each strategy shows a status icon (🟢 Active, ⏸️ Paused, 🟡 Starting, 🟠 Inactive) along with its pair name and short address.</td></tr><tr><td><code>/alerts</code></td><td>Health Check</td><td>Lists all pending alerts for your team with severity indicators (🔴 Error, ⚠️ Warning, ℹ️ Info). Shows alert names and messages. Personal alerts (e.g. gas) are only visible to the alert owner.</td></tr><tr><td><code>/v4status</code></td><td>Bin Range Check</td><td>Shows whether each V4 strategy's position is currently Open or has No Position, along with the min/max bin range boundaries.</td></tr><tr><td><code>/errors</code></td><td>System Health</td><td>Displays system health status and any detected issues.</td></tr><tr><td><code>/pauseall</code></td><td>Pause All Strategies</td><td>Pauses all currently active V4 strategies. Asks for confirmation before executing. Shows the count of strategies that will be affected.</td></tr><tr><td><code>/explore</code></td><td>Interactive Strategy Explorer</td><td>Opens an interactive wizard that lets you browse your V4 strategies using inline buttons. Select any strategy to view its full details including:<br>• Status, APR, and TVL at a glance<br>• Cached fees (24h, 7d, 30d, all-time)<br>• Configuration (vault share, daily limit)<br>• Strategy address and manager address<br>• Auto-generated charts:<br>→ Generated Volume (30d bar + cumulative line chart)<br>→ Inventory PnL % (30d area chart)<br>→ Inventory Normalized Balances per token<br>→ Inventory PnL Change per period (green/red bar chart)<br>→ Liquidity Distribution across bins (horizontal bar chart with active bin highlighted)</td></tr><tr><td><code>/inspect [id]</code></td><td>Deep Dive</td><td>Provides details for one specific V4 strategy including bin range, vault share (in bps), TVL, and unclaimed fees. Usage: <code>/inspect 0x123...</code></td></tr><tr><td><code>/find [token]</code></td><td>Token Search</td><td>Finds and lists all V4 strategies that involve a specific token. Usage: <code>/find USDC</code></td></tr><tr><td><code>/logs</code></td><td>Recent Activity Log</td><td>Shows the 10 most recent activities across your strategies, including event names, pair labels, fee collection indicators (💰), enter/exit markers (📌), and relative timestamps (e.g. "5m ago", "2h ago").</td></tr><tr><td><code>/getgasbalance</code></td><td>Gas Balance Check</td><td>Returns your current native gas token balance for both BSC (BNB) and Base (ETH) chains, including USD equivalent values. Displays ✅/❌ status indicators and warns if any chain's balance is below the minimum threshold.</td></tr><tr><td><code>/link &#x3C;code></code></td><td>Account Linking</td><td>Securely links your Telegram account to your Automated Liquidity Manager account using your unique linking code from the Dashboard. (Profile → Account → Telegram Bot).</td></tr><tr><td><code>/help</code></td><td>Help Center</td><td>Lists all available commands organized by category (Daily Routine, Risk &#x26; Management, Deep Dive, Utility) with short explanations and a link to this documentation.</td></tr><tr><td><code>/start</code></td><td>Welcome Screen</td><td>Displays a welcome message with quick-start instructions and inline keyboard buttons for the most common commands.</td></tr></tbody></table>

#### **3.** Notification Preferences

You can customize which notifications you receive and on which channels.\
\
Go to **Dashboard** → **Profile** → **Account** → **Notifications** to configure your notification settings.

Each notification scenario can be independently toggled for two channels:

**Dashboard** – Controls whether the alert appears in your dashboard's alert panel.\
**Telegram** – Controls whether the alert is pushed to your Telegram bot chat.\
\
Available Notification Scenarios:

<table><thead><tr><th width="124.71875">Category</th><th width="158.37109375">Scenario</th><th>Description</th><th>Severity</th></tr></thead><tbody><tr><td><code>Position</code></td><td>Position entered</td><td>A strategy opened a liquidity position (LP started).</td><td>ℹ️ Info</td></tr><tr><td><code>Position</code></td><td>Position inactive</td><td>A strategy has no open position (idle / out of range / closed).</td><td>⚠️ Warning</td></tr><tr><td><code>Position</code></td><td>Strategy paused</td><td>A strategy is paused and will not rebalance.</td><td>ℹ️ Info</td></tr><tr><td><code>Gas</code></td><td>Gas balance low</td><td>Your gas deposit balance is running low; top up to avoid interruptions.</td><td>⚠️ Warning</td></tr><tr><td><code>Gas</code></td><td>Gas exhausted</td><td>Your gas balance is depleted; strategies are blocked until you deposit.</td><td>🔴 Critical</td></tr><tr><td><code>Rebalance</code></td><td>Strategy repeatedly failing</td><td>A strategy keeps failing to rebalance (escalating backoff).</td><td>⚠️ Warning</td></tr></tbody></table>

You can set **per-strategy** overrides by clicking the **notification bell** icon on any strategy card in the dashboard. This opens a dialog where you can configure position-specific notification settings that override your account-level defaults.

**Note:** Gas-related alerts are **personal** - only the gas balance owner sees them. Strategy alerts are **team-wide** and visible to all team members.

Muting rules follow a specificity hierarchy (most specific wins):

1. Per-scenario + per-strategy preference
2. All-scenarios + per-strategy preference ("mute everything for this position")
3. Per-scenario + global (no strategy) preference
4. All-scenarios + global preference ("mute all notifications")
5. Scenario default (if no preference exists)

#### &#x34;**.** Real-Time Smart Notifications

The bot proactively monitors your portfolio and sends alerts every 10 minutes for critical events. Alerts are delivered based on your notification preferences.\
\
**🔴 Critical Alerts (Immediate Action Required)**

* **Gas Exhausted:** Your gas balance is depleted; strategies are blocked until you deposit more gas.
* **Failed Rebalancing:** Alerts you when a strategy repeatedly fails to rebalance its position (escalating backoff applied).

⚠️ **Warning Alerts**

* **Position Inactive:** Notifies you when a strategy has no open position - it may be idle, out of range, or closed.
* **Gas Balance Low:** Your gas deposit balance is running low; top up to avoid interruptions.
* **Strategy Parked:** A V3 strategy cannot run because its placement reference is not set (V3 only).
* **Strategy Repeatedly Failing:** A strategy keeps failing to rebalance, with escalating backoff.

ℹ️ **Informational Updates**

* **Position Entered:** Confirmation that a strategy successfully opened a new liquidity position.
* **Strategy Paused:** A strategy has been paused and will not rebalance until resumed.

⚠️ **System / Ops Alerts**\
System-level alerts (such as operator balance issues or deposit-address mismatches) are automatically sent to the configured ops Telegram chat IDs (OPS\_TELEGRAM\_CHAT\_IDS environment variable) rather than individual user accounts.

#### 5. Interactive Navigation

Every command response includes contextual inline keyboard buttons that let you quickly navigate to related commands without typing. For example:

After */summary* you'll see buttons for **Performance, Alerts, Strategies, and Help**.

After */active* you'll see buttons for **All Strategies, Top, Find, and Pause All**.

The */explore* wizard provides **Back** and **Cancel** buttons for seamless browsing.

If your account is not linked, every command response includes a direct "Open Dashboard" button that links to the account settings page for quick linking.

#### 6. Multi-Chain Support

The bot supports strategies running on multiple blockchain networks:

**BSC (BNB Chain)** (native token: BNB) **Base** (native token: ETH)

The */getgasbalance* command shows your balance on both chains. V4 strategy data, bin distributions, and on-chain reads are performed on the correct chain based on each strategy's configuration.

#### 7. Strategy Charts (via /explore)

When you select a strategy in the */explore* wizard, the bot automatically generates and sends visual charts using QuickChart:

**Generated Volume (30d):** Bar chart showing daily estimated volume routed through the strategy, with a cumulative volume overlay line. Only shown when fee data is available and the pool fee is static (non-dynamic).

**Inventory PnL % (30d):** Area chart displaying the percentage change in your current position value versus total net deposits over time.

**Inventory Normalized Balances:**\
Two separate line charts (one per token) showing: \
• Net deposit baseline (dashed) \
• Normalized baseline (dotted) \
• Current inventory-normalized balance (solid)

**Inventory PnL Change per Period:** Bar chart with green (positive) and red (negative) bars showing period-over-period performance changes.

**Liquidity Distribution:** Horizontal bar chart showing the percentage allocation of your liquidity across bin IDs. The active bin is highlighted in green, while other bins appear in indigo. Shows price range labels derived from bin step calculations.

#### 8. Frequently Asked Questions (FAQ)

**Q: The bot isn't responding to my commands.**

**A:** First, ensure you have pressed Start in the bot chat. Second, double-check that the Telegram ID entered in your Account settings matches exactly what @userinfobot provided. If using the /link method, make sure you copied the full 8-character code from the Dashboard.

**Q: Can I add the bot to a group?**

**A:** Yes! You can add the bot to a private group with your team. Note that for security, the bot is configured to respond only to the authorized user linked to the account.

**Q: Is my data safe?**

**A:** Yes. The bot displays read-only data from your Dashboard. It cannot execute withdrawals or modify contract ownership. The only action command is /pauseall, which requires explicit confirmation before execution.

**Q: Why do I need to enter my ID manually?**

**A:** Telegram does not automatically share user IDs with external websites for privacy reasons. Manually entering your ID ensures that only you can link your specific Telegram account to your dashboard securely.

**Q: What happens when I run /pauseall?**

**A:** The bot will first show you the number of active strategies and ask for confirmation. Once confirmed, it pauses all active V4 strategies. This is useful in emergency situations where you want to quickly stop all automated operations.

**Q: How do I customize which alerts I receive?**

**A:** Go to Dashboard → Profile → Account → Notifications to set global defaults. You can also override settings per individual strategy by clicking the notification bell icon on the strategy card. Each alert type can be independently toggled for Dashboard and Telegram channels.

**Q: What chains does the bot support?**

**A:** The bot supports BSC (BNB Chain) and Base. Your gas balance is tracked separately for each chain, and V4 strategy operations are performed on the correct chain automatically.

**Q: I'm not receiving any Telegram alerts anymore.**

**A:** Check your notification preferences in the Dashboard. You may have muted Telegram notifications globally or for specific scenarios. Also ensure your gas balance is sufficient - if strategies can't operate, fewer alerts will be generated.