Docs
VoxelEon-wp: add VoxelEon to WordPress
The VoxelEon plugin connects your WordPress site to your VoxelEon account without copying any code. Log in on VoxelEon, approve the connection, and the chat widget appears on your site.
Requires WordPress 6.2+ and PHP 7.4+. Version 1.1.1.
1. Install the plugin
In WordPress go to Plugins → Add New → Upload Plugin, choose the zip you downloaded, install it, and press Activate.
2. Connect to VoxelEon
Open VoxelEon in the WordPress menu and press Connect to VoxelEon. You can log in or sign up, pick or create a website inbox, and approve. You land back in WordPress with the chat widget live and your conversations arriving in your VoxelEon inbox.
If your plan has no room for another inbox you can reuse an existing website inbox or upgrade from the connection screen.
3. Check it is installed
The VoxelEon screen shows Widget detected once the widget has loaded on your public site. If it says Not detected yet, visit your site and clear your caching plugin's cache.
Choose where the widget shows
You can hide the widget on specific pages or post types, URL patterns, for certain user roles, or on small screens. It never appears in wp-admin or the Customizer preview.
Open the chat from a button
Add the VoxelEon chat button block in the editor, or use the shortcode anywhere shortcodes work:
[voxeleon_button text="Chat with us"]Logged-in users
With Identify logged-in users on (the default), VoxelEon sees the user's name and email, and conversations are attributed to the right customer. The identity signature is created on your server, so the signing secret never reaches the browser.
Form leads
With Send form submissions to VoxelEon as leads on (the default), submissions from Contact Form 7, WPForms, Gravity Forms, Elementor Pro forms, Fluent Forms and Ninja Forms arrive in your inbox as a contact with a conversation labelled lead:wordpress. They are sent in the background and retried automatically, so a slow connection never blocks your form. A submission needs an email, or a phone number with a country code. If a form uses unusual field names, map them under Lead field mapping overrides.
WooCommerce
The agent sees which product or cart a visitor is looking at, and your published products (up to 500) are shared with VoxelEon so the AI can answer product questions. On a Business plan or above the AI can also look up an order for a customer, but only when the email or phone they give matches the order. It cannot tell a stranger whether an order number exists. Requests from VoxelEon are signed, and unsigned ones are refused. The plugin is compatible with High-Performance Order Storage. If you upgrade from version 1.0, press Disconnect and Connect once to enable order lookups.
Cookie consent and caching plugins
The plugin waits for consent when a plugin that supports the WP Consent API is active (Complianz, CookieYes, Cookiebot and others). It also tells WP Rocket, LiteSpeed Cache, Autoptimize, SG Optimizer and Perfmatters not to delay or combine the widget loader.
If your server blocks outbound requests
Open Advanced: paste a website token on the VoxelEon screen and paste the token from VoxelEon under Inboxes, your website inbox, Configuration. Status checks need the Connect button.
Self-hosted VoxelEon
Add this line to your wp-config.php:
define( 'VOXELEON_BASE_URL', 'https://chat.example.com' );Disconnect and uninstall
Press Disconnect to remove the widget and tell VoxelEon the site is gone. Deleting the plugin removes everything it stored.
Need help?
Email hello@voxeleon.com and we'll help you get the widget live.