Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt

Use this file to discover all available pages before exploring further.

You want your customers to buy directly inside Telegram — DM the bot, get the product. No web shop in front, no marketing site. This playbook covers connecting a Telegram bot, configuring it for sales, and optionally hiding the web storefront entirely.

​
What you’ll have at the end

  • A Telegram bot connected to your Shoppex shop.
  • The bot answers buyer questions and creates payment links right in the chat.
  • Broadcasts and journeys to bring buyers back.
  • (Optional) The web storefront at yourshop.shoppex.io disabled, so the bot is the only sales channel.

​
Prerequisites

  • A Telegram bot you’ve created via @BotFather on Telegram. You’ll need its API token — the long string BotFather sends you after /newbot.
  • A Shoppex shop with at least one payment gateway connected.

​
Step 1 — Connect the bot

Open your Shoppex dashboard at Store → Telegram (/store/telegram).
  1. Click Connect bot or Add bot.
  2. Paste the bot token from BotFather.
  3. Save.
Shoppex verifies the token, fetches the bot’s profile, and registers it against your shop. The bot is now connected and listening.

​
Step 2 — Turn on the AI sales agent

In the same Telegram page, configure the bot’s Agent. There are three modes:
  • CUSTOMER_SALES — the bot talks to buyers, answers product questions, creates payment links when they want to buy.
  • MERCHANT_ASSISTANT — the bot is your own helper (DM the bot to check orders, get daily revenue, etc.). Not for buyers.
  • BOTH — same bot serves buyers and you, distinguished by who’s chatting.
For a sales-channel use case, pick CUSTOMER_SALES (or BOTH if you also want to use the bot yourself).

​
Step 3 — Test a purchase

DM your bot from a different Telegram account. Ask about a product, or just say “I want to buy X”. The agent will:
  1. Find the product in your catalog.
  2. Reply with the product info and a Pay now button.
  3. Tapping the button opens the Shoppex hosted checkout in Telegram’s in-app browser.
  4. The buyer pays through your normal gateways.
  5. Order confirmation is delivered both via email and (if the buyer linked Discord/Telegram to their customer profile) directly in the chat.
The payment itself happens on checkout.shoppex.io, not inside Telegram natively. The bot generates a Shoppex payment link and hands it over via an inline button.

​
Step 4 — Build out user management

Once buyers start interacting, the Users section of the Telegram dashboard fills up. You can:
  • See who’s chatted with the bot (with last-seen, total interactions).
  • Toggle per-user notification settings.
  • Build Segments — saved filters like “buyers in the last 30 days”, “VIPs over $500”.

​
Step 5 — Set up broadcasts and journeys

For ongoing engagement: Broadcasts are one-off announcements to a list. Draft a message, pick a segment or all users, schedule it for later, or send immediately. Statuses: DRAFT, SCHEDULED, SENDING, COMPLETED, CANCELLED, FAILED. Journeys are automated triggers — they fire when an event happens for a user. Available trigger types:
  • ORDER_COMPLETED — thank-you flow after a purchase.
  • ABANDONED_CART — nudge buyers who opened checkout but didn’t pay.
  • PAYMENT_REMINDER — invoice past due reminder.
  • SUBSCRIPTION_RENEWAL — renewal heads-up.
  • MANUAL — fired by you or the API on demand.
Journeys can branch and wait — e.g. “if buyer hasn’t paid after 4 hours, send the discount code”.

​
Step 6 — (Optional) Disable the web storefront

If you genuinely don’t want anyone hitting yourshop.shoppex.io, you can turn off the managed storefront from Settings → Shop. The field is managedStorefrontEnabled — set it to off, optionally provide a redirect URL (e.g. to your Telegram bot’s t.me link). After that, the public storefront URL no longer serves your shop. The Telegram bot is the only entry point. Payment links and direct checkout URLs still work fine — they’re independent of the storefront.

​
Common questions

“Can the bot accept payment directly in Telegram (no redirect)?” Not currently. Shoppex generates a Shoppex-hosted checkout URL and the bot sends it as an inline button. The buyer taps, pays in Telegram’s in-app browser. There’s no native Telegram Stars / native Telegram payments integration. “Can buyers manage their subscription from the bot?” Yes for queries via the agent (“show me my subscriptions”), but cancel/upgrade actions still go through their customer dashboard on Shoppex. “Multiple bots for the same shop?” Each shop can connect multiple bots — useful for testing in a separate bot before swapping the primary, or for running different language versions per bot.