Home / Docs / Telegram Mini App

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

Configuring the Bot Menu Button

  1. Go to OmniCommerce AI → Bot & Storefront in your dashboard.
  2. Ensure Enable the in-chat storefront Mini App is checked.
  3. Click the Setup Menu Button button. The plugin will immediately call Telegram's setChatMenuButton API 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