Description
Zens AI Customer Support connects a WordPress site to the Zens AI support service. It adds the customer support widget without requiring you to paste code into a theme, and it keeps optional identity signing on your server.
The plugin is inactive by default. It contacts Zens AI only after an administrator enters a Zens AI Site ID and explicitly enables the connection.
Features
- Add the Zens AI support widget sitewide.
- Show or hide the floating chat launcher.
- Let anonymous visitors choose whether to leave an email for follow-up.
- Optionally identify logged-in WordPress users with an HMAC-signed profile.
- Keep the signing secret in
wp-config.phpinstead of the WordPress database. - Keep session recording disabled by default.
- Add suggested Zens AI wording to the WordPress Privacy Policy Guide.
- Follow the active WordPress locale in plugin settings and the page language in the customer support widget.
- Remove all plugin settings when the plugin is deleted.
You need a Zens AI account and a Site ID to use this plugin. Zens AI is a hosted software service; the service may offer free and paid plans independently of this plugin.
External service
This plugin connects to the Zens AI service at https://zens.ai to provide customer support chat, visitor context, and the optional features selected by a site administrator.
No request is made to Zens AI merely by installing or activating the plugin. Requests begin only after an administrator saves a Site ID and enables Zens AI.
When enabled, the service may receive:
- Page URL and title, referrer, browser language, and UTM source.
- Anonymous visitor and browser-session identifiers stored in the visitor’s browser.
- Presence, pageview, and chat activity.
- Chat messages and attachments submitted by the visitor.
- An email address the visitor chooses to provide for follow-up.
- If signed identity is enabled: the logged-in user’s stable WordPress identifier, display name, email address, and registration date.
- If session recording is enabled: visitor interactions and visible page content captured for support purposes.
Zens AI uses this information to deliver the support service selected by the site administrator. Review the service documents before enabling the connection:
- Zens AI Privacy Policy: https://zens.ai/privacy
- Zens AI Terms of Service: https://zens.ai/terms
- Zens AI Integration Guide: https://zens.ai/docs/getting-started/customer-integration
Site owners are responsible for providing any notices and obtaining any consent required for their site, visitors, and jurisdiction.
Development
Source code and issue tracking are available at https://github.com/ZensHQ/wordpress.
Installation
- Upload the
zens-ai-customer-supportfolder to/wp-content/plugins/, or install the plugin through the WordPress Plugins screen. - Activate Zens AI Customer Support.
- In your Zens AI workspace, create a customer site and add your WordPress domain as an allowed origin.
- In WordPress, go to Settings Zens AI.
- Paste the public Site ID, review the data notice, select Enable Zens AI, and save.
- Open a public page in a private browser window and send a test message.
Optional signed identity
Signed identity connects a logged-in WordPress user to their support conversation. Copy the one-time signing secret from Zens AI and add it above the “stop editing” line in wp-config.php:
define( 'ZENS_AI_SIGNING_SECRET', 'cc_secret_xxxxxxxxxx' );
Then enable Signed identity under Settings Zens AI.
The secret is used only on the WordPress server to create an HMAC-SHA256 signature. It is not stored in the plugin settings or included in the public page.
FAQ
-
Does the plugin send data as soon as I activate it?
-
No. The connection is disabled by default. The plugin loads the external service only after an administrator adds a Site ID and explicitly enables Zens AI.
-
Is the Site ID secret?
-
No. The Site ID is a public identifier included in the browser SDK configuration. The signing secret is private and must remain in
wp-config.php. -
Is session recording enabled automatically?
-
No. The WordPress plugin blocks session recording by default. An administrator must enable it in WordPress, and it must also be enabled for the site in Zens AI.
-
Can I use chat without sharing WordPress user profiles?
-
Yes. Anonymous customer support works without signed identity. Sharing the logged-in user’s profile is a separate option and is off by default.
-
Where can I update my privacy policy?
-
WordPress includes suggested Zens AI wording under Settings Privacy Policy Guide. Review and adapt that text for the options you enable and your legal requirements.
-
Can a developer control where the widget loads?
-
Yes. Use the
zens_ai_customer_support_should_loadfilter to disable the widget on selected requests. Thezens_ai_customer_support_identity_profilefilter can adjust the signed profile before its final identifier is signed.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Zens AI Customer Support” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Zens AI Customer Support” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Added Spanish, Arabic, Portuguese, French, German, Japanese, Korean, Italian, Simplified Chinese, and Traditional Chinese translations alongside English.
- Added right-to-left layout support for Arabic.
- Added bundled WordPress admin translations and automatic widget language detection.
1.0.0
- Initial release.
- Added privacy-first service opt-in and Site ID configuration.
- Added chat launcher, follow-up email, and session-recording controls.
- Added optional server-signed WordPress user identity.
- Added Privacy Policy Guide content.