Deep Links & Sharing
The bot registers two commands — /start and /admin. Deep links and inline mode let you and your customers share products anywhere.
Bot commands
| Command | Who | What it does |
|---|---|---|
/start | Everyone | Welcome message with Open Shop button. Admin also sees an Admin Dashboard button. |
/admin | Admin only | Opens the Admin Mini App directly. |
The Shop menu button in the Telegram input bar opens the Customer Mini App for everyone. The admin sees Admin instead, opening the Admin Mini App.
Deep links
Link directly to a specific product:
https://t.me/yourbotname?start=product_PRODUCT_IDWhen a customer taps the link, it opens the bot and lands straight on that product inside the Mini App.
Where to use them
- Social media — share a product link on X, Nostr, or any platform
- QR codes — print them at events, on flyers, or on packaging
- Group messages — pin a product link in a Telegram group
- Websites — embed product links on your blog or landing page
Finding the product ID
Product IDs come from the Inventory extension. You can find them in the Inventory admin panel or through the API.
Inline mode
Customers can share products directly in any Telegram chat. Type @yourbotname followed by a search term in any conversation — the bot suggests matching products as inline results.
How it works
- Customer types
@yourbotname pizzain a chat - The bot shows matching products as a result list
- Customer taps a result to send it into the chat
- The recipient taps the result to open the product in the Mini App
Share button in the Mini App
The product detail view includes a Share button. Tapping it triggers Telegram's inline sharing picker, letting the customer choose which chat to share the product in. On platforms where the picker isn't available, the product link is copied to the clipboard instead.
Notifications
Customer notifications
Sent via Telegram with buttons that open the Customer Mini App:
| Notification | When | Button |
|---|---|---|
| Payment confirmed | Order paid | Open Orders |
| Fulfillment update | Status changes (preparing → shipping → delivered) | Open Orders |
| Admin reply | Shop owner replies to a message | Open Messages |
| Return approved (credit) | Return refunded as store credit | Open Orders |
| Return approved (Lightning) | Return approved for Lightning refund | Open Messages |
| Return denied | Return request denied | Open Orders |
Admin notifications
Sent to the admin chat ID with buttons that open the Admin Mini App on the relevant screen:
| Notification | When | Opens |
|---|---|---|
| New paid order | Customer pays | Order detail |
| Customer message | Customer sends a message | Message thread |
| Return request | Customer requests a return | Order detail |