=== Call Agent AI – Voice & Chat Assistant ===
Contributors: callagentai
Tags: ai chatbot, ai voice, ai call assistant, customer support, lead generation, appointment booking
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.2.5
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add AI voice calls and chat to your WordPress site to automate customer support, capture leads, and book appointments 24/7.

== Description ==

**Call Agent AI lets visitors talk to or chat with an AI assistant directly on your WordPress website.
Instantly handle customer support, lead qualification, and bookings — 24/7, without hiring staff.**

Call Agent AI is an AI voice and chat assistant plugin for WordPress that helps businesses automatically handle customer conversations, qualify leads, and book appointments — directly on their website.

Instead of missed messages or delayed responses, your visitors can:
* **Talk to an AI agent in real time
* **Chat instantly to get answers
* **Book appointments or leave contact details
* **Get help anytime, even outside business hours
* **No complex setup. No coding required.

= Two Widget Experiences (Choose What Fits Your Site) =
* **Chat + Voice Widget (Full Widget):** A full assistant experience with both text chat and voice calling in one place.  
* **Centered Voice Button (Voice-Only):** A clean, centered voice call button for sites that want a simple “tap to talk” experience.

= Explore the Features That Power Smarter Conversations with Call Agent AI =
Call Agent AI is more than an answering machine or basic chatbot.
It’s a full AI call + chat system designed to handle real conversations, automate follow-ups, and integrate directly into your business workflow.
Whether you need 24/7 call handling, smarter lead capture, or seamless CRM sync, every feature is built to save time, reduce missed opportunities, and scale customer conversations effortlessly.

* **AI Voice & Chat Assistant for WordPress** - Let visitors talk to or chat with an AI assistant directly on your website — in real time.
* **24/7 AI Call Answering** - Answer customer calls instantly, day or night, so you never miss leads or support requests.
* **Realistic, Human-Like AI Voice** - Natural conversations with interruptible speech for a more human experience.
* **AI Appointment Scheduling** - Book, reschedule, and confirm appointments automatically with email and SMS reminders.
* **Multilingual & Multi-Accent Support** - Serve global audiences with AI that speaks multiple languages and accents.
* **Real-Time Call & Chat Logs** - Capture every conversation accurately for records, training, and follow-ups.
* **Automated Follow-Ups & Reminders** - Send confirmations, updates, and next-step messages automatically after calls.
* **Zoho CRM Integration** - Sync calls, leads, and outcomes to **Zoho CRM** so your team always has context and follow-up details.
* **Integrations via Webhooks (Connect Your Favorite Apps)** - Trigger automations in your tools using **webhooks** — send conversation outcomes to CRMs, helpdesks, Slack, Zapier-like workflows, and more.
* **Customizable AI Assistant** - Configure your AI’s personality, knowledge base, and responses from the Call Agent AI dashboard.
* **Customizable AI Workflows** - Control how your AI responds, routes calls, schedules appointments, and triggers actions — no code required.
* **Flexible Widget Placement** - Display the widget in any corner of your site or embed it anywhere using shortcodes.
* **Shortcode & Widget Support** - Add the AI assistant to pages, posts, sidebars, or widget areas.
* **Mobile-Responsive Design** - Works seamlessly on desktop, tablet, and mobile devices.
* **Secure & Reliable** - All data is transmitted securely and is end-to-end encrypted.

= Who This Plugin Is For =
Call Agent AI is ideal for:

* Small businesses & service providers  
* Agencies and consultants
* E-commerce and local businesses
* SaaS companies and startups
* WordPress site owners who want automated customer support

If your website receives questions, calls, or booking requests — this plugin helps you handle them automatically.

= How It Works =

