Skip to main content
H

How-to guide

Business owners

How to Connect Telegram AI Sales Agent

Connect a Telegram bot, enable AI replies, configure persona and order rules, then test a real customer conversation before going live.

Released

Overview

Telegram is the first released channel for the Billions+ AI Sales Agent. Once Telegram is connected, the AI can reply to customers, answer catalog questions, recommend products, collect order information, and create orders from the conversation.

Before enabling AI replies, make sure the business has a clean product catalog. The AI should answer from real products and real business information, so incomplete catalog data will create weaker sales conversations.

Before You Start

  • You need access to the Billions+ dashboard for the business.
  • You need a Telegram bot for the business.
  • The business should have products with names, prices, descriptions, and images.
  • The AI Sales Agent feature must be enabled for the business plan or add-on.
  • The global AI Sales Agent feature flag must be available in the environment.

Step 1. Connect Telegram

Open the business dashboard and go to the integration settings. Connect the Telegram bot used by the business. When Telegram is connected, the business record exposes Telegram availability to the AI Sales Agent page.

The AI enable toggle depends on this connection. If Telegram is not connected, the toggle remains disabled and the page should guide the owner back to integration setup.

Step 2. Open AI Sales Agent Settings

Go to the AI Sales Agent page for the active business. The page loads the current AI configuration from the business-scoped API. If the feature is not available for the business, the dashboard should show the locked state instead of allowing configuration.

This is where the owner confirms the feature is available, checks the current configuration, and starts shaping how the AI should sell.

Step 3. Choose The AI Persona

Open the Behaviour tab and choose the persona that matches the business. A fashion business may choose a warmer sales style. A technical shop may choose a more precise explanation style. A premium business may choose a polished, minimal tone.

Use the persona preview before saving so the owner understands how the AI will sound to customers.

Step 4. Review Long Message Behavior

Configure the response used when a customer sends a message that is too long for safe AI handling. This fallback should be polite and should guide the customer to a shorter, clearer request.

Step 5. Configure Order Rules

Open the Orders tab and choose what information the AI must collect before creating an order. The common required fields are name, phone number, address, and quantity.

If the business wants stronger control, enable owner approval for AI-created orders. This lets the AI prepare the order while the owner remains responsible for final review.

Step 6. Save Changes

Save the configuration. The dashboard sends the full draft configuration to the AI config API and refetches the saved state after success.

If saving fails, fix any displayed error and save again. Do not enable AI for live customers until the saved configuration reflects the intended persona and order rules.

Step 7. Test A Real Conversation

Send a test message from Telegram as a customer. Ask about a product, price, delivery, or availability. Confirm that the AI uses real catalog information and asks for required order details before creating an order.

Then review the order in Billions+. If approval is required, confirm that the AI-created order appears with the correct approval state and source context.

Troubleshooting

The Enable Toggle Is Disabled

Telegram is probably not connected for the active business. Return to integration settings and finish the Telegram connection first.

The AI Answers With Weak Product Details

Review the product catalog. Add clearer descriptions, categories, tags, images, and prices. The AI can only sell confidently from accurate business data.

The AI Creates Orders Too Early

Require more order fields or enable owner approval. The Orders tab controls how much information the AI must collect before creating an order.

The AI Should Stop Replying

Pause AI replies from the conversation or disable the master AI replies toggle for the business.

  • Feature: AI Sales Agent
  • Feature: Product Management
  • Feature: Order Management
  • Sub-feature: Business Knowledge
  • Sub-feature: AI Sales Playbook
  • Sub-feature: Customer Follow-up