About this plugin
Chatessa is a live chat that answers with AI when your team is offline and learns from every conversation. This plugin embeds the Chatessa widget on your WordPress site and – for a true enterprise integration – can:
- One-click Connect – paste your Chatessa API URL + API key and the plugin auto-provisions a widget key locked to your domain. No manual snippet editing.
- Secure identity (tamper-proof) – logged-in WordPress users are identified to your agents using a server-signed HMAC (Intercom-style user_hash ), computed on your server so it cannot be forged in the browser.
- WooCommerce context – on login, the plugin sends the customer’s order count and lifetime value to Chatessa so your agents see who they’re talking to.
- Consent gating (GDPR) – optionally load the widget only after your cookie-consent banner is accepted.
- Inbound webhooks – receive Chatessa events (new leads, escalations) in WordPress and react via the chatessa_webhook action hook (HMAC-verified).
- Performance-first – the widget script loads asynchronously and never blocks rendering.
The widget key is public by design (it lives in client HTML). The API key and identity secret are server-to-server only and are never printed into the page.
External services
This plugin is a client for Chatessa, a third-party hosted live-chat and AI
chatbot service. The plugin does not work on its own: a Chatessa account is
required, and the chat itself runs on Chatessa’s servers. By installing this
plugin you are sending the data listed below to that service.
com)
com/terms-of-service
com/privacy-policy
com and
com. If you self-host Chatessa you can point the plugin at
your own installation under Settings → Chatessa → Advanced, in which case the
data below goes to your own server instead.
The plugin contacts the service in these situations, and only these:
-
Loading the chat widget (every page view, front end)
js is loaded from the Chatessa app host so the chat
can render. As with any hosted chat widget, the visitor’s browser therefore
contacts Chatessa directly, which makes the visitor’s IP address, user agent
and the page URL visible to the service. Chat messages the visitor types are
sent to Chatessa to be answered and to be shown to your agents.
Not loaded at all when the plugin is disabled, when no widget key is set, or –
if you enable consent gating – until your cookie-consent cookie is present.
-
Connecting your site (once, when an administrator clicks “Connect”)
Sends your site’s host name and site title so Chatessa can provision a widget
key restricted to your domain and return it to this plugin.
-
Completing the “Connect with Chatessa” authorization (once, on approval)
Exchanges the single-use authorization code returned by Chatessa for your
workspace’s widget key, API key and identity secret.
-
Identifying a logged-in user to your agents (optional, on each login)
Only when “Secure identity” is enabled. The user’s WordPress user ID, email
address and display name are signed on your server and passed to the widget so
your agents can see a verified identity instead of an anonymous visitor.
-
Sending WooCommerce customer context (optional, on each login)
Only when “WooCommerce context” is enabled and WooCommerce is active. Sends the
customer’s email address, display name, order count, lifetime value and last
order (number, date, total, status) so agents can see purchase history while
chatting.
Items 4 and 5 are switched off by unchecking them on the plugin’s settings screen;
items 1-3 are inherent to using the service.