1. Create a free account on [Call Agent AI](https://admin.callagentai.com)
2. Set up your AI assistant (voice, chat, knowledge, behavior)
3. Generate your API token and access your Assistant ID
4. Install this plugin on your website and enter the required credentials
5. Your AI assistant is live on your WordPress site!

= Popular Use Cases =

* AI Customer Support – Answer questions automatically, 24/7
* Lead Generation – Collect names, emails, and phone numbers
* FAQ Automation - Answer common questions automatically and reduce repetitive inquiries
* Appointment Booking – Help visitors schedule calls or meetings
* Product & Service Recommendations - Guide customers to the right products for them

= Requirements =

* A Call Agent AI account (free trial available)
* An active AI assistant
* API token from your Call Agent AI dashboard

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "Call Agent AI"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin zip file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the zip file and click "Install Now"
5. Activate the plugin

= Configuration =

1. Go to Settings > Call Agent AI
2. Sign up at [admin.callagentai.com](https://admin.callagentai.com) if you haven't already
3. Create an AI assistant in your dashboard
4. Generate an API token from the API Tokens section
5. Copy your Assistant ID from the assistant settings
6. Paste both values in the plugin settings
7. Add your WordPress website URL to CORS in assistant settings
8. Enable the widget and choose its position
9. Save your settings

== Frequently Asked Questions ==

= Do I need a Call Agent AI account? =

Yes, you need a CallAgentAI account to use this plugin. You can sign up for a free trial at [admin.callagentai.com](https://admin.callagentai.com).

= Is there a free trial? =

Yes! New accounts receive free trial minutes to test the service.

= How do I create an AI assistant? =

After signing up, log in to your Call Agent AI dashboard and navigate to the Assistants section. Click "Create Assistant" and configure your AI's personality, voice, and knowledge base.

= Where can I find my API token? =

In your Call Agent AI dashboard, go to Settings > API Tokens. Click "Generate New Token" and copy the token.

= Where can I find my Assistant ID? =

In your Call Agent AI dashboard, go to Assistants, select your assistant, and you'll find the Assistant ID in the URL or settings page.

= Can I use different assistants on different pages? =

Yes! You can use the shortcode with different assistant IDs:
`[callagai_widget assistant_id="your-assistant-id"]`

= Can I customize the widget appearance? =

The widget design is optimized for user experience. You can choose the position (bottom-right, bottom-left, top-right, top-left). Custom styling can be added via CSS.

= Is the widget mobile-friendly? =

Yes, the widget is fully responsive and works on all devices including smartphones and tablets.

= How are calls/chats counted? =

Each conversation uses minutes from your account based on duration. Check your Call Agent AI dashboard for detailed usage statistics.

= Can I track conversations? =

Yes, all conversations are logged in your Call Agent AI dashboard where you can view transcripts, analytics, and insights.

== Screenshots ==

1. AI voice and chat assistant answering visitors directly on a WordPress website
2. AI chat assistant answering visitor questions directly on a WordPress website
3. Visitors can start real-time AI voice conversations directly on a WordPress website
4. Quick and simple setup directly inside the WordPress dashboard
5. Customize your AI assistant’s personality, knowledge, and behavior from the Call Agent AI dashboard

== Changelog ==

= 1.2.5 =
* Added "Hide on Pages" setting for both Chat & Voice Widget and Voice Button
* Users can now exclude specific pages from showing either widget via the admin settings
* Excluded pages also skip loading widget CSS/JS for better performance

= 1.2.4 =
* Added clickable links in chat messages (URLs now open in new tab)
* Added End Chat button to close widget and reset for fresh conversation
* Added transcript_link template variable for emails/SMS

= 1.2.3 =
* Fixed email and SMS notifications not sending when user closes browser/tab
* Added beforeunload handler for reliable call/chat end signaling
* Fixed WebSocket race condition - delayed close to allow server post-call processing
* Added AI-generated chat/call summary template variable support
* Improved email error logging and skip detection

= 1.2.2 =
* Enhanced input sanitization with whitelist validation for position fields
* Improved register_setting configuration with proper sanitize_callback format
* Added strict type checking for input validation
* Enhanced color input validation for voice button settings

= 1.2.1 =
* Feature UX and validation improvements
* Enhanced user experience for test assistant functionality

= 1.2.0 =
* Added feature mode selection (both, chat_only, call_only)
* Users can now choose which features to enable for visitors
* Improved widget configuration options

= 1.1.0 =
* Added account plan status display in admin settings
* Shows voice call and chat plan information
* Added upgrade prompts for inactive plans
* Improved admin settings UI with two-column layout

= 1.0.8 =
* Added support for new message types: 'utterance', 'ended', 'pong'
* Added handling for live transcription (utterance) messages
* Added handling for session end with usage statistics
* Improved message type coverage for full backend compatibility
* Enhanced error handling and logging

= 1.0.7 =
* CRITICAL: Fixed compatibility with backend message type changes
* Added support for 'assistant_text' message type from regular AI models
* Maintained backward compatibility with 'response' message type
* Plugin now works with latest backend changes for both Realtime and regular models

= 1.0.6 =
* Fixed audio distortion in web calls with OpenAI Realtime models
* Added dynamic sample rate support (16kHz for regular models, 24kHz for Realtime)
* Fixed bidirectional audio/text streaming for all AI models
* Improved audio quality to match callagentai.com main site

= 1.0.5 =
* Performance optimizations for WebSocket connections
* Improved error handling for network issues

= 1.0.4 =
* Added typing indicator for chat mode
* Improved message scrolling behavior

= 1.0.3 =
* Fixed widget positioning on mobile devices
* Improved responsive design

= 1.0.2 =
* Added support for custom greeting messages
* Bug fixes and stability improvements

= 1.0.1 =
* Minor bug fixes
* Improved compatibility with various themes

= 1.0.0 =
* Initial release
* Voice call functionality
* Text chat functionality
* Shortcode support
* WordPress widget support
* Customizable positioning
* Mobile responsive design

== Upgrade Notice ==

= 1.2.2 =
Security and validation improvements: Enhanced input sanitization with whitelist validation for all select fields.

= 1.2.1 =
Feature UX and validation improvements for test assistant functionality.

= 1.2.0 =
New feature: Choose which features (chat, call, or both) to enable for your visitors.

= 1.1.0 =
New admin feature: View your account plan status directly in WordPress settings.

= 1.0.8 =
Important update: Adds support for new backend message types including live transcription and session statistics. Recommended for all users.

= 1.0.7 =
CRITICAL UPDATE: Required for compatibility with latest backend changes. Chat mode was broken for regular AI models (GPT-4, Gemini) without this update.

= 1.0.6 =
Important update: Fixes audio distortion issues with OpenAI Realtime models. Recommended for all users.

= 1.0.0 =
Initial release of Call Agent AI – Voice & Chat Assistant plugin.

== Usage ==

= Basic Usage =

Once configured, the widget will automatically appear on all pages of your site based on your position setting.

= Shortcode Usage =

Add the widget to specific pages or posts:

`[callagai_widget]`

Use custom settings per page:

`[callagai_widget api_token="your-token" assistant_id="your-assistant-id" position="bottom-right"]`

= Widget Usage =

1. Go to Appearance > Widgets
2. Drag "Call Agent AI" widget to your desired widget area
3. Configure the widget settings (or leave empty to use global settings)
4. Save

== Support ==

For support, please visit:
* Documentation: [https://callagentai.gitbook.io/docs/](https://callagentai.gitbook.io/docs/installation-and-setup/voice-and-chatbot-web-agent/wordpress)
* Email: accounts@callagentai.com
* Dashboard: [https://admin.callagentai.com](https://admin.callagentai.com)

== Privacy ==

This plugin connects to Call Agent AI servers to provide AI conversation functionality. When users interact with the widget:
* Audio/text data is transmitted to Call Agent AI servers for processing
* Conversations are stored for analytics and improvement
* No personal data is collected without user consent
* All data transmission is encrypted via HTTPS/WSS

For more information, see:
* [Call Agent AI Privacy Policy](https://callagentai.com/data-privacy-policies)
* [Call Agent AI Terms of Service](https://callagentai.com/ai-terms-and-conditions)

== Third-Party Services ==

This plugin relies on CallAgentAI, an external AI service, to provide voice call and chat functionality.

**Service Provider:** Call Agent AI
**Website:** [https://callagentai.com](https://callagentai.com/wordpress-ai-voice-chat-assistant/)
**Dashboard:** [https://admin.callagentai.com](https://admin.callagentai.com)

**What data is sent:**
* Audio data during voice calls
* Text messages during chat conversations
* Your API token and Assistant ID for authentication

**Legal Documents:**
* Terms of Service: [https://callagentai.com/ai-terms-and-conditions](https://callagentai.com/ai-terms-and-conditions/)
* Privacy Policy: [https://callagentai.com/data-privacy-policies](https://callagentai.com/data-privacy-policies/)
