# 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, 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.
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**.
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**).
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: | Command | Action | Description | | ---------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `/performance` | Profit Tracking | Provides a breakdown of fees collected over the last 24 hours, 7 days, and 30 days. | | `/summary` | Portfolio Snapshot | Displays high-level information like Total TVL, number of active/total strategies, and Win Rate. | | `/top` | The Leaderboard | Lists your **top 5** performing strategies based on performance. | | `/active` | List Active Strategies | Provides a list of active strategies. | | `/strategies` | All Strategies | Provides a complete list of all your active and closed strategies with direct dashboard links. | | `/status` | Portfolio Status | Displays portfolio metrics, full strategy list with their open/closed states, and any ongoing systemic alerts. | | `/inspect [id]` | Deep Dive | Provides full details for one specific strategy (tick ranges, vault share, TVL, etc.). Usage: `/inspect 0x123...` | | `/find [token]` | Token Search | Finds and lists all strategies that involve a specific token. Usage: `/find USDC` | | `/alerts` | Health Check | Lists all "At Risk Strategies" (inactive but not archived positions) and system warnings. | | `/v4status` | Bin Range Check | (V4 only) Shows whether the price is currently Inside or Outside your current Bin Range. | | `/errors` | Error Log | Displays recent failed transactions or strategy execution errors. | | `/help` | Help Center | Lists all available commands with short explanations. | | `/getgasbalance` | Gas Balance Check | Returns your current native gas token balance (e.g., BNB) for the wallet linked to your account. | | `/link ` | Account Linking | Securely links your Telegram account to your Automated Liquidity Manager account using your unique linking code from the Dashboard. | #### **3. Real-Time Smart Notifications** The bot proactively monitors your portfolio and sends alerts for critical events.\ \ **🔴 Critical Alerts (Immediate Action Required)** * **Out of Range:** Notifies you the exact moment your V3 or V4 position stops collecting fees because the price moved beyond your boundaries. * **Failed Repositioning:** Alerts you if an automated management transaction (Force Push) fails (Highest Priority). * **Safety Trigger:** Notification if a strategy is paused due to extreme price volatility (Max Deviation exceeded). **🟢 Status Updates (Informational)** * **Bin Edge Proximity:** Sends a warning when the market price is within 5 bins/ticks of your range edge. * **Repositioning Success:** Confirmation that your strategy has successfully moved its liquidity to follow the market. * **Vault Milestone:** Positive performance notifications (e.g., crossing a fee milestone). ⚠️ **Gas Balance Alerts** * If your gas balance falls below the minimum threshold, the bot sends a notification every 10 minutes via Telegram to warn you. #### 4. 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. **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. It acts strictly as a monitoring and reporting tool. **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. --- # 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.squadswap.com/platform/products/automated-liquidity-manager/automated-liquidity-manager-for-advanced-users/telegram-bot-integration.md?ask= ``` 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.