Documentation

Everything you need to build, customize, and deploy your AI chatbot.

🚀 Quick Start

Step 1: Create an Account

Step 2: Create a Chatbot

From your dashboard, click "New Chatbot". Give it a name, set a system prompt to define its personality, and choose your preferred AI model.

Step 3: Train Your Bot

Go to the Knowledge tab and add your content:

URLs — Paste any webpage URL and we'll crawl and extract the content
Documents — Upload PDF, TXT, MD, or CSV files
Text — Paste raw text directly (FAQs, product info, etc.)

Step 4: Test It

Use the Test tab to chat with your bot and make sure it responds correctly based on your training data.

Step 5: Embed on Your Website

Go to the Embed tab, copy the script tag, and paste it before the closing </body> tag on your website:

<script src="https://aidroidbots.com/widget/aidroidbots.js" 
  data-bot-id="YOUR_BOT_ID"></script>

Customize your chat widget from the bot's Settings tab:

Setting	Description	Default
Color	Primary color for bubble, header, send button	#6366f1
Position	Widget position on the page	bottom-right
Title	Header text shown in the chat window	Chat with us
Welcome Message	First message shown when chat opens	Hi! How can I help?
Branding	"Powered by AIDroidBots" badge	On (removable on Pro+)

🔗 API Reference

Authentication

All API requests require your API key in the header:

X-API-Key: adb_your_api_key_here

Find your API key in Dashboard → Settings.

Send a Message

POST/api/chat/{botId}

{
  "message": "What are your business hours?",
  "session_id": "visitor_123"  // optional, for conversation continuity
}

Returns AI response with conversation context.

Stream a Response

POST/api/chat/{botId}/stream

Same payload as above. Returns Server-Sent Events (SSE) with real-time token streaming.

List Bots

GET/api/bots

Returns all your chatbots with conversation counts and status.

❓ FAQ

What AI models do you use?

We use OpenAI's GPT-4o-mini by default (fast and cost-effective). Pro and Business plans can also use GPT-4o for more complex conversations.

How does the bot learn my content?

When you add URLs, documents, or text as knowledge sources, we extract and store the content. When a visitor asks a question, we include relevant knowledge in the AI prompt so it answers based on YOUR information.

Can I use this on multiple websites?

Yes! Each bot gets its own embed code. You can place different bots on different sites, or the same bot on multiple sites.

What happens when I hit my message limit?

Visitors will see a friendly message that the bot is temporarily unavailable. You can upgrade your plan at any time to increase limits. Messages reset monthly.

Is the visitor data private?

Yes. Conversations are only visible to you in your dashboard. We don't share visitor data with third parties. See our Privacy Policy for details.

Can I remove the "Powered by AIDroidBots" branding?

Yes — the Pro plan ($79/mo) and above allow you to remove branding from the widget.

Do you offer refunds?

Yes, we offer a 14-day money-back guarantee on all paid plans.

Need more help?

support@aidroidbots.com