Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Telegram Bot

Configure your Telegram bot for notifications and commands.

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

You must add your User ID to the authorized list, otherwise the bot will ignore your messages for security reasons.

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

If the test is successful, you'll receive a confirmation message in Telegram. The bot is now ready to use!

Available Commands

Once configured, you can interact with your RestocksAIO instance using these commands:

/help

Shows a list of all available commands.

Example:

Response:

/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:

Response:

/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:

Response:

The response includes On/Off buttons for each notification type. Simply tap the button to toggle the setting - no need to type commands!

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."

/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:

Response:

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:

Response:

The response includes On/Off buttons - tap the button to change the setting.

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.

/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:

Response:

/bricker_start_all

Starts all Bricker Mode tasks. This command will initiate all stopped tasks across all controllers.

Example:

Response:

/bricker_stop_all

Stops all Bricker Mode tasks. This command will halt all running tasks across all controllers.

Example:

Response:

You can also use the Start All and Stop All buttons that appear when you run /bricker_stats for quick access to these controls.

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.

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.

/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).

USS must be linked to your Discord account first — the bot will reply with the OAuth link if it isn't.

/label <id>

Look up a single label by its OrderID and act on it directly — no need to scroll through pages.

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)

Error forwarding is disabled by default to prevent notification spam. Enable it only if you want to monitor application errors remotely.

Multiple User IDs

You can authorize multiple Telegram users to interact with your bot by entering multiple User IDs separated by commas:

Example:

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 <id> — 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

PreviousDiscord NotificationsNextProxy

Last updated

Was this helpful?