=== Avosist – AI Chatbot ===
Contributors: avosist
Tags: chatbot, ai, artificial intelligence, customer support, live chat
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add the Avosist AI Chatbot to your website. Provide 24/7 automated customer support.

== Description ==

Avosist Chatbot automates customer support, books appointments, captures leads, creates orders and provides 24/7 AI-powered assistance on any WordPress website with a 2-minute setup and no coding required.

🟢 Avosist Chatbot is the official WordPress plugin for the Avosist AI Platform — a leading omnichannel AI assistant platform for businesses. It allows you to deploy a fully trained, intelligent chatbot widget on your WordPress site using your own business knowledge base. Your visitors get instant, accurate, human-like answers powered by advanced AI — while you focus on growing your business.

💬 What does Avosist Chatbot do?
The Avosist Chatbot plugin connects your WordPress website to the Avosist AI Platform, enabling a real-time conversational AI assistant that is trained on your business data. Upload your product catalogs, FAQs, service documents, price lists, and website URLs — the AI learns from all of it. Your chatbot can then answer visitor questions, take appointment bookings, process orders, collect support tickets, and even escalate conversations to a live human agent — all without any code.

🚀 Why use Avosist Chatbot on your WordPress website?

💬 24/7 Automated Customer Support: Never miss a customer inquiry again. The Avosist AI Chatbot works around the clock, providing instant responses to FAQs, product questions, and service inquiries — even outside business hours.

📅 AI-Powered Appointment Booking: Let the chatbot handle your appointment calendar. Visitors can book sessions, consultations, and reservations directly through the chat widget, with automatic conflict detection and confirmation.

🛒 Order Creation via Chat: The chatbot can take orders from visitors during the conversation and log them directly to your Avosist dashboard — turning every chat into a potential sale.

🎫 Smart Support Ticket Generation: When a visitor needs assistance beyond the bot's capabilities, it intelligently collects their issue details and creates a support ticket, routing it to your team automatically.

🤝 Live Agent Handoff: Configure the chatbot to escalate complex or sensitive conversations to a real human agent with a single message. The AI detects when escalation is needed and hands off smoothly.

📚 Knowledge Base Training: Upload PDFs, Excel spreadsheets, Word documents, or provide website URLs. The Avosist AI reads and understands your content, then uses it to answer customer questions with precision.

🎨 Fully Customizable Widget: Match the chatbot to your brand with 18 launcher icons, custom accent colors, light and dark modes, rounded or square corners, and a configurable chat title. Your chatbot, your style.

💡 Quick Reply Chips: Add up to 6 quick-reply buttons to guide visitors toward the most common topics — reducing friction and improving engagement from the first message.

🔒 Secure & Private: The widget uses Shadow DOM isolation to prevent CSS conflicts. All API communication is encrypted via HTTPS. Domain whitelisting ensures the widget only loads on your authorized sites.

📱 Mobile-Friendly: The Avosist chat widget is fully responsive and works flawlessly on desktop, tablet, and mobile — providing a seamless experience for every visitor, on every device.

🔁 Persistent Chat History: Returning visitors see their previous conversation restored automatically via secure local session storage — no repeated introductions.

= 🚀 Top Features of Avosist Chatbot WordPress Plugin =

* **Knowledge Base Integration** — Train your chatbot by uploading PDFs, Excel files, Word documents, or by crawling your website. The AI extracts and understands your content, delivering accurate answers based on your actual business information.
* **Appointment Booking via AI** — The chatbot checks availability and books appointments directly from the conversation, with full integration to your Avosist calendar system.
* **Order Processing via Chat** — AI-driven order creation allows visitors to complete a purchase entirely within the chat window, with orders logged to your Avosist dashboard.
* **Support Ticket Creation** — When issues require human follow-up, the chatbot gathers all necessary details and submits a structured support ticket to your team.
* **Live Support Escalation** — Define escalation triggers so the AI knows when to connect a visitor with a live agent. Customizable handoff messages ensure a professional transition.
* **Visitor Pre-Chat Form** — Optionally collect visitor name, email, and phone number before the conversation begins — perfect for lead generation and CRM enrichment.
* **18 Launcher Icons** — Choose from a curated icon library including chat, robot, headset, calendar, store, cafe, hotel, restaurant, spa, education, and more.
* **Light & Dark Mode** — Serve visitors in their preferred color scheme with full support for both light and dark widget themes.
* **Domain Whitelisting** — Lock the widget to specific domains for security. The chatbot will only appear on sites you explicitly authorize.
* **Auto-Open Configuration** — Set the chatbot to open automatically when a visitor arrives — maximizing engagement from the first second.
* **Notification Sound** — Enable an optional audio ping for incoming messages, ensuring visitors never miss a reply.
* **Widget Statistics** — Track total conversations, total messages, and last chat timestamp directly from your Avosist dashboard.

