Tubetotext

    ← Back to Home

    Help & Documentation

    Everything you need to know to get started with TubeToText

    πŸš€ Getting Started

    Welcome to TubeToText! In just 3 simple steps, you can have an AI-powered chatbot running on your website.

    1

    Sign Up

    Create your free account in seconds

    2

    Add Website

    Our AI scrapes and learns your content

    3

    Embed & Go

    Copy one line of code to your site

    πŸ’‘ Tip: All plans include a 7-day free trial (no credit card required) to test everything before committing.

    🌐 How to Add Your Website

    Step 1: Navigate to Websites Dashboard

    After logging in, go to /websites or click "Websites" in the navigation menu.

    πŸ“Έ Screenshot: Websites Dashboard View
    (Add screenshot here: websites-dashboard.png)

    Step 2: Click "Add Website"

    Click the blue "Add Website" button in the top right corner of the dashboard.

    πŸ“Έ Screenshot: Add Website Button
    (Add screenshot here: add-website-button.png)

    Step 3: Enter Your Website URL

    In the modal that appears, enter your website URL. Examples:

    • https://docs.mycompany.com
    • https://mystore.com
    • https://help.myapp.io

    πŸ“Έ Screenshot: Enter URL Modal
    (Add screenshot here: enter-url-modal.png)

    Step 4: Wait for Scraping to Complete

    Our AI will automatically scrape your website content. This usually takes 1-5 minutes depending on your site size. You'll see a progress indicator showing:

    • ⏳ Pending - Scraping queued
    • πŸ”„ Processing - Currently scraping your site
    • βœ… Completed - Ready to use! (Shows number of pages indexed)
    • ❌ Failed - Something went wrong (see troubleshooting)

    πŸ“Έ Screenshot: Scraping Progress States
    (Add screenshot here: scraping-states.png)

    ⚠️ Important: Make sure your website is publicly accessible. Our scraper cannot access pages behind authentication or paywalls.

    🎨 Customizing Your Chatbot

    Make the chatbot match your brand perfectly with these customization options:

    Opening the Widget Settings

    Once your website scraping is complete, click the "Configure Widget" button next to your website.

    πŸ“Έ Screenshot: Configure Widget Button
    (Add screenshot here: configure-widget-button.png)

    Customization Options

    🎨 Primary Color

    Choose your brand color for the widget. This affects the header, buttons, and accent elements.
    Available on: All plans

    πŸ’¬ Greeting Message

    Customize the first message visitors see. Examples:
    "Hi! How can I help you today?"
    "πŸ‘‹ Welcome! Ask me anything about our products."
    Available on: All plans

    πŸ“ Widget Position

    Choose between bottom-right or bottom-left corner placement.
    Available on: All plans

    🏷️ Remove Branding

    Remove "Powered by TubeToText" from the widget footer.
    Available on: Starter plan and above ($29/mo+)

    πŸ–ΌοΈ Custom Logo & Avatar

    Upload your company logo and custom AI avatar image.
    Available on: Pro plan and above ($79/mo+)

    πŸ’… Custom CSS

    Inject custom CSS for complete design control. Advanced users only.
    Available on: Enterprise plan ($249/mo+)

    πŸ“Έ Screenshot: Widget Customization Panel
    (Add screenshot here: widget-customization-panel.png)

    Preview Your Changes

    Use the live preview on the right side to see your changes in real-time before publishing.

    πŸ“Έ Screenshot: Live Preview Panel
    (Add screenshot here: live-preview.png)

    ⚑ Embedding the Widget

    Adding the chatbot to your website takes just one line of code.

    Step 1: Copy the Embed Code

    In your website dashboard, click "Get Embed Code" or navigate to the "Embed" tab in the widget settings.

    <script src="https://tubetotext.com/widget.js" data-api-key="ttw_abc123xyz"></script>

    πŸ“Έ Screenshot: Embed Code Section
    (Add screenshot here: embed-code-section.png)

    Step 2: Paste into Your Website

    Add the script tag to your website's HTML, just before the closing </body> tag.

    For Static HTML Sites:

    <!DOCTYPE html> <html> <head> <title>My Website</title> </head> <body> <!-- Your content --> <!-- TubeToText Widget --> <script src="https://tubetotext.com/widget.js" data-api-key="ttw_abc123xyz"></script> </body> </html>

    For Next.js / React:

    // In your _app.tsx or layout.tsx import Script from 'next/script' export default function RootLayout({ children }) { return ( <html> <body> {children} <Script src="https://tubetotext.com/widget.js" data-api-key="ttw_abc123xyz" /> </body> </html> ) }

    For WordPress:

    Go to Appearance β†’ Theme Editor β†’ footer.php and paste the code before </body>

    For Shopify:

    Go to Online Store β†’ Themes β†’ Edit code β†’ theme.liquid and paste before </body>

    For Webflow:

    Go to Project Settings β†’ Custom Code β†’ Footer Code and paste the script

    Step 3: Verify Installation

    After adding the code:

    1. Refresh your website
    2. Look for the chatbot widget in the bottom corner
    3. Click it and ask a test question
    4. Check your analytics dashboard to see the conversation logged

    πŸ“Έ Screenshot: Widget Live on Website
    (Add screenshot here: widget-live-example.png)

    βœ… Pro Tip: The widget loads asynchronously and won't slow down your site. It's optimized for performance and SEO.

    πŸ“Š Understanding Analytics

    Track your chatbot's performance and understand what your visitors are asking.

    Accessing Analytics

    Click on your website in the dashboard, then navigate to the "Analytics" tab.

    πŸ“Έ Screenshot: Analytics Dashboard
    (Add screenshot here: analytics-dashboard.png)

    Key Metrics

    πŸ’¬

    Total Conversations

    Number of unique chat sessions initiated by visitors.

    πŸ“¨

    Messages Sent

    Total user messages (counts toward your plan limit). AI responses are free.

    ⭐

    User Satisfaction

    Based on thumbs up/down feedback from visitors.

    ❓

    Popular Questions

    Most frequently asked questions. Use this to improve your content or FAQs.
    (Available on Pro plan and above)

    Viewing Conversations

    Click on any conversation to see the full chat transcript. This helps you:

    • Identify where the AI is struggling
    • Find gaps in your content
    • Discover new customer needs
    • Train your team on common questions

    Exporting Data

    Export your analytics and conversation history:

    • CSV Export: Available on Starter plan and above
    • API Access: Available on Pro plan and above
    • PDF Reports: Available on Pro plan and above

    πŸ”§ Troubleshooting

    ❌ Website scraping failed

    Possible causes:

    • Website requires authentication (login)
    • Website blocks bots/scrapers (robots.txt)
    • Website uses complex JavaScript rendering
    • Invalid URL or website is down

    Solutions:

    • Make sure your website is publicly accessible
    • Check your robots.txt allows crawling
    • Try a different URL (e.g., /docs instead of root domain)
    • Contact support if issue persists

    ⚠️ Widget not appearing on website

    Troubleshooting steps:

    1. Hard refresh your browser (Ctrl+Shift+R / Cmd+Shift+R)
    2. Check browser console for errors (F12 β†’ Console tab)
    3. Verify the script tag is in the HTML (View Page Source)
    4. Make sure the API key is correct
    5. Check if browser extensions are blocking scripts
    6. Try a different browser or incognito mode

    πŸ€– AI giving wrong/irrelevant answers

    How to improve accuracy:

    • Re-scan your website to get latest content (click "Rescan" button)
    • Make sure your website content is well-structured (headings, paragraphs)
    • Add a dedicated FAQ page with clear Q&A
    • Check conversation history to see what the AI is reading
    • Use auto-rescan feature (weekly on Starter, daily on Pro)

    πŸ“Š Analytics not showing data

    Check the following:

    • Widget is properly installed on your site
    • You've had actual visitor conversations (test it yourself first)
    • Analytics may take a few minutes to update
    • Check date range filter isn't excluding data

    πŸ’³ Billing or subscription issues

    Common questions:

    • Upgrade plan: Go to Settings β†’ Billing β†’ Change Plan
    • Update payment method: Settings β†’ Billing β†’ Payment Method
    • Cancel subscription: Settings β†’ Billing β†’ Cancel (takes effect next cycle)
    • Exceeded message limit: Upgrade plan or wait for monthly reset

    πŸ’¬ Still need help? Contact support at support@tubetotext.com or use the live chat on our website.

    πŸ’° Pricing & Plans

    Try any plan free for 7 days. All plans include unlimited website scraping and AI responses.

    POPULAR

    Starter

    $29/mo

    • πŸŽ‰ 7-day free trial
    • βœ… 3 website widgets
    • βœ… 1,000 messages/month
    • βœ… Remove branding
    • βœ… 30-day analytics + CSV
    • βœ… Priority support (24h)
    • βœ… Weekly auto-rescan
    Start Free Trial

    Pro

    $79/mo

    • πŸŽ‰ 7-day free trial
    • βœ… 10 website widgets
    • βœ… 5,000 messages/month
    • βœ… Custom logo & avatar
    • βœ… Unlimited analytics + API
    • βœ… A/B testing
    • βœ… Daily auto-rescan
    Start Free Trial

    Enterprise

    $249/mo

    • πŸŽ‰ 7-day free trial
    • βœ… Unlimited widgets
    • βœ… 25,000 messages/month
    • βœ… Human handoff (5 agents)
    • βœ… White-label
    • βœ… Custom CSS
    • βœ… 4h SLA + Manager
    Start 7-Day Free Trial

    πŸ’‘ What counts as a message? Only visitor messages count toward your limit. AI responses are free. A 10-message conversation = 5 counted messages.

    Special Offers

    • πŸŽ‰ Annual billing: Save 20% on all plans
    • πŸš€ Startup discount: 50% off Pro plan for companies <$1M ARR
    • πŸŽ“ Non-profit/Education: 50% off all paid plans
    • πŸ’Ό Affiliate program: Earn 20% recurring commission

    ❓ Frequently Asked Questions

    How does the AI chatbot work?

    Our AI automatically scrapes your website content and uses advanced RAG (Retrieval-Augmented Generation) technology to understand it. When a visitor asks a question, the AI searches your content and generates accurate, context-aware responses in real-time using multiple LLM providers (OpenAI, Anthropic, Google, DeepSeek).

    Can I customize the chatbot's appearance?

    Yes! All plans include color customization, greeting messages, and widget positioning. Paid plans add branding removal, custom logos, avatars, and Enterprise plans get full CSS control for complete design freedom.

    What happens if I exceed my message limit?

    The widget will display a "Monthly limit reached" message to new visitors. You can upgrade your plan instantly or wait for your monthly reset. Existing conversations can continue without counting toward the limit.

    Can the chatbot access pages behind login?

    No, our scraper can only access publicly available pages. For authenticated content, we recommend creating a public help/documentation section that the AI can learn from. Enterprise customers can discuss custom solutions.

    How often does the AI update its knowledge?

    Starter plan: Weekly automatic rescan. Pro plan: Daily automatic rescan. Enterprise plan: Real-time monitoring. Enterprise: Real-time updates available. You can manually trigger a rescan anytime from your dashboard.

    Is my data secure and private?

    Absolutely. All data is encrypted in transit (HTTPS) and at rest. We're GDPR compliant, never sell your data, and you can delete all your data at any time. Enterprise plans include SOC 2 compliance (roadmap) and custom data retention policies.

    Can I cancel my subscription anytime?

    Yes! You can cancel anytime from Settings β†’ Billing. Cancellation takes effect at the end of your current billing period. We also offer a 30-day money-back guarantee on all paid plans, no questions asked.

    Do you offer a free trial?

    Yes! All paid plans include a 7-day free trial. No credit card required to start. You can test all features risk-free before committing to a paid plan.

    Will the widget slow down my website?

    No! Our widget loads asynchronously after your page content, so it won't block or slow down page rendering. The script is optimized, cached, and delivered via CDN for maximum performance. It's also SEO-friendly.

    Ready to Get Started?

    Add an AI chatbot to your website in under 2 minutes. No credit card required.

    Start 7-Day Free Trial β†’
    Home
    KnowledgeNEW
    Account