BotraAI

    How can we help?

    Chat with our AI agent for instant answers. If it can't help, it'll automatically escalate to our team — no email tickets needed.

    Browse Docs

    Step-by-step guides

    ·

    Getting Started

    Creating Your First ChatbotEmbedding on Your Website

    Training

    Training Your Chatbot

    Reference

    API Reference
    Getting Started

    Creating Your First Chatbot

    Learn how to create, train, and deploy your first AI chatbot in minutes.

    1

    Enter Your Website URL

    From your dashboard, click Create Chatbot and enter your website URL. Botra will automatically scrape your website, analyze its content, and build a knowledge base from your pages — including services, pricing, FAQs, and contact information.

    2

    Customize Your Widget

    After creation, you can customize your chatbot's appearance — change colors, set a display name, upload an avatar, configure the welcome message, and choose from suggested questions that guide visitors toward common topics.

    3

    Test and Deploy

    Use the built-in preview to test your chatbot before going live. Once satisfied, copy the embed script from the Setup tab and add it to your website. The chatbot appears as a floating button visitors can click to start a conversation.

    Pro tip: You can create up to 5 chatbots on the Free plan. Each chatbot can be trained on a different website, giving you flexibility to serve different audiences.
    Getting Started

    Embedding on Your Website

    Step-by-step guide to add the Botra widget to any website.

    1

    Get Your Embed Code

    In your chatbot editor, navigate to the Setup tab and copy the embed script. It looks like this:

    <script
      src="https://www.botraai.com/widget/YOUR_CHATBOT_ID/embed.js"
      async
    ></script>
    2

    Add to Your Website

    Paste the script tag just before the closing </body> tag on every page where you want the chatbot to appear. The script is lightweight (<50KB) and loads asynchronously — it won't affect your page speed.

    3

    Verify Installation

    Visit your website — you should see the Botra chat bubble in the bottom-right corner. Your dashboard will show the embed status as Live once the widget detects a page visit.

    Make sure your website is publicly accessible. The widget won't work on localhost unless you add the domain to your chatbot's allowed domains list.
    Training

    Training Your Chatbot

    Upload documents, add Q&A pairs, and scrape websites to train your bot.

    Website Scraping

    Botra automatically crawls your website on creation. Re-scan anytime from Settings to pick up new content — pages, services, pricing, FAQs, and contact details are extracted.

    Document Upload

    Upload PDFs, DOCX, TXT and more from the Training tab. Documents are chunked and embedded for semantic search. The chatbot cites sources in its responses.

    Q&A Pairs

    Add custom question-and-answer pairs for precise control. Each pair guarantees an exact response. Enable or disable pairs without deleting them.

    Reference

    API Reference

    Full API documentation for widget customization and integrations.

    Widget Configuration Options

    OptionTypeDescription
    positionstringbottom-right | bottom-left
    primaryColorstringPrimary brand color (hex)
    welcomeMessagestringCustom welcome message
    leadCapturebooleanEnable lead capture form
    languagestringISO 639-1 language code

    Chat API Endpoint

    For custom integrations, send a POST request to the chat endpoint:

    POST /api/widget/:id/chat
    Content-Type: application/json
    
    {
      "message": "Hello, I have a question",
      "sessionId": "unique-session-id",
      "visitorName": "John",
      "visitorEmail": "john@example.com"
    }

    The response is a Server-Sent Events (SSE) stream. Each event contains a content chunk. The final event signals completion with {done: true}.

    Botra © 2026 · All rights reserved.

    PrivacyTermsDocs