GoVivace Chatbot

Contributors: nagendragoel, GoVivace Team

Tags: chatbot, ai, assistant
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

**Short Description :**
Add an AI-powered chatbot to your WordPress site using a Bot ID, backed by GoVivace’s conversational AI services.

**Key Features**

🔹 Dynamic chatbot loading via Unique Bot ID   
🔹 Customizable greetings and theme configuration  
🔹 Secure FastAPI backend integration   
🔹 Lightweight and optimized for performance  
🔹 Easy WordPress admin configuration page  
🔹 Screen reader compatible with spoken playback of bot responses   


**External Services**
This plugin relies on GoVivace external cloud services to function.  

=== 1. GoVivace Deployment Info API ===

**Domain Used:** ` https://services.govivace.com`

Used for fetching chatbot configuration and metadata based on the user-provided Bot ID.
When the admin saves a Bot ID in the plugin settings or when the chatbot is initialized on the frontend.

Data sent:
- Public Bot ID (no secret keys)  
- Basic request metadata (standard HTTPS request information)

Purpose:
To retrieve the bot’s display information, model configuration, and related deployment settings.

=== 2. GoVivace Conversational AI / NLU Service ===

**Domain Used:** ` https://services.govivace.com`

Used for processing user queries and generating chatbot responses.
Each time a user submits a message in the chatbot widget.

Data sent: 
- The user’s message text    
- Session identifiers (non-personal, generated in the browser)

Purpose: 
To return NLU-generated responses that power the chatbot’s conversation.

This service is provided by "GoVivace INC": [terms of use](https://govivace.com/fair-use-policy/), [privacy policy](https://govivace.com/privacy-policy/).

=== 3. ipify.org Public IP Lookup ===

**Domain Used:**  ` https://api.ipify.org`

Purpose:
To obtain the site visitor’s public IP address for the following:
- Create a lightweight, non-cookie session ID  
- Prevent abuse  
- Support session continuity between messages  

Data sent to ipify:
- No personal data  
- Only a direct request from the user's browser (ipify returns the public IP)

ipify Service Info:  
Website: https://www.ipify.org  

**Installation**

1. Install the `govivace-chatbot` plugin via the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **Settings → GoVivace Chatbot** to configure:
   - Your `Unique Bot ID`
4. The chatbot will automatically appear on the website footer after configuration.


**Screenshots**

![alt text](assets/image1.png)

![alt text](assets/image2.png)

![alt text](assets/image.png)

**Changelog**

= 1.1.0 =
* Added screen reader compatibility for improved accessibility
* Bot responses can now be read aloud by screen readers

= 1.0 =
* Initial release

**Upgrade Notice**

= 1.1.0 =
Adds screen reader compatibility, allowing bot responses to be read aloud for improved accessibility.

= 1.0 =
Initial stable release. Recommended for all users.

**License**
This plugin is licensed under the **GPLv2 or later** license.  
See <https://www.gnu.org/licenses/gpl-2.0.html> for details.

Third-party libraries used (MIT/GPL compatible):
* ScrollReveal.js – MIT License  
* jQuery – MIT License
* Bootstrap 5.3.3 - MIT License
* Moment - MIT License