= 👥 Who Can Benefit from Avosist Chatbot? =

Avosist Chatbot is designed to meet the needs of various users and industries:

* 🏪 **E-Commerce Store Owners** — Answer product questions instantly, assist with order inquiries, and reduce cart abandonment with AI-powered shopping assistance.
* 🏥 **Healthcare & Clinic Websites** — Allow patients to ask questions, check availability, and book appointments 24/7 — without overwhelming your reception staff.
* ⚖️ **Law Firms & Consultancies** — Pre-qualify leads, answer common legal or advisory questions, and schedule consultations automatically.
* 🏨 **Hotels, Restaurants & Travel Businesses** — Handle booking inquiries, share availability, and provide personalized recommendations to guests instantly.
* 🎓 **Educational Institutions & Coaches** — Automate course inquiries, session booking, and student support with a smart, always-on assistant.
* 💼 **SaaS Companies** — Engage website visitors, qualify leads, and direct prospects to demos or pricing pages with contextual AI conversations.
* 🏗️ **Agencies & Freelancers** — Add a premium, AI-powered chatbot to any client website in minutes — no backend development required.
* 🛍️ **Retail & Service Businesses** — Capture leads, answer FAQs, take orders, and create support tickets automatically — all from a single chat widget.
* 💬 **Customer Support Teams** — Deliver 24/7 assistance to resolve user issues, answer common questions, and escalate complex queries to human agents when necessary.

== External Services ==

This plugin relies on the Avosist AI Platform (https://www.avosist.ai) as an external third-party service to function. The following data interactions occur:

**Avosist AI Platform**

The plugin connects your WordPress site to the Avosist cloud platform to enable chatbot functionality, widget configuration retrieval, and AI response generation.

* **Widget Script:** The plugin dynamically enqueues the chatbot widget script (`widget.js`) on the frontend from the Avosist servers.
* **Token Verification:** The plugin sends a secure HTTP request containing only the widget token to the Avosist API (`/api/chatbot/verify-token`) to verify the account connection during setup.
* **Message Processing:** Visitor messages are sent to the Avosist API to generate AI-powered responses in real time.
* **Widget Configuration:** The plugin retrieves your widget design settings, capabilities, and knowledge base configuration from the Avosist platform.

The plugin sends the following data to Avosist servers:

* Widget token (for authentication and configuration)
* Visitor messages (processed to generate AI responses)
* Session metadata (conversation ID, timestamp, IP address for rate limiting and security)

No visitor data is stored permanently on Avosist servers beyond what is necessary for generating AI responses and maintaining conversation context. Avosist does not sell or share visitor data with third parties.

* Terms of Service: https://www.avosist.ai/en/terms-of-service
* Privacy Policy: https://www.avosist.ai/en/privacy-policy


== Installation ==

1. Go to **Plugins > Add New** in your WordPress admin panel.
2. Search for "Avosist Chatbot".
3. Click **Install Now** and then **Activate**.
4. Go to **Settings > Avosist Chatbot**.
5. Click **Connect with Avosist** to authenticate, or enter your Widget Token manually.

== Frequently Asked Questions ==

= What is the Avosist – AI Chatbot WordPress plugin? =

The Avosist – AI Chatbot WordPress plugin lets businesses easily create, train, and publish AI-powered chatbots on their WordPress websites. It enhances visitor engagement by providing real-time, human-like assistance — answering questions, booking appointments, processing orders, and generating leads automatically. With a no-code setup and seamless WordPress integration, businesses can effortlessly improve customer support, streamline daily operations, and boost conversions from day one.

= How does the plugin simplify chatbot embedding on WordPress? =

Traditionally, embedding a chatbot required copying and pasting embed codes or working with shortcodes, which could be cumbersome for non-technical users. Avosist – AI Chatbot simplifies the process to just a few clicks. Once you have created and customized your chatbot in the Avosist Dashboard, you connect it to WordPress by entering your Widget Token or authenticating via the Connect with Avosist button. The plugin automatically injects the chatbot widget across your entire site — no theme editing, no code modifications, no technical knowledge required.

= Can I customize the chatbot to match my brand? =

Yes! The plugin offers extensive customization options to ensure your chatbot aligns perfectly with your brand identity. You can adjust its visual appearance by choosing from 18 launcher icons, selecting a custom accent color, toggling between light and dark modes, and setting a rounded or square corner style. Beyond appearance, you can customize the chatbot's name, persona, tone, and conversational style — making it formal, casual, friendly, or professional depending on your audience. You can also train it with your own business data including FAQs, product details, service policies, and pricing, so every response feels tailored and on-brand.

= Do I need any coding skills to use this plugin? =

Not at all! Avosist – AI Chatbot is designed to be fully no-code. The intuitive Avosist Dashboard guides you through every step — from creating your chatbot and uploading your knowledge base to configuring AI capabilities and going live on your WordPress site. Whether you are a small business owner, a content creator, or a developer, you can deploy a professional AI chatbot in under 2 minutes with zero technical effort.

= Can I train the chatbot with my own business data? =

Yes! Avosist – AI Chatbot provides powerful knowledge base training tools that allow you to upload PDFs, Excel spreadsheets, Word documents, and product catalogs directly into the platform. You can also add website URLs and let the AI automatically crawl and extract your site content. Once trained, the chatbot delivers precise, relevant answers about your services, pricing, policies, and operations. You can update the knowledge base at any time to keep the chatbot current as your business evolves.

= What types of questions can the chatbot answer? =

Avosist – AI Chatbot can handle everything from basic FAQs to complex, business-specific queries. Based on the data you provide in the knowledge base, it delivers detailed answers about product details, service availability, pricing, return policies, booking options, and more. It also provides context-aware responses, guides visitors through multi-step decisions, and assists with troubleshooting issues. The underlying AI continuously learns from each interaction to improve accuracy and relevance over time.

= How does appointment booking work through the chatbot? =

The Avosist – AI Chatbot can handle end-to-end appointment scheduling directly within the chat conversation. When the Appointment Booking capability is enabled in the Avosist Dashboard, visitors can request a booking through natural conversation. The chatbot checks available time slots, confirms the appointment details, and registers the booking to your Avosist calendar — all without any manual input from your team. This is ideal for clinics, salons, consultancies, coaches, and any service-based business that relies on scheduled appointments.

= Can visitors place orders through the chatbot? =

Yes! When the Order Creation capability is activated, the chatbot can take orders directly from visitors during the conversation. It collects the necessary order details, confirms availability, and logs the order to your Avosist dashboard for processing. This turns your website chatbot into an active sales channel — allowing visitors to complete a purchase or service request entirely within the chat window, without navigating to additional pages.

= How does the live human agent handoff work? =

When a visitor's request is too complex, sensitive, or outside the chatbot's training, the Avosist – AI Chatbot can seamlessly transfer the conversation to a live human agent. You can enable the Live Support Transfer option in the Avosist Dashboard under Widget Settings > AI Capabilities. Define the escalation trigger keywords or conditions, and the chatbot will automatically notify your team and hand off the conversation with full context preserved. This ensures visitors always receive the right level of support without frustrating dead ends.

= Where do I find my Widget Token? =

Your Widget Token is available in the Avosist Dashboard. Navigate to Web Chatbot, select the widget you want to embed, and click "Get Code". The token will be displayed and can be copied to your clipboard. Paste it into the plugin settings page under Settings > Avosist – AI Chatbot in your WordPress admin panel. Alternatively, use the "Connect with Avosist" button for a one-click OAuth authentication that retrieves your token automatically.

= Is an Avosist account free? =

Avosist offers a free trial plan that allows you to explore the platform and set up your first chatbot without any upfront cost. Paid plans unlock additional AI capabilities, higher message volumes, multiple widget support, and advanced integrations. For detailed and up-to-date pricing information, please visit https://www.avosist.ai/en/pricing.

= What industries benefit most from the Avosist AI Chatbot? =

Avosist – AI Chatbot is adaptable for a wide range of industries and business types:

* E-Commerce: Guide shoppers through product discovery, answer FAQs, process orders, and reduce cart abandonment with AI-powered assistance.
* Healthcare & Clinics: Allow patients to ask questions, check service availability, book appointments, and receive pre-visit instructions automatically.
* Real Estate: Qualify leads by collecting preferences, providing property information, and scheduling property tours through the chat.
* Education: Help students with enrollment processes, course information, fee structures, and feedback collection around the clock.
* Hospitality & Tourism: Streamline reservation processes, answer inquiries about amenities, and provide local travel recommendations to guests.
* Legal & Consultancy: Pre-qualify potential clients, answer common questions about services, and schedule consultations without phone calls.
* SaaS & Technology: Engage website visitors, qualify product-fit leads, and direct prospects to demos or pricing pages contextually.
* Retail & Service Businesses: Capture leads, answer product questions, take orders, and create support tickets — all within a single chat widget.

The chatbot adapts to specific business needs through custom knowledge base training, ensuring value across diverse applications.

= Is the plugin compatible with all WordPress themes? =

Yes! Avosist – AI Chatbot is compatible with all modern WordPress themes. The chatbot widget is injected using Shadow DOM encapsulation, which means it is completely isolated from your theme's CSS and will never cause layout conflicts or styling issues. Whether your site has a minimalist design or a feature-rich theme, the widget adapts effortlessly without interfering with your existing design. Regular plugin updates ensure full compatibility with the latest WordPress versions and popular page builders like Elementor, Divi, and WPBakery.

= Can I hide the widget on specific pages? =

By default, the widget loads sitewide across all pages of your WordPress website. If you prefer to display it only on specific pages, you can use the `[avosist_chatbot]` shortcode to embed the widget conditionally. Place the shortcode on any post, page, or widget area where you want the chatbot to appear. You can also use domain whitelisting in the Avosist Dashboard to restrict the widget to specific authorized domains.

== Screenshots ==

1. Admin settings page — Connecting with Avosist
2. Chatbot widget appearance on a WordPress site
3. Creating a widget from the Avosist Dashboard
4. Launcher icon customization options

== Changelog ==

= 1.4.1 =
* Fixed plugin header description to be in English.
* Finalized minor documentation translation adjustments.

= 1.4.0 =
* Fixed duplicate header verification issue by removing redundant Plugin URI.
* Added missing languages path folder inside plugin directory to satisfy textdomain checks.
* Disclosed third-party service dependency and updated links to www.avosist.ai.
* Added manage_options capability authorization checks to admin OAuth callback route for improved security.

= 1.3.9 =
* Added Cache lock and frontend check to prevent sending multiple duplicate email transcripts for the same session.

= 1.3.8 =
* Saved visitor name and email to database upon initial info submission.
* Synchronized local storage visitor details with API payload.
* Fixed SMTP From header conflict for transcript and human handoff notification emails.

= 1.3.7 =
* Injected FontAwesome styles dynamically to the light DOM document head to resolve rendering issues in Shadow DOM on certain browsers.

= 1.3.6 =
* Moved FontAwesome stylesheet tag inside HTML template block.

= 1.3.5 =
* Integrated FontAwesome CSS within Shadow DOM block to fix launcher icons mismatch.

= 1.3.4 =
* Restructured utensils launcher icon to fix drawing paths issues.

= 1.3.3 =
* Synchronized FontAwesome classes with custom SVG drawing wrappers.

= 1.3.2 =
* Converted launcher bubble to a tooltip and added support for notification sound.

= 1.3.1 =
* Disabled click behavior of quick chips while visitor form is active.

= 1.3.0 =
* Resolved visual flash of unstyled content (FOUC) and added fade-in transition behavior.

= 1.2.9 =
* Fixed style repaint lag in widget.js.

= 1.2.8 =
* Resized branding footer logo to 16px.

= 1.2.7 =
* Added avosist.ai link in footer branding.

= 1.2.6 =
* Added support for custom support agent avatars.

= 1.2.5 =
* Implemented chat transcript form and email delivery flow.

= 1.2.4 =
* Strengthened error catching when pulling chat history.

= 1.2.3 =
* Fixed history list disappearance on view change.

= 1.2.2 =
* Resolved widget JS syntax error (missing closing parenthesis).

= 1.2.1 =
* Fixed admin conversation stats calculation.

= 1.2.0 =
* Updated widget.js version to v2.1.0.

= 1.1.0 =
* Integrated widget.js version v2.0.0 with custom dark/light modes, quick replies, and human handoff notifications.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.4.1 =
Updated plugin header description to English and finalized minor documentation translations.

= 1.4.0 =
Disclosed third-party dependencies, secured OAuth callback handler, and standardized headers to comply with WordPress.org guidelines.

= 1.3.9 =
Security update preventing transcript duplicate email delivery.

= 1.3.8 =
Synchronized visitor info with backend database and resolved SMTP From header delivery issues.
