Welcome to the official documentation for the NVT AI Chatbot. This guide will help you install, configure, and manage your AI-powered assistant and Live Chat system on your WordPress site.

1. Installation & Setup

Step 1: Install the Plugin

1. Log in to your WordPress Admin Dashboard.

2. Navigate to Plugins > Add New.

3. Click Upload Plugin and select the .zip file of the plugin (or search for “NVT AI Chatbot” if published).

4. Click Install Now and then Activate.

Step 2: Connect Your Account (Setup Wizard)

Upon activation, you will be greeted by the Setup Wizard.

1. Register: If you don’t have an account, enter your Email and Password to register. The system will automatically generate and save your API Key.

2. Connect: If you already have an API Key, simply paste it into the field to connect your site to the NVT SaaS Platform.

2. Training Your AI (Data Sources)

This is the most critical step. For the “RAG” (Retrieval-Augmented Generation) technology to work, you must teach the AI about your business content.

Go to: RAG Chatbot > Data Sources.

Method A: Website Crawl (Auto-Sync)

The chatbot can automatically read and index your public pages and posts.

1. Sitemap URL: In the “Website Crawl” section, enter your website’s XML Sitemap URL (e.g., https://yourdomain.com/sitemap_index.xml).

   • Note: If left empty, the system will attempt to auto-detect it, but providing the exact URL ensures better accuracy.

2. Click Start Crawl. The process may take a few minutes depending on your site size.

Method B: Upload Files

You can upload internal documents that are not publicly available on your website (e.g., PDF price lists, Word doc policies).

1. Under Upload Files, select your documents. Supported formats include .pdf, .docx, .txt, .xlsx, .pptx, .md.

2. Assign Category: Choose a category (e.g., Product, FAQ, Policy) to help organize your data.

3. Click Upload & Index.

Status Check: You can monitor the status of your data in the “Indexed Sources” table at the bottom of the page. Once the status shows OK, the AI can use that content to answer questions.

3. Customizing the Widget

Customize the appearance and behavior of the chat widget to match your brand. Go to: RAG Chatbot > Settings.

General & API Tab

• Operating Mode:

  • Follow Schedule (Default): Automatically enables Live Chat during your business hours and switches to AI Bot after hours.

  • Always Live Chat: Forces the widget to connect to a human agent immediately.

  • Always Bot: The AI handles all conversations 24/7.

• Welcome Message: Set the initial greeting message users see when opening the chat.

Appearance Tab

• Theme: Choose between Light, Dark, or Auto mode.

• Chat Button: Customize the color or upload a custom icon image for the floating chat button.

• Avatars: Upload custom avatars for the “Bot” and the “User”.

Positioning Tab

• Alignment: Place the widget on the Left or Right side of the screen.

• Offsets: Adjust the bottom and side spacing (in pixels) for both Desktop and Mobile views to prevent overlapping with other elements.

Contact Channels Tab

• Add quick-access buttons for other channels like Zalo, Messenger, WhatsApp, or Phone next to the chat widget.

4. Managing Conversations (Inbox)

This is your central hub for monitoring chats and supporting customers in real-time. Go to: RAG Chatbot > Inbox.

The Inbox Interface

• Session List (Left): View all active and past conversations. Sessions requiring human attention (Live Mode) are marked with a 🔴 LIVE badge.

• Chat Area (Center): View the transcript between the visitor and the AI.

How to use Live Chat

If a customer asks a complex question or requests a human agent:

1. Select the conversation from the list.

2. Click the “TURN ON LIVE CHAT (ADMIN)” button in the header.

3. The AI will pause. You can now type and reply to the customer directly in real-time via WebSocket.

4. Once the issue is resolved, click the button again to turn off Live Chat and return control to the AI.

Note: If you enable Live Chat but do not reply within the configured timeout (default 60 seconds), the system can automatically fallback to AI to ensure the customer isn’t left waiting.

5. Billing & Upgrades

To increase your message limits, crawl capacity, or file upload limits: Go to: RAG Chatbot > Account.

• View your current usage stats (Messages, URLs, Files).

• Upgrade Plan: Choose between Pro or Business plans.

• Payment Methods:

  • PayPal: For international payments (USD).

  • PayOS: For Vietnam banking QR code payments (VND).

6. Advanced: Using Shortcodes

By default, the chat widget floats in the corner of your site. You can also embed a specific chat box inside a page or post content using a Shortcode.

Shortcode:

    

            
                                    
            

                

                    
Support
                    

                    ×
                
                
                                
                

                    
                    
                    Start Chat
                    

                
                
                

                
                

                
                

                    
                    Send
                
            
            
            

                AI Assistant            

                            
                    
                
            
    
    

Parameters:

• floating="0": Disables the floating behavior, rendering the chat inline within the content.

• title: Sets the header title of the chat box.

• placeholder: Sets the custom placeholder text for the input field.

Frequently Asked Questions (FAQ)

Q: Why does the “Start Crawl” result in 0 URLs? A: This usually happens if the system cannot detect your Sitemap. Please install an SEO plugin (like Yoast SEO or RankMath) to generate a standard Sitemap, then paste the URL (e.g., yourdomain.com/sitemap_index.xml) into the “Manual Sitemap URL” field in the Data Sources tab.

Q: Does the chatbot support multiple languages? A: Yes, the AI engine uses advanced LLM technology that understands and replies in the language the visitor uses (including Vietnamese, English, etc.) based on your indexed content.

Q: Do I need to keep the Admin tab open to receive Live Chat messages? A: While not strictly mandatory, it is recommended to keep the Inbox tab open to reply in real-time. The browser tab title will flash, and a notification sound will play when a new message arrives.