Telegram Mini App Storefront
Configure the Telegram WebApp in-chat storefront, persistent bot menu buttons, live catalogue caching, and mobile cart interactions.
How the Mini App Operates
The Mini App is a standalone, lightweight WebApp hosted directly by your WordPress site via StorefrontEngine (triggered by ?wc_telegram_miniapp=1).
- No WordPress Chrome: Bypasses heavy theme scripts and admin bars for instant under-200ms mobile loads.
- Telegram Theme Sync: Automatically detects the user's Telegram Dark/Light theme colors via CSS custom properties.
- MainButton Integration: Binds Telegram's native sticky bottom
MainButtonto dynamically display cart subtotals and trigger checkout.
Configuring the Bot Menu Button
- Go to OmniCommerce AI → Bot & Storefront in your dashboard.
- Ensure Enable the in-chat storefront Mini App is checked.
- Click the Setup Menu Button button. The plugin will immediately call Telegram's
setChatMenuButtonAPI method to link the WebApp URL to your bot's persistent chat menu.
Mini App Storefront Capabilities
Storefront Features
• Real-time product search with 350ms debounce
• Category chip filters populated directly from WooCommerce taxonomy
• Product variant selector sheet for variable products (sizes, colors, models)
• Cart bottom-sheet drawer with quantity steppers and live totals
• Header cart count badge with real-time reactive updates
• Prefilled customer profile data from Telegram initData
• Native in-app checkout supporting 5+ payment gateways
Previewing Your Storefront
You can preview the storefront in any desktop or mobile browser by visiting:
https://your-store.com/?wc_telegram_miniapp=1