LiteShoper Telegram Shop — Full Guide

On this page

• Overview
• Requirements
• Installation
• Bot configuration
• Mini App
• Catalog
• Checkout
• Payments
• Orders & commands
• Digital products
• Notifications
• URLs
• Troubleshooting

Overview

LiteShoper Telegram Shop (liteshop-telegram) sells through Telegram using a Bot and Mini App. Orders are real LiteShoper Commerce orders with inventory, payments, and fulfillment hooks.

Capabilities

• Bot commands and inline product keyboards
• Mini App catalog, cart, checkout UI inside Telegram
• Telegram Payments (native invoice) or Stripe/PayPal fallback
• Digital-only checkout skips shipping
• Digital product delivery in chat after payment
• /orders command — order history and detail
• Tracking notifications when admin updates AWB
• Admin alerts for new Telegram orders

Requirements

• LiteShoper Commerce
• HTTPS (required for webhook and Mini App)
• Telegram bot from @BotFather
• Subscription license on liteshoper.com
• Stripe or PayPal plugin if using payment fallback

Installation

1. Subscribe → install liteshop-telegram.
2. Admin: Integrations → Telegram.

Bot configuration

Telegram → Settings

1. Create bot with @BotFather → copy token.
2. Paste bot token in settings → save (validates via getMe).
3. Enable Bot.
4. Click Set webhook — registers /telegram/webhook.
5. Optional: Admin chat ID for new-order alerts (your Telegram user ID).

Mini App

1. Enable Mini App in settings.
2. In BotFather → Bot Settings → Menu Button → set URL:
   https://your-store.com/telegram/app
3. Customers open full storefront inside Telegram.

Catalog

Telegram → Products — enable/disable which LiteShoper products appear in Telegram catalog. Only enabled products show in bot and Mini App.

Checkout

• Physical products: collect shipping address in Mini App or bot flow
• All-digital cart: shipping fields hidden automatically
• Creates standard Commerce order with Telegram source

Payments

Orders & commands

• Orders in Commerce → Orders (filter by Telegram source)
• Telegram → Orders — Telegram-specific view
• Customer command /orders — list recent orders, view detail, resend digital delivery

Digital products

When payment confirms, digital deliveries (from Commerce Digital or Digital Pro) can be sent as Telegram messages with keys and download links.

Notifications

• Order confirmed / paid messages to customer chat
• Shipped message with carrier + tracking URL when admin saves tracking
• Admin notification to configured chat ID on new order

URLs

Troubleshooting

• Webhook 401 — re-set webhook from settings
• Mini App 403 — enable Mini App in settings
• Telegram Payments fail — add provider token or enable Stripe/PayPal fallback
• Bot not responding — check Telegram → Logs; verify HTTPS certificate
• Products empty — enable products under Telegram → Products