=== Uplizd Engage - Widget Chat === Contributors: johntran94 Tags: chat, chatbot, live chat, customer support, uplizd Requires at least: 5.0 Tested up to: 6.9 Requires PHP: 7.2 Stable tag: 1.0.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add Uplizd Engage chatbot to your WordPress site using your Flow ID and API key. No code pasting required. == Description == Uplizd Engage - Widget Chat adds Uplizd Engage's AI chatbot to your WordPress site using simple form fields. Enter your Flow ID and API Key from the Uplizd Engage dashboard; the plugin enqueues the embed script and configuration via WordPress hooks—no arbitrary script or code insertion. **Why Choose Uplizd Engage - Widget Chat:** * **Simple form setup** - Enter Flow ID and API Key; no pasting of code * **Secure** - No arbitrary CSS/JS/PHP; plugin builds and enqueues the embed properly * **Flexible positioning** - Choose header or after body tag insertion (after body tag recommended) * **Optional customization** - Window title, Theme Color (#00C2C9 default), Chat bubble button color (#000000 default), placeholder, position (Bottom Right default), theme (Light default), logo URL * **Mobile responsive** - Works on all devices and screen sizes * **Lightweight** - Script loaded with defer; minimal impact on performance * **WordPress compliant** - Uses wp_enqueue_script and sanitized options only **How It Works:** 1. Log in to the Uplizd Engage dashboard, select your Agent, open Deploy from the left menu, and click the WordPress logo to get your configuration values 2. Enter Flow ID and API Key in the plugin settings (required) 3. Optionally set window title, Theme Color, Chat bubble button color, placeholder, position, theme, and logo URL 4. Choose insert position (after body tag is recommended) 5. Enable the chatbot and save; the plugin enqueues the embed script and config for you **Perfect for:** * Customer support automation * Lead generation and qualification * FAQ automation * E-commerce product assistance * Appointment booking * General inquiries * 24/7 customer engagement == Installation == **Automatic installation:** 1. Go to Plugins > Add New in your WordPress admin 2. Search for "Uplizd Engage Widget Chat" 3. Click "Install Now" 4. Click "Activate" **Manual installation:** 1. Download the plugin zip file 2. Go to Plugins > Add New > Upload Plugin 3. Choose the zip file and click "Install Now" 4. Click "Activate Plugin" **After installation:** 1. Go to "Uplizd Engage" in the WordPress admin sidebar 2. Log in to your Uplizd Engage dashboard at https://engage.uplizd.ai 3. Select the Agent you want to deploy, then open the Deploy feature from the left menu 4. Click the WordPress logo to get your Flow ID and API Key (configuration values) 5. Enter Flow ID and API Key in the plugin settings 6. Optionally set window title, Theme Color, Chat bubble button color, position, theme, and logo URL 7. Choose insert position (after body tag is recommended) 8. Check "Enable Chatbot" and click "Save Settings" 9. Visit your website to see the chatbot in action == Frequently Asked Questions == = Do I need an Uplizd Engage account to use this plugin? = Yes. You need an active Uplizd Engage account to get your Flow ID and API Key. Visit https://engage.uplizd.ai to create an account and set up your chatbot. = Is this plugin free? = Yes, the plugin itself is completely free. Your Uplizd Engage account pricing depends on your subscription plan. = Where do I find my Flow ID and API Key? = Log in to your Uplizd Engage dashboard at https://engage.uplizd.ai, select the Agent you want to deploy, then select the Deploy feature from the left menu. Click the WordPress logo to get your configuration values (Flow ID and API Key). Enter them in the plugin settings—do not paste any script or code. = Can I customize the chatbot appearance? = Yes. Use the optional fields in the plugin settings: Window Title, Theme Color (default #00C2C9), Chat bubble button color (default #000000), Placeholder, Online Message, Widget Position (default Bottom Right), Theme (default Light), and Logo URL. The plugin uses the values you enter in the form. = Which insertion position should I choose? = We recommend "After body tag (wp_body_open)". You can choose Header (wp_head) or After body tag. The chatbot will appear on screen regardless of which option you select. = Will this slow down my website? = No. The chatbot script is loaded asynchronously with the defer strategy and is very lightweight (typically less than 50KB), ensuring minimal impact on your website's performance and page load times. = Can I disable the chatbot temporarily? = Yes, simply uncheck the "Enable Chatbot" option in the plugin settings and save. You can re-enable it anytime by checking the box again. = Does this work with all WordPress themes? = Yes, the plugin works with themes that implement wp_head or wp_body_open. If your theme doesn't support wp_body_open, choose Header (wp_head) for insert position. = Is the plugin mobile responsive? = Yes, the Uplizd Engage chatbot is fully responsive and automatically adapts to all screen sizes and devices. = The chatbot isn't showing up. What should I do? = Please check: 1. "Enable Chatbot" is checked and settings are saved 2. Flow ID and API Key are both entered and correct 3. Your Uplizd Engage account is active 4. Clear browser and WordPress cache 5. Open browser console (F12) for JavaScript errors 6. Ensure your theme supports the selected insertion hook (try "After body tag") 7. Confirm Host URL is correct (default: https://api-engage.uplizd.ai) If issues persist, contact Uplizd support at support@uplizd.ai = How do I update my chatbot settings? = Edit the Flow ID, API Key, or any optional fields (window title, colors, position, theme, etc.) in the plugin settings and click "Save Settings". Changes take effect on the next page load. = Can I use different chatbots on different pages? = Currently, the plugin supports one chatbot configuration for your entire website. For page-specific chatbots or advanced routing, please contact Uplizd Engage support to discuss custom implementation options. = Is my data secure? = Yes. The plugin does not accept or execute arbitrary code. It only stores sanitized form values (Flow ID, API Key, URLs, colors, text) and builds the embed configuration programmatically. Nonce verification, input sanitization, and output escaping are used. Chat data is transmitted via HTTPS to Uplizd Engage; see Uplizd's privacy policy for data handling. = Does this work with page builders like Elementor, Divi, etc.? = Yes, the plugin works independently of page builders since it uses WordPress hooks. It will function correctly with any page builder. = Can I use a custom API host? = Yes. Use the "Host URL" field in the plugin settings. Leave it at the default (https://api-engage.uplizd.ai) unless you have a custom API endpoint. == Screenshots == 1. Settings page with Flow ID, API Key, Theme Color, Chat bubble button color, and optional fields 2. Insert position (Header or After body tag) and enable checkbox 3. Chatbot widget on website (e.g. bottom right) 4. Chatbot conversation in light theme 5. Chatbot conversation in dark theme 6. Mobile responsive view == Changelog == = 1.0.2 = * **Security / WordPress guidelines:** Removed arbitrary embed code field. Plugin no longer allows users to paste custom CSS, JavaScript, or PHP. * Configuration is now form-based: required fields are Flow ID and API Key; optional fields include Host URL, Window Title, Theme Color (default #00C2C9), Chat bubble button color (default #000000), Placeholder, Online Message, Widget Position (default Bottom Right), Theme (default Light), Logo URL. Insert position: Header or After body tag (recommended). * Embed script URL is fixed and controlled by the plugin (https://engage.uplizd.ai/embed/bundle.min.js). Script and inline config are enqueued via wp_enqueue_script and wp_add_inline_script with appropriate hooks. * Existing users who previously used the embed code field will need to re-enter Flow ID and API Key (and any optional settings) in the new form. = 1.0.1 = * Initial public release * Support for wp_head and wp_body_open insertion positions (after body tag recommended) * Nonce verification, input sanitization, output escaping * Uses wp_enqueue_script() and defer loading == Upgrade Notice == = 1.0.2 = Important: Arbitrary embed code input has been removed per WordPress plugin guidelines. Please enter your Flow ID and API Key (and any optional settings) in the new form. Re-save your settings after upgrading. == External Services == This plugin relies on Uplizd Engage's external service to provide chatbot functionality. By using this plugin, your website will connect to third-party services operated by LIZAI INC. / Uplizd Engage. **What is sent and when:** * When the chatbot widget loads on your website, a connection is established to Uplizd Engage's servers * User chat messages and interactions are transmitted to Uplizd Engage's API for processing and AI response generation * The chatbot widget JavaScript bundle is loaded from Uplizd Engage's CDN * Data transmission occurs whenever a visitor interacts with the chatbot on your site * Session data and analytics may be collected to improve chatbot performance **External services used:** 1. **Uplizd Engage Chat API** * Service URL: https://staging-api-engage.upliz.dev (or your configured host URL) * Purpose: Backend API for processing chat messages, managing conversations, and generating AI responses * Data sent: Chat messages, session data, user interactions, timestamps * When: Every time a visitor sends a message through the chatbot 2. **Uplizd Engage CDN** * Script URL: https://staging-engage.upliz.dev/embed/bundle.min.js (or your configured script URL) * Purpose: Delivers the chatbot widget interface and functionality * Data sent: Page URL, referrer, basic browser information * When: Every time a page with the chatbot loads on your website **Legal information:** * Service provider: LIZAI INC. (Uplizd Engage) * Website: https://engage.uplizd.ai * Terms of Service: https://engage.uplizd.ai/terms * Privacy Policy: https://engage.uplizd.ai/privacy **Important - Your responsibilities:** By installing and activating this plugin, you acknowledge that: * User data will be transmitted to Uplizd Engage's third-party servers for processing * You are responsible for ensuring compliance with applicable privacy laws in your jurisdiction (GDPR, CCPA, etc.) * You should update your website's privacy policy to disclose this third-party data sharing * Uplizd Engage's Terms of Service and Privacy Policy apply to all data processed through their service * You should inform your website visitors about the use of this chatbot service **Data protection:** * All data transmission occurs over secure HTTPS connections * Uplizd Engage follows industry-standard security practices * For detailed information about data handling, retention, and processing, please review Uplizd Engage's Privacy Policy Please review Uplizd Engage's Terms of Service and Privacy Policy carefully before using this plugin. == Support == For plugin-related issues, please use the WordPress.org support forum. For Uplizd Engage service questions or chatbot configuration help: * Email: support@uplizd.ai * Documentation: https://engage.uplizd.ai/docs * Dashboard: https://engage.uplizd.ai == About Uplizd Engage == Uplizd Engage is an AI-powered customer engagement platform that helps businesses automate customer support, generate leads, and improve customer satisfaction through intelligent chatbot conversations. Learn more at https://engage.uplizd.ai