Skip to Content
DocsBot & IntegrationsOverview

Bot Setup

A bot enables payments, notifications, inline search, and advanced features for your ShopsBuilder store.

Creating Your Bot

Step 1: Use BotFather

  1. Open @BotFather  in Telegram
  2. Click Start and send /newbot
  3. Choose a bot name and username (must end with bot or _bot)
  4. BotFather provides a TOKEN — copy this token

Example token: 987654321:AABbCCDd_eE11fFgGhHiIJJKKllMMNNOOPp

Step 2: Create a Group for Orders

Create a Telegram group where order notifications will be sent:

  1. Create a new group in Telegram
  2. Name it something clear (e.g., “My Shop Orders”)
  3. You’ll add the bot to this group during store setup

Step 3: Connect Bot to Your Store

  1. Open @ShopsBuilderBot 
  2. Click Start → Open → Add → Create Store
  3. Choose Connect Personal Bot
  4. Paste your BOT TOKEN
  5. Add the bot to your order management group
  6. Click Refresh

Bot Features

Direct Chat Setup

Payments

Your bot can process these payment methods:

  • Telegram Stars — Native Telegram currency
  • TON blockchain — Cryptocurrency payments
  • Bank cards — Through supported payment providers (Premium)
  • Cash/card transfers — Direct transfers to personal cards

Payment Notifications:

When customers pay via TON or Telegram Stars, you’ll receive automatic notifications in your order group. For card or cash transfers, arrange with the customer to notify you after payment.

Order Notifications

When customers place orders, your bot automatically sends:

  • Order confirmation — Details of items purchased
  • Payment received — Confirmation that payment went through
  • Order status updates — Shipping, delivery, and completion

All notifications go to your order management group for easy tracking.

Customers can search for products through your bot without opening your store:

@your_bot search product_name

The bot returns product links that can be shared anywhere in Telegram:

  • Private messages
  • Closed groups
  • Open channels
  • Any Telegram chat

To enable inline search:

  1. Go to @BotFather
  2. Select your bot
  3. Go to Bot Settings → Inline Mode
  4. Turn inline mode ON
  5. Optional: Set a custom placeholder (e.g., “I’m looking for…”)

How customers use it:

  1. Type your bot’s username in any chat
  2. Enter at least 3 letters of a product name
  3. Select a product from the dropdown
  4. Send it to share the product card

Group Order Management

Orders are collected in your group chat with:

  • Product details — Items, prices, quantities
  • Customer information — Contact details and delivery info
  • Links to customer threads — When customers have questions
  • Payment confirmation — Automatic for TON/Stars

With Customer Support enabled:

  • Each customer gets their own thread for questions
  • Orders stay in the General section
  • Quick access to customer conversation history

Newsletters

Send promotional messages to your customers:

  • Broadcast messages to all customers or specific segments
  • Use your store’s avatar for branding
  • Include welcome messages for new visitors
  • Add inline buttons with links to products, promotions, or your shop

Newsletter features:

  • Subject lines for clear messaging
  • Button options: Inline, App, or Shop button
  • Scheduling for optimal send times
  • Test messages before sending

AI Business Assistant

Your bot can include an AI-powered assistant that helps with customer support, sales, and product recommendations.

AI Agent Configuration

Setup steps:

  1. Enable Direct Chat via Bot for two-way customer communication
  2. Check your AI Tokens balance
  3. Enable the AI Agent toggle
  4. Configure your agent’s role, tasks, and behavior
  5. Test the agent by chatting as a customer

The AI assistant can handle:

  • Product questions and recommendations
  • Order status inquiries
  • Basic customer support
  • Sales assistance

Order Channel Integration

You can link a Telegram channel where notifications about new orders are automatically published.

To set up:

  1. Prepare a Telegram channel for order notifications
  2. Get the channel ID
  3. Send the channel ID and bot name to @ShopDevTeam
  4. Our team will configure the integration

This is great for:

  • Monitoring orders in real-time
  • Team collaboration on order processing
  • Keeping multiple team members informed

Token Management

What is a Token?

A token is a secret key that identifies your bot. Think of it as your bot’s unique password.

Where is the Token Stored?

The token is stored in ShopsBuilder’s secure system. Never share your token publicly.

Can I Change the Token?

If you regenerate your bot’s token in BotFather, you can update it in your shop settings.

What if My Bot is Banned?

If Telegram bans your bot:

  1. Create a new bot in BotFather
  2. Get the new token
  3. Update it in your store settings

Troubleshooting

Bot isn’t responding

  1. Verify the bot is running — try starting a conversation with it
  2. Check if the token is correct in store settings
  3. Make sure the bot has admin rights in the group

Commands not working

Ensure you’re sending commands to the correct bot username. Check for typos in @username.

Next Steps

Last updated on
FeaturesInline Search