Setup Guide & Docs

Everything you need to put Kotha AI to work for your shop — from registration to automated customer messaging and order bookings across Website, Messenger, WhatsApp, and Telegram.

1. Quick start

  1. 1Create a free account with your email and business name — this business name is displayed to customers in chat.
  2. 2Your account starts with an isolated workspace — your catalog, knowledge base, orders, and chats are completely private to your shop. Press Load sample data on the dashboard to test 20 demo products and FAQs right away.
  3. 3Every new account receives 250 free AI replies to get started. 1 reply = 1 automated AI response sent to a customer across any channel.

2. Add your products

Navigate to Dashboard → Products. Click + Add Product to open the dedicated form. Add the English name, Bangla name (recommended for customer search in Bangla), price (৳), available stock, photo, and a detailed description.

Kotha AI uses your live catalog to quote prices, check inventory, describe variants, and take orders automatically. When stock reaches 0, Kotha AI politely informs customers that the item is out of stock.

3. Knowledge base

Go to Dashboard → Knowledge Base. Configure two primary sections:

  1. 1Business info — structured fields for delivery charges (Inside / Outside Dhaka), delivery timeframes, payment options, shop address, and operating hours. Kotha AI answers these questions directly in natural Bangla or English.
  2. 2Q&A entries — add common questions organized by category (product, delivery, payment, returns, general). Write questions naturally; Kotha AI matches customer phrasing automatically.

4. Test your agent

Open Dashboard → Chat Playground to test conversations in real-time. Test asking for prices, placing full orders (quantity → name → phone → address → confirmation), asking delivery questions, or uploading a product photo using the 📷 button to test AI visual recognition.

5. Website chatbot

Go to Dashboard → Integrations → Website Chatbot. Copy the embed snippet and paste it into your website's HTML before the closing </body> tag:

<script src="https://kotha-ai.app/widget.js" data-key="pk_XXXX" async></script>

Your data-key is your public API key. Visitors on your site get a sleek floating chat bubble that automatically connects to your AI agent.

6. Facebook Messenger

⚡ 1-Click Connection: Go to Dashboard → Integrations and click ⚡ Connect next to Messenger to authorize your Facebook Page instantly.

For custom Meta Developer App setup, your Webhook URL and verify token are available under Manual Setup on the Integrations card.

7. WhatsApp Business

⚡ 1-Click Connection: Go to Dashboard → Integrations → ⚡ Connect next to WhatsApp Business to pair your number automatically.

Kotha AI uses Meta WhatsApp Business Cloud API to handle messages and orders 24/7.

8. Telegram

  1. 1In Telegram, message @BotFather → /newbot → enter your bot name to get your Bot Token.
  2. 2Paste the token into Dashboard → Integrations → Telegram and click Connect.

9. Demo mode & tokens

Any integration token starting with demo (e.g. demo_token) runs the full message pipeline — inbound webhook, AI reply generation, catalog lookup, order booking — in simulated sandbox mode. You can inspect simulated logs at the bottom of the Integrations page anytime.

10. Plans & bKash payment

Check your reply usage meter anytime at Dashboard → Billing.

PlanPriceAI RepliesChannels
Free৳0250 /moAll 5 Channels
Starter৳199 /mo800 /moAll 5 Channels
Pro৳499 /mo2,500 /moAll 5 Channels
Business৳999 /mo6,000 /moAll 5 Channels

💳 bKash Payment Instructions:

To purchase a paid plan, Send Money to our official bKash number 01641739025. Enter your sender mobile number and Transaction ID (TRX ID) in the checkout form. Your plan activates as soon as payment verification completes.

11. Going live checklist

  1. 1Deploy your application on a public HTTPS domain.
  2. 2Configure your environment variables in .env or server configuration:
SESSION_SECRET=your-random-session-secret-string
GEMINI_API_KEY=your-google-gemini-api-key
DATABASE_URL=postgresql://user:pass@host/dbname
  1. 3Connect your active Facebook Page, WhatsApp Business, or Telegram bot on the Integrations tab.
  2. 4Send a test message from a real customer account to verify automated reply and order booking.