> For the complete documentation index, see [llms.txt](https://docs.restock.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.restock.gg/features/affiliate-program/telegram-bot.md). # Telegram Bot

The Telegram Bot panel in Settings โ€” paste your BotFather token and authorized user IDs, then toggle which event types notify you.

RestocksAIO includes a Telegram bot integration that allows you to receive notifications and interact with your instance through Telegram commands. ## Getting Started ### Step 1: Create a Telegram Bot 1. Open Telegram and search for **@BotFather** 2. Start a conversation with BotFather and send `/newbot` 3. Follow the prompts to choose a name and username for your bot 4. BotFather will provide you with a **bot token** (e.g., `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`) 5. **Save this token** - you'll need it in the next step ### Step 2: Get Your Telegram User ID 1. Search for **@userinfobot** on Telegram 2. Start a conversation with @userinfobot 3. The bot will immediately reply with your **User ID** (a numeric value like `123456789`) 4. **Save this User ID** - you'll need it to authorize yourself {% hint style="warning" %} You must add your User ID to the authorized list, otherwise the bot will ignore your messages for security reasons. {% endhint %} ### Step 3: Configure in RestocksAIO 1. Open RestocksAIO and navigate to **Settings** 2. Click on **Telegram Bot** in the settings sidebar 3. Enter your **Bot Token** in the "Bot Token" field 4. Enter your **User ID** (or multiple IDs separated by commas) in the "Authorized User ID(s)" field 5. Configure notification preferences: * **Send Telegram notifications for Bricker Mode sales**: Enable to receive sale notifications * **Send Telegram notifications for new offers**: Enable to receive offer detection notifications * **Send generated labels to Telegram**: Enable to receive shipping labels as PDF attachments when labels are generated * **Send Telegram notifications for application errors**: Enable to forward application errors to Telegram (disabled by default) 6. Click **Save** to save your settings 7. Click **Test Bot** to verify the connection {% hint style="success" %} If the test is successful, you'll receive a confirmation message in Telegram. The bot is now ready to use! {% endhint %} ## Available Commands Once configured, you can interact with your RestocksAIO instance using these commands: ### `/help` Shows a list of all available commands. **Example:** ``` /help ``` **Response:** ``` Available commands: /info - Instance information /notifications - Notification toggles /notify_bricker_sales - Toggle Bricker Mode sales notifications /notify_offers - Toggle offer detection notifications /bricker_stats - Bricker stats snapshot /bricker_start_all - Start all Bricker tasks /bricker_stop_all - Stop all Bricker tasks /labels - Single labels โ€” paged, multi-select + Generate (with site & status filters) /bulk_labels - Bulks โ€” one bulk per page with its contents + Generate (with site & status filters) /scan - Open a scannable view (UPS rows with tracking) and submit to USS /label - Look up a single label by OrderID with Generate / Scan actions /help - Show this help message ``` ### `/info` Retrieves detailed information about your RestocksAIO instance, including: * **License Key**: Your current license key * **Subscription**: Your subscription type (Trial, Standard, Premium, or Lifetime) * **Server Connection**: Whether the instance is connected to the RestocksAIO server * **Database Status**: Status of the database connection * **Last Sync**: Time since last synchronization **Example:** ``` /info ``` **Response:** ``` ๐Ÿ“Š RestocksAIO Instance Information ๐Ÿ”‘ License Key: ABC123XYZ789 ๐Ÿ’ณ Subscription: Premium ๐ŸŒ Server Connection: โœ… Connected ๐Ÿ’พ Database Status: โœ… Online ๐Ÿ”„ Last Sync: Sync: Just now ``` ### `/notifications` Shows the current notification settings for your RestocksAIO instance with interactive buttons to toggle each setting: * **Bricker Mode Sales**: Whether notifications for Bricker Mode sales are enabled or disabled * **Offer Detections**: Whether notifications for offer detections are enabled or disabled * **Label Notifications**: Whether generated shipping labels are sent as PDF attachments * **Error Forwarding**: Whether application errors are forwarded to Telegram (disabled by default) **Example:** ``` /notifications ``` **Response:** ``` ๐Ÿ”” Notification Settings Bricker Mode Sales: โœ… Enabled Offer Detections: โœ… Enabled Error Forwarding: โŒ Disabled Tap a button to change the setting. ``` The response includes **On/Off buttons** for each notification type. Simply tap the button to toggle the setting - no need to type commands! {% hint style="info" %} Notification settings are saved immediately when you tap a button. The bot will confirm your change with a message like "โœ… Bricker Mode sales notifications enabled." {% endhint %} ### `/notify_bricker_sales` Shows the current status of Bricker Mode sales notifications with interactive **On/Off buttons** to toggle the setting. When enabled, you'll receive notifications whenever a sale is made through Bricker Mode. **Example:** ``` /notify_bricker_sales ``` **Response:** ``` Bricker Mode sales notifications are currently โœ… On. ``` The response includes **On/Off buttons** - tap the button to change the setting. ### `/notify_offers` Shows the current status of offer detection notifications with interactive **On/Off buttons** to toggle the setting. When enabled, you'll receive notifications when offers are detected on your listings. **Example:** ``` /notify_offers ``` **Response:** ``` Offer detection notifications are currently โœ… On. ``` The response includes **On/Off buttons** - tap the button to change the setting. {% hint style="info" %} Notification settings are saved immediately when you tap a button and will apply to all future notifications. You can check your current settings at any time using `/notifications`. {% endhint %} ### `/bricker_stats` Retrieves comprehensive statistics about your Bricker Mode tasks, including: * **Controllers**: Running, stopped, and total controller counts * **Tasks**: Running, stopped, sold, and error task counts * **Session Sales**: Total sales during the current session * **Session Errors**: Total errors encountered * **Queue**: Items currently in queue * **Lowest Ask**: Items with lowest ask vs. not lowest ask * **Price Changes**: Price changes in the last 24 hours The response includes **Start All** and **Stop All** buttons for quick control. **Example:** ``` /bricker_stats ``` **Response:** ``` ๐Ÿ“ˆ Bricker Mode Stats Controllers: 5 running / 2 stopped / 7 total Tasks: 12 running / 3 stopped / 8 sold / 1 errors Session Sales: 8 Session Errors: 1 Queue: 5 Lowest Ask: 10 | Not Lowest: 5 Price Changes (24h): 15 ``` ### `/bricker_start_all` Starts all Bricker Mode tasks. This command will initiate all stopped tasks across all controllers. **Example:** ``` /bricker_start_all ``` **Response:** ``` โ–ถ๏ธ Started all Bricker tasks. ``` ### `/bricker_stop_all` Stops all Bricker Mode tasks. This command will halt all running tasks across all controllers. **Example:** ``` /bricker_stop_all ``` **Response:** ``` โน Stopped all Bricker tasks. ``` {% hint style="info" %} You can also use the **Start All** and **Stop All** buttons that appear when you run `/bricker_stats` for quick access to these controls. {% endhint %} ## Label Dialog Commands The Telegram bot mirrors the desktop **Label Dialog** so you can refresh, generate, scan, and inspect labels from your phone. All four commands operate on the same underlying label set the WPF app uses โ€” selecting a row in Telegram also checks it in the desktop UI if you have the window open. {% hint style="info" %} **Label notifications must be enabled** (`Send generated labels to Telegram` toggle in Settings โ†’ Telegram Bot, or `/notifications` from the bot) for the PDF to land in the chat after `๐Ÿท๏ธ Generate`. The chat shown by these commands is interactive regardless. {% endhint %} ### `/labels` Opens the **singles** view โ€” every non-bulk label across all your configured sites, paged 5 per page. Each row shows the marketplace, SKU, product name, and size. Tap rows to multi-select, then use the action buttons at the bottom.

/labels โ€” singles view with multi-select, site + status filters, and the Generate / Scan action buttons.

**Filters (cycle buttons):** * **๐Ÿ“ Site** โ€” cycles `All โ†’ Alias โ†’ StockX โ†’ โ€ฆ` (only sites with currently-loaded singles appear). * **๐Ÿ“‹ Status** โ€” cycles `All โ†’ ToFullfill โ†’ Inhand โ†’ Arriving โ†’ Packed โ†’ InTransit`. Only statuses present in the data appear. The default sort is by status priority so **ToFullfill** and **Inhand** rows surface first, even when no status filter is set. **Actions:** * **๐Ÿ”„ Refresh** โ€” re-pulls sales/bulks from every configured marketplace (StockX, Alias, Klekt, Laced, HypeBoost, Sneakit, WeTheNew, LimitedResell, NordicSneakers, Kickscrew, Onfeet). * **๐Ÿท๏ธ Generate (N)** โ€” generates label PDFs for the N selected rows. With "Send generated labels to Telegram" enabled, the PDFs arrive in this chat right after. * **๐Ÿ“ท Scan (N)** โ€” submits the selected UPS rows with tracking to Scanuss (USS). Non-UPS rows are reported as ineligible. See `/scan` below. * **Clear selection** / **โŒ Close**. ### `/bulk_labels` Opens the **bulks** view โ€” one bulk per page with its full contents listed (SKU ยท product name ยท size for every item). Use the pager to walk through your bulks.

/bulk_labels โ€” one bulk per page, all the contained items listed, with the same Site + Status filters as /labels.

Same Site and Status filter cycles as `/labels`. The Generate button generates the displayed bulk's label in one tap โ€” no selection needed because each page **is** a single bulk. ### `/scan` Opens the same view as `/labels` but pre-filtered to **scannable rows only** โ€” UPS carrier with valid tracking, no `untrackable` placeholders. Identical UPS + tracking gate as the desktop "Send to USS" pill.

/scan โ€” scannable view filtered to UPS rows with tracking. Multi-select rows, then ๐Ÿ“ท Scan submits them to USS.

Multi-select the rows you want to submit, then tap **๐Ÿ“ท Scan (N)**. Each row consumes 1 USS credit. The status line afterwards reports submitted / failed / ineligible counts and, on failure, the rejection reason (e.g. insufficient credits, label URL missing). {% hint style="warning" %} USS must be linked to your Discord account first โ€” the bot will reply with the OAuth link if it isn't. {% endhint %} ### `/label ` Look up a **single label** by its OrderID and act on it directly โ€” no need to scroll through pages. ``` /label 58887372 ``` The bot replies with a card showing site, status, SKU, product name, size, tracking, and carrier. For bulks, the contents list is included. The action row at the bottom has **๐Ÿท๏ธ Generate label**, **๐Ÿ“ท Scan** (only when the row is UPS + tracking eligible), **๐Ÿ”„ Refresh**, and **โŒ Close**. ### Site & Status filters in detail

Both filters are cycle buttons โ€” one tap moves to the next value, wrapping back to All. The total row above updates to reflect the filtered count.

The filter buttons only include values **actually present** in the current data, so you never click into an empty bucket. Cycling on `/labels` resets pagination back to page 1; cycling on `/bulk_labels` resets to bulk 1. ## Notification Features ### Bricker Mode Sales Notifications When enabled, you'll receive rich notifications whenever a sale is made through Bricker Mode, including: * Product name and image * Site where the sale occurred * Style code (SKU) * Size * **Category** (`Resale`, `Direct`, or `Consign`) โ€” tells you which bricker bucket the sale came from * Store price and payout information * Order ID * Sale timestamp ### Offer Detection Notifications When enabled, you'll receive notifications when offers are detected on your listings, including: * Product name and image * Site where the offer was made * Style code (SKU) * Size * Offer amount and payout * Profit if accepted * **Accept Offer button** - Tap to accept the offer directly from Telegram ### Label Notifications When enabled, you'll receive generated shipping labels as PDF attachments directly in Telegram whenever a label is created, including: * Site where the label was generated * File name * The label file as a PDF attachment This is useful for quickly accessing your labels from your phone without needing to open the application or navigate to the labels folder. ### Error Forwarding When enabled (disabled by default), application errors will be automatically forwarded to Telegram, including: * Error type and function * Alert level (Warning or Important) * Error description * Solution description (if available) * Stack trace (truncated if too long) {% hint style="warning" %} Error forwarding is disabled by default to prevent notification spam. Enable it only if you want to monitor application errors remotely. {% endhint %} ## Multiple User IDs You can authorize multiple Telegram users to interact with your bot by entering multiple User IDs separated by commas: **Example:** ``` 123456789,987654321,555666777 ``` Each authorized user will be able to use all bot commands and receive notifications. ## Troubleshooting ### Bot Not Responding * **Check your Bot Token**: Make sure you copied the complete token from BotFather * **Verify User ID**: Ensure your User ID is correctly entered in the authorized list * **Test Connection**: Use the "Test Bot" button in settings to verify connectivity * **Check Bot Status**: Make sure the bot is running (it should start automatically when you save valid settings) ### "Unauthorized" Messages If you receive no response from the bot, it means your User ID is not in the authorized list: 1. Double-check your User ID using @userinfobot 2. Ensure the User ID is correctly entered in settings (no extra spaces) 3. Save settings and test again ### Connection Errors If you see connection errors: * Verify your internet connection * Check that Telegram is accessible from your network * Ensure the bot token is valid and hasn't been revoked * Try stopping and restarting the bot using the Test button ## Security Notes * **Keep your Bot Token secret**: Never share your bot token publicly * **Authorized Users Only**: Only users whose IDs are in the authorized list can interact with your bot * **Regular Updates**: Keep RestocksAIO updated to receive the latest security improvements ## Next Steps Once your Telegram bot is configured, you can: * Monitor your instance status remotely using `/info` * Receive real-time notifications for sales, offers, and errors * Control Bricker Mode tasks remotely using `/bricker_stats`, `/bricker_start_all`, and `/bricker_stop_all` * Drive the Label Dialog from your phone with `/labels`, `/bulk_labels`, `/scan`, and `/label ` โ€” refresh sales, generate label PDFs, create bulks, and submit UPS labels to USS, all without opening the desktop app * Toggle notification settings easily using interactive buttons * Accept offers directly from Telegram notifications * Interact with your RestocksAIO instance from anywhere