Everything you need to get the most out of BotEmbed.ai — from setup to analytics to troubleshooting.
BotEmbed.ai lets you add an AI-powered chatbot to any website in under a minute. The bot automatically reads your page content and answers visitor questions — no manual training required.
Quick start in 3 steps:
After signing up and selecting a plan, head to your Dashboard and click Create New Bot.
Choose a descriptive name for your bot (e.g., “Support Assistant” or “Sales Helper”). This is shown in the chat header.
A brief description of what the bot does. This helps shape the bot's personality and is used as part of its system prompt.
Optional. Paste text or upload documents (TXT, PDF) containing information you want the bot to know beyond what's visible on the page. Great for FAQs, product specs, internal policies, etc.
After creating a bot, copy the embed code from the bot's Edit page and paste it into your website. The widget is a single script tag that works universally.
<script
src="https://www.botembed.ai/widget.js?botId=YOUR_BOT_ID"
data-theme="light"
data-position="bottom-right"
></script>For detailed platform-specific instructions (WordPress, Shopify, React, Next.js, etc.), see our Installation Guides and Integration Guides.
Click Edit on any bot in your Bots list to update its settings. You can change:
Changes save immediately. The embed code stays the same — no need to update the script tag on your site.
Training data gives your bot knowledge beyond what's visible on the current page. There are two ways to provide it:
Enter text directly in the Knowledge Source field. This is ideal for FAQs, product descriptions, company policies, or any structured information.
Upload TXT or PDF files. The text content is extracted and combined with any pasted text. Great for product manuals, help docs, or lengthy reference material.
Tip: The bot always has access to the current page content in addition to your training data. You don't need to duplicate information that's already on your pages.
By default, your bot can be embedded on any website. To restrict usage to specific domains, enter a comma-separated list in the Allowed Domains field on the Edit page.
example.com, shop.example.com, blog.example.comIf a visitor loads the widget from an unauthorized domain, the bot will refuse to respond. Leave the field empty to allow all domains.
Each bot has an active status. Active bots respond to visitor messages. To stop a bot from responding, you can delete it from the Bots list.
Warning: Deleting a bot is permanent. All associated chat history and analytics data will be lost. Remove the embed code from your website before deleting.
Control the widget's appearance using data attributes on the script tag.
| Attribute | Values | Default | Description |
|---|---|---|---|
data-theme | "light" | "dark" | "light" | Widget color theme |
data-position | "bottom-right" | "bottom-left" | "top-right" | "top-left" | "bottom-right" | Widget placement on the page |
data-display-text | Any string | none | Text label shown next to the chat bubble |
<script
src="https://www.botembed.ai/widget.js?botId=YOUR_BOT_ID"
data-theme="dark"
data-position="bottom-left"
data-display-text="Need help?"
></script>Collect visitor contact information before or during a chat conversation. When enabled, the widget shows a form asking for the visitor's details before they can start chatting.
Choose which fields to collect: email, name, and/or phone. You can make the form required or optional.
Lead data is stored in the visitor's session and attached to conversation logs. You can view captured leads in your analytics dashboard.
Configure lead capture in the bot Edit page under the “Lead Capture” section.
By default, the widget shows a small “Powered by BotEmbed” badge. On Pro and Scale plans, you can hide this badge for a fully white-labeled experience.
Toggle the Hide Branding option in the bot Edit page. The change takes effect immediately — no need to update your embed code.
The analytics dashboard gives you a real-time overview of how your bot is performing. Available metrics:
Number of unique chat sessions in the selected time period.
Total messages exchanged (both user and bot messages).
Distinct visitors who interacted with the chatbot.
Number of different domains where your bot is active.
The dashboard also shows conversation trends over time and your most active sites. Access it from Dashboard → Analytics (click on any bot).
Every conversation is logged and accessible from your dashboard. For each conversation, you can see:
Use chat history to identify knowledge gaps, improve your training data, and understand what your visitors care about.
The Top Sites chart in your analytics dashboard shows which domains generate the most conversations. This helps you understand where your bot is most active and popular.
Internal domains (localhost, botembed.ai) and test traffic are automatically filtered out so your analytics stay clean.
BotEmbed.ai offers three plans. All plans include a 14-day free trial.
| Feature | Starter ($9.99/mo) | Pro ($19.99/mo) | Scale ($29.99/mo) |
|---|---|---|---|
| Bots | 1 | 5 | Unlimited |
| Messages/month | 1,000 | 10,000 | 50,000 |
| Analytics | Basic | Advanced | Advanced |
| Custom Branding | - | Yes | Yes |
| Support | Priority | Dedicated |
See full details on the Pricing page.
All billing is handled through Stripe. From your Billing page, you can:
Every plan includes a 14-day free trial. During the trial you get full access to all features of your chosen plan.
No charge during the trial. If you cancel before the 14 days are up, you won't be billed. After the trial ends, your subscription automatically begins billing at the plan price.
BotEmbed's core feature is automatic site awareness. Here's how it works:
This means the bot always has up-to-date information — if you update your page, the bot's answers update automatically. No retraining needed.
Every BotEmbed chatbot has built-in rules to protect your brand:
We take security seriously. Here's how your data is protected:
Restrict which domains can use your bot. Unauthorized domains are blocked.
Cross-origin requests are handled securely with proper CORS headers.
We store conversation logs and voluntarily-submitted lead data. We do not store visitor PII, cookies, or page content.
Dashboard access is protected by Clerk authentication. Billing is handled securely through Stripe.
If the chat widget doesn't appear on your site, check these common causes:
Verify the botId in your script URL matches the ID shown on your bot's Edit page.
If your site uses a CSP, make sure https://www.botembed.ai is allowed in your script-src directive.
Some ad blockers may block third-party chat widgets. Ask visitors to disable their ad blocker or whitelist your site.
Open browser DevTools (F12) → Console tab. Look for errors related to widget.js. Ensure the script tag is placed before the closing </body> tag.
If the widget appears but the bot doesn't respond to messages:
Check your Billing page. If your trial ended or subscription lapsed, the bot won't respond until you reactivate.
Each plan has a monthly message limit. If you've exceeded it, consider upgrading to a higher plan.
If you've set Allowed Domains, make sure the current domain is in the list.
If you see CORS-related errors in your browser console, this is usually caused by the widget making cross-origin requests to the BotEmbed API.
This should resolve automatically. The BotEmbed API is configured with proper CORS headers (Access-Control-Allow-Origin: *). If you're still seeing errors, try clearing your browser cache or contact support.
Yes. BotEmbed uses a single script tag that works on any website that can load JavaScript — HTML, WordPress, Shopify, Squarespace, Wix, Webflow, React, Next.js, Vue, Angular, and more.
When a visitor opens the chat, the widget extracts the visible text from the current page and sends it as context. The bot reads the same content your visitor sees — no manual training required.
Never. We built explicit guardrails: if the bot cannot find information on your site, it redirects the visitor to contact your team. It will not suggest other companies.
OpenAI's GPT-4o-mini. It's fast, accurate, and uses your uploaded training data combined with live page content to answer questions.
Yes. Set the bot's name, description, and additional knowledge source text. The bot will maintain natural, site-aware behavior while matching your brand voice.
The bot politely redirects: it stays focused on questions about your business and guides visitors back to relevant topics.
Very. The bot reads the literal text on your page, so if the information is there, it will find it. Responses are automatically limited to your domain content only.
Yes. All plans include chat history. The analytics dashboard shows conversation volume, common questions, unique visitors, active sites, and message trends over time.
After the 14-day trial, your subscription begins billing. You can cancel anytime before the trial ends and you won't be charged.
Yes. You can upgrade or downgrade your plan anytime from the Billing page in your dashboard. Changes take effect immediately.
We don't offer a permanent free plan. All plans include a 14-day free trial so you can test the full product before committing.
Go to Dashboard > Billing and click 'Manage Subscription'. This opens the Stripe customer portal where you can cancel, update payment methods, or download invoices.
You can create multiple bots (depending on your plan), but each page should only embed one bot at a time. Use different bots for different sections of your site if needed.
No. The widget loads asynchronously and does not block page rendering. It adds minimal overhead — typically under 50KB.
Yes. In the bot edit page, set Allowed Domains to a comma-separated list of domains. Only those domains will be able to load your widget. Leave it empty to allow all domains.
We store conversation messages (question and response), the site URL where the conversation happened, and any lead capture data the visitor provides. We do not store page content or visitor PII beyond what they voluntarily submit.
Yes. When creating or editing a bot, you can upload text or PDF files. The content is extracted and used as additional context when answering questions.
Each plan has a monthly message limit: Starter (1,000), Pro (10,000), Scale (50,000). Messages reset on your billing cycle date.
Yes, on Pro and Scale plans. Toggle 'Hide Branding' in the bot edit page to remove the 'Powered by BotEmbed' badge from the widget.
Email us at support@botembed.ai. Starter plans get email support, Pro plans get priority support, and Scale plans get a dedicated account manager.
Need help? We're here for you. Reach out based on your plan:
Reach out to our support team or explore our documentation for detailed guides.