Telegram Bot

RestocksAIO has a Telegram bot. Use it to receive notifications and control your instance with 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 gives you 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 replies immediately with your User ID (a numeric value like 123456789)
4. Save this User ID - you'll need it to authorize yourself

Step 3: Configure in RestocksAIO

1. Open RestocksAIO and go 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. Set your 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 check the connection

Available Commands

After setup, you can control your RestocksAIO instance with 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 <id> - Look up a single label by OrderID with Generate / Scan actions
/help - Show this help message

/info

Shows detailed information about your RestocksAIO instance, including:

• License Key: Your current license key
• Subscription: Your subscription type (Trial, Standard or Premium)
• 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 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. Tap the button to toggle the setting. You do not need to type commands.

/notify_bricker_sales

Shows the current status of Bricker Mode sales notifications, with On/Off buttons to toggle the setting. When enabled, you receive a notification 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 On/Off buttons to toggle the setting. When enabled, you receive a notification when an offer is 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.

/bricker_stats

Shows 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 starts 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 stops all running tasks across all controllers.

Example:

/bricker_stop_all

Response:

⏹ Stopped all Bricker tasks.

Label Dialog Commands

The Telegram bot gives you the desktop Label Dialog on your phone, so you can refresh, generate, scan, and check labels there. All four commands use the same label set as the desktop (WPF) app. A selection in Telegram belongs to that chat only. When Telegram generates labels, the desktop selection changes to the generated rows.

/labels

Opens the singles view. It shows every non-bulk label across all your configured sites, 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.

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 appear first, even when no status filter is set.

Actions:

• 🔄 Refresh — loads sales/bulks again from every configured marketplace (StockX, Alias, KLEKT, Laced, HypeBoost, WeTheNew, LimitedResell, NordicSneakers, KICKS CREW, 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. It shows one bulk per page with its full contents (SKU · product name · size for every item). Use the pager to go through your bulks.

It has the same Site and Status filter cycles as /labels. The Generate button generates the displayed bulk's label in one tap. You do not need to select anything, because each page is a single bulk.

/scan

Opens the same view as /labels, filtered to scannable rows only: UPS carrier with valid tracking, no untrackable placeholders. This is the same UPS + tracking rule as the desktop "Send to USS" pill.

Select the rows you want to submit, then tap 📷 Scan (N). Each row uses 1 USS credit. The status line then reports submitted / failed / ineligible counts. On failure, it also reports the rejection reason (e.g. insufficient credits, label URL missing).

/label <id>

Look up a single label by its OrderID and act on it directly. You do not 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

The filter buttons only include values actually present in the current data, so a filter never gives an empty list. A filter change on /labels returns you to page 1. A filter change on /bulk_labels returns you to bulk 1.

Notification Features

Bricker Mode Sales Notifications

When enabled, you receive a detailed notification whenever a sale is made through Bricker Mode. It includes:

• Product name and image
• Site where the sale occurred
• Style code (SKU)
• Size
• Category (Resale, Direct, or Consign) — shows which Bricker category 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 receive each generated shipping label as a PDF attachment in Telegram when the label is created. The message includes:

• Site where the label was generated
• File name
• The label file as a PDF attachment

Use this to get your labels on your phone without opening the application or the labels folder.

Error Forwarding

When enabled (disabled by default), application errors are forwarded to Telegram automatically. Each message includes:

• Error type and function
• Alert level (Warning or Important)
• Error description
• Solution description (if available)
• Stack trace (truncated if too long)

Multiple User IDs

To authorize several Telegram users to use your bot, enter their User IDs separated by commas:

Example:

123456789,987654321,555666777

Each authorized user can 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: Make sure your User ID is entered correctly in the authorized list
• Test Connection: Use the "Test Bot" button in settings to check the connection
• 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, your User ID is not in the authorized list:

1. Check your User ID again with @userinfobot
2. Make sure the User ID is entered correctly in settings (no extra spaces)
3. Save settings and test again

Connection Errors

If you see connection errors:

• Check your internet connection
• Check that you can reach Telegram from your network
• Make sure the bot token is valid and hasn't been revoked
• Try to stop and restart the bot with 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

After your Telegram bot is set up, you can:

• Check your instance status remotely with /info
• Receive real-time notifications for sales, offers, and errors
• Control Bricker Mode tasks remotely with /bricker_stats, /bricker_start_all, and /bricker_stop_all
• Use the Label Dialog from your phone with /labels, /bulk_labels, /scan, and /label <id>. You can refresh sales, view existing bulks, generate their label PDFs, and submit UPS labels to USS without opening the desktop app. You cannot create new bulks through Telegram
• Toggle notification settings with buttons
• Accept offers directly from Telegram notifications
• Use your RestocksAIO instance from anywhere