SolveoAI Chat Widget

Beschreibung

SolveoAI lets you deploy a fully AI-powered chat widget on your WordPress site in minutes.

How it works

  1. Create an AI agent in the SolveoAI Dashboard.
  2. Install this plugin.
  3. Go to Settings > SolveoAI and paste your Widget ID (or Agent ID).
  4. Done — the widget appears on your site immediately.

Features

  • One-click setup — no code required
  • Full appearance control — override primary color, position, theme (light/dark/auto) from WordPress
  • Behavior settings — custom greeting, auto-open, proactive teaser messages
  • Page visibility rules — show on all pages, specific URLs only, or exclude specific URLs
  • Per-page control — force show or hide the widget on individual posts/pages via a meta box
  • Shortcode support[solveoai_chat] to embed the widget in specific content areas
  • Gutenberg block — drag-and-drop chat widget block with settings panel
  • WooCommerce integration — automatic customer identification, product recommendations, order lookup, cart assistance
  • Custom CSS injection — style the widget inside its Shadow DOM
  • JavaScript API — programmatic control via SolveoWidget.open(), .close(), .toggle(), .newChat(), .sendMessage()
  • Self-hosting support — custom API URL and widget script URL
  • Shadow DOM isolation — no CSS conflicts with your theme
  • Compatible with all WordPress themes and builders (Elementor, Divi, Gutenberg, etc.)

Widget Capabilities

All features from the SolveoAI widget are available:

  • AI chat with markdown support
  • File attachments (images, video, audio, documents)
  • Voice note recording
  • Live chat / human handoff with queue position
  • Lead forms (pre-chat, inline, AI-triggered)
  • Chat history and persistence
  • Message feedback (thumbs up/down)
  • Notification sounds
  • Product cards with Add to Cart (Shopify & WooCommerce)
  • Order tracking and fulfillment cards
  • Booking integration (Cal.com, Calendly)
  • Image galleries and action buttons

Self-Hosting

If you are running the SolveoAI platform yourself, update the API URL and Widget Script URL fields in the Advanced tab to point to your own deployment.

External services

This plugin connects to the SolveoAI platform to power an AI chat widget on your WordPress site.

SolveoAI Widget Script (widget.solveoai.io)

When any front-end page loads (and the widget is enabled), the plugin loads a JavaScript file from https://widget.solveoai.io/widget-core.js. This script renders the chat widget in the visitor’s browser. No personal data is sent during this step; the browser simply downloads the script file.

SolveoAI API (api.solveoai.io)

Once the widget script is loaded, it communicates with the SolveoAI API at https://api.solveoai.io/api/v1 to provide chat functionality. The following data is sent to this service:

  • Widget / Agent configuration — the widget fetches its appearance and behavior settings using the Widget ID or Agent ID configured in the plugin settings. This happens on every page load where the widget is active.
  • Chat messages — when a visitor types a message in the chat widget, the message text and any file attachments are sent to the API so that the AI agent can generate a response.
  • Lead form submissions — if a pre-chat lead form is enabled, the visitor’s name, email, and any other form fields are sent to the API.
  • Conversation history — the widget may request previous messages for a returning visitor’s conversation from the API.
  • Real-time messaging — the widget opens a WebSocket connection (via Socket.IO) to the API for real-time message delivery, typing indicators, and queue updates.

Both the API URL and the Widget Script URL can be changed in Settings > SolveoAI > Advanced to point to a self-hosted deployment if you prefer not to use the hosted service.

This service is provided by SolveoAI: Terms of Service, Privacy Policy.

Blöcke

Dieses Plugin bietet 1 Block.

  • SolveoAI Chat Widget Embed the SolveoAI AI chat widget in a specific location on the page.

Installation

  1. Upload the solveoai-chat-widget folder to /wp-content/plugins/solveoai-chat-widget/, or install via the WordPress plugin directory.
  2. Activate the plugin in Plugins > Installed Plugins.
  3. Go to Settings > SolveoAI and enter your Widget ID (or Agent ID).

FAQ

Where do I find my Widget ID?

Log in to app.solveoai.io, open your agent, navigate to Deploy > WordPress, and copy the Widget ID shown there. If you only have an Agent ID, that works too.

Does the widget slow down my site?

No. The widget script is loaded with the defer attribute and is served from a fast CDN. It has no impact on your page’s critical rendering path.

Can I limit the widget to specific pages?

Yes! Go to Settings > SolveoAI > Visibility to set URL include/exclude patterns. You can also use the per-page meta box in the post/page editor to force show or hide on individual pages.

Can I embed the widget in a specific location?

Yes. Use the [solveoai_chat] shortcode or the SolveoAI Chat Widget Gutenberg block to place the widget inline within your content.

Can I customize the widget appearance?

Yes. The Appearance tab lets you override the primary color, position, and theme. For further customization, use the Custom CSS field in the Advanced tab. All widget styling is configured in the SolveoAI Dashboard and can be overridden per-site in WordPress.

Is the plugin compatible with page caching plugins?

Yes. The widget uses programmatic initialization and does not rely on PHP-rendered session data for chat functionality, so it works with HTML caching.

Rezensionen

Für dieses Plugin gibt es keine Rezensionen.

Mitwirkende und Entwickler

„SolveoAI Chat Widget“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

Änderungsprotokoll

3.0.0

  • Full appearance override: primary color (with color picker), position, theme (light/dark/auto).
  • Behavior settings: custom greeting, auto-open, proactive message with delay.
  • Page visibility controls: include/exclude URL patterns with wildcard support.
  • Per-page meta box: force show or hide on individual posts/pages.
  • Shortcode [solveoai_chat] with attribute overrides.
  • Gutenberg block solveoai/chat-widget with inspector controls.
  • Programmatic initialization via SolveoWidgetCore() instead of data-* attributes.
  • Enhanced WooCommerce auto-configure endpoint (accepts widget_id).
  • WooCommerce Store API detection notice.
  • Custom CSS injection and z-index override.
  • Tabbed admin settings with admin CSS/JS assets.
  • JavaScript API documentation in the Advanced tab.
  • Updated uninstall to clean all options and post meta.

2.0.0

  • Widget ID support (preferred over Agent ID).
  • Updated to use widget-core.js with data-* attribute initialization.
  • Removed legacy window global injection in favor of script tag data attributes.
  • Updated default URLs (widget-core.js, api/v1 endpoint).

1.0.0

  • Initial release.