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
- 1Create a free account with your email and business name — this business name is displayed to customers in chat.
- 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.
- 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:
- 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.
- 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
For custom Meta Developer App setup, your Webhook URL and verify token are available under Manual Setup on the Integrations card.
7. WhatsApp Business
Kotha AI uses Meta WhatsApp Business Cloud API to handle messages and orders 24/7.
8. Telegram
- 1In Telegram, message @BotFather →
/newbot→ enter your bot name to get your Bot Token. - 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.
| Plan | Price | AI Replies | Channels |
|---|---|---|---|
| Free | ৳0 | 250 /mo | All 5 Channels |
| Starter | ৳199 /mo | 800 /mo | All 5 Channels |
| Pro | ৳499 /mo | 2,500 /mo | All 5 Channels |
| Business | ৳999 /mo | 6,000 /mo | All 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
- 1Deploy your application on a public HTTPS domain.
- 2Configure your environment variables in
.envor server configuration:
SESSION_SECRET=your-random-session-secret-string
GEMINI_API_KEY=your-google-gemini-api-key
DATABASE_URL=postgresql://user:pass@host/dbname- 3Connect your active Facebook Page, WhatsApp Business, or Telegram bot on the Integrations tab.
- 4Send a test message from a real customer account to verify automated reply and order booking.