SiteBotGPT Documentation
Learn how to use every feature of SiteBotGPT: from creating your first bot and embedding the chat widget to using the dashboard, API, and free tools.
Getting started
SiteBotGPT turns your website and documents into an AI customer support agent. Here’s how to go from zero to a live chatbot.
- Sign up — Create an account at Get started free. You can use email/password or sign in with Google.
- Create a bot — In the Dashboard, click "New bot". Give it a name (e.g. "Support Bot") and optionally your website URL.
- Add sources — In the bot’s Setup page, add content for the bot to learn from:
- Website URL — We crawl the URL and index the content (respects robots.txt).
- Documents — Upload PDF, DOCX, TXT, or MD files. Available on paid plans.
- Train — Click "Train" (or "Retrain") so the bot builds its knowledge from your sources. Training may take a minute depending on content size.
- Embed the widget — On the bot’s main page, copy the embed code and add it to your website (see Chat widget).
Chat widget
The chat widget is a small bubble on your site that opens a chat panel. Visitors can ask questions and get answers from your bot 24/7.
How to get the embed code
Go to Dashboard → [Your bot]. The embed code is shown in the "Add to your site" section. It looks like:
<script src="https://www.sitebotgpt.com/widget.js" data-bot="atlas_xxxx" data-base="https://www.sitebotgpt.com"></script>
data-bot is your bot’s public key (atlas_...). data-base is your SiteBotGPT app URL (e.g. https://sitebotgpt.com).
Adding the widget to your site
Paste the script once, usually in the footer or before </body>. The chat bubble will appear on every page where the script loads.
- WordPress — Use a plugin like "Insert Headers and Footers" and paste the code in "Scripts in Footer". Or add it in
footer.phpbefore the closing</body>. - Wix — Settings → Custom Code → Add code to "Body - end".
- Squarespace — Settings → Advanced → Code Injection → Footer.
- Shopify — Themes → Edit code →
theme.liquid→ paste before the last line. - Google Tag Manager — New tag → Custom HTML → paste the script; trigger on All Pages.
- Manual / HTML — Paste the script at the bottom of your HTML, before
</body>.
In the dashboard, you can download step-by-step instructions for your platform (WordPress, Wix, etc.) from the same "Add to your site" section.
Widget options (script attributes)
The embed script supports the following attributes:
data-bot(required) — Your bot’s public key (atlas_...).data-base(optional) — Your SiteBotGPT app URL (e.g. https://sitebotgpt.com). Defaults to the script’s origin if omitted.
Position and colors: The chat bubble is fixed in the bottom-right corner. Colors and layout use the default theme (blue accent). Custom position or colors are not configurable via script attributes in the current version.
Branding: The widget can show "Powered by SiteBotGPT" at the bottom of the chat panel. On Scale and Enterprise plans (or with the Remove Branding add-on), you can turn this off in the dashboard: open your bot → Embed code card → toggle "Remove SiteBotGPT branding". The setting is saved per bot. Production app: https://sitebotgpt.com.
Widget behavior
- Visitors see a chat bubble; clicking it opens the chat panel.
- The bot shows a greeting and optional quick prompts (e.g. "What are your hours?") that you configure in Setup.
- When the AI is unsure, it can ask for the visitor’s name and email (lead capture). Captured leads appear in Dashboard → Leads.
Dashboard
After signing in, the dashboard is your control center. Here’s what each area does.
Bots
Dashboard home lists all your bots. You can create a new bot (subject to plan limits), open a bot to manage it, or delete a bot. Each bot has its own embed code, sources, and settings.
Bot setup (sources & training)
Open a bot and click Add sources (or go to Setup). Here you:
- Add website URLs — Enter a URL; we crawl and index that page (and optionally linked pages). Good for docs, FAQs, product pages.
- Upload documents — PDF, DOCX, TXT, MD (on plans that support documents). Files are chunked and embedded for RAG.
- Train / Retrain — Click to (re)build the bot’s knowledge from all sources. Do this after adding or changing sources.
Source list shows status (pending, ready, error). If a source fails, check the error message and fix the URL or file, then retrain.
Bot settings (name, greeting, quick prompts)
On the bot’s main page you can edit:
- Name — Display name of the bot (e.g. in the widget header).
- Greeting — First message visitors see when they open the chat.
- Quick prompts — Short suggested questions (e.g. "Pricing?", "Contact?") that visitors can tap to send.
- Lead capture — When to ask for name/email (e.g. when confidence is low). Optional.
Analytics
In Dashboard → [Bot] → Analytics you see:
- Chat volume over time.
- Top questions asked by visitors.
- Other metrics to improve your content and bot answers.
Chats
Dashboard → [Bot] → Chats shows conversation history. You can review what visitors asked and how the bot replied, and use this to spot gaps in your knowledge base.
Leads
When the widget captures a visitor’s name and email (e.g. when the AI is unsure), the lead appears in Dashboard → [Bot] → Leads (or the global Leads page). You can view, export, or follow up from there.
API keys
Dashboard → API lets you create and manage API keys for programmatic access. Available on Scale and Enterprise plans. Use the key in the Authorization: Bearer or x-api-key header when calling the Chat API. See API Documentation.
Webhooks
Dashboard → Webhooks (Scale/Enterprise) lets you register a URL to receive HTTP POST requests when events happen (e.g. lead.captured, chat.message). Use this to push leads to your CRM or log conversations. Full details and payloads are in the API docs.
Team
Dashboard → Team lets you invite team members by email. They can access the same bots and dashboard according to your plan. Accept invitations via the link in the invite email.
Settings & billing
Dashboard → Settings — Account and profile. Dashboard → Pricing — View plan, usage, and upgrade options.
Free tools
SiteBotGPT offers free, no-signup tools for content and productivity. All are available at /tools.
AI generators
Generate text with AI: replies, prompts, FAQs, answers, email responses, letters, blog titles, chatbot names, SaaS brand names. Use the input fields on each tool page, then copy the result.
- AI Reply Generator — Replies to messages.
- AI Prompt Generator — Create AI prompts.
- AI Prompt Optimizer — Improve existing prompts.
- AI FAQ Generator — FAQs for a topic/product.
- AI Answer Generator — Quick answers to questions.
- AI Email Response Generator — Email replies.
- AI Letter Generator — Letters and notes.
- AI Blog Title Generator — Blog titles.
- AI Chatbot Name Generator — Names for chatbots.
- AI SaaS Brand Name Generator — SaaS brand names.
AI chat with your data
Paste or upload content, then ask questions. Answers are based only on your provided data.
- AI Chat with Text — Paste text and chat.
- AI Chat with Website — Enter URL and ask about the page.
- AI Chat with Document — Upload/paste documents and chat.
- AI Chat with PDF — Upload PDF and ask questions.
- AI Chat with Word — Upload Word doc and chat.
SEO & utilities
- AI Chatbot Conversation Analysis — Analyze conversations for gaps.
- Sitemap Finder & Checker — Find and check sitemaps.
- Sitemap Validator — Validate XML sitemaps.
- XML Sitemap Generator — Generate sitemap.xml from a URL.
- Sitemap URL Extractor — Extract URLs from a sitemap.
- Website URL Extractor — Crawl and extract URLs.
- Chatbot ROI Calculator — Estimate chatbot savings.
- Email Signature Generator — Create email signatures.
- SourceSync.ai — Sync content sources.
Convert to Markdown
Convert various formats to Markdown. Paste content or enter a URL/file as indicated on each tool.
API & webhooks
For full request/response formats, authentication, rate limits, and webhook payloads, see the dedicated API docs:
- Chat API — Send messages and get bot replies (API key or bot key).
- Embed info — Get greeting and quick prompts for the widget (no API key).
- Webhooks — Events (lead.captured, chat.message), payloads, and signature verification.
- Errors and rate limits — Status codes and throttling.