Heyspark – Live Chat Plugin

Beschreibung

Heyspark adds a modern chat widget to your site and a conversational inbox inside WP-Admin. Your chat data stays on your WordPress install. No external services, no monthly subscriptions, no accounts to create. Just install, activate, and start chatting.

Why Heyspark

  • Self-hosted. Conversations live in your database, on your server. Nobody else sees them.
  • No accounts. Install and go. No signup, no API keys.
  • Modern UX. A messenger-style widget your visitors already know how to use.
  • Fast. Lightweight, deferred asset loading, no heavy framework dependencies.
  • Translation-ready. Full text domain, bundled POT, right-to-left compatible.

Free features

  • Floating chat widget on your site with Shadow DOM isolation (no theme conflicts)
  • WP-Admin inbox with a three-column conversation view
  • Real-time chat via long-polling (no external service required)
  • Online/Away toggle
  • Offline message form with email notifications when you’re away
  • Pre-chat form with name + email capture
  • Optional GDPR consent checkbox with configurable text
  • Appearance settings: greeting, brand color, launcher position (left/right)
  • Mobile show/hide toggle
  • Sound + desktop notifications for new messages
  • Visitor can view previous conversations after a chat is closed
  • Close conversations from the admin inbox
  • Translation-ready, bundled POT
  • Responsive, accessibility-minded design (keyboard navigation, ARIA live regions, focus management)

Pro features (available separately)

Upgrade to Heyspark Pro for:

  • Agent-initiated chats: proactively message online visitors
  • Multiple agents: map WP roles to agent capability, route new conversations
  • Quick responses (canned replies)
  • Page include/exclude rules
  • Business hours with timezone support
  • CSAT ratings after conversations end
  • Custom CSS for the widget

Learn more at codecabin.io/store/heyspark-pro.

Installation

  1. Upload the heyspark folder to the /wp-content/plugins/ directory, or install from the WordPress plugin directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Click Heyspark in the admin sidebar to access the inbox.
  4. Visit Heyspark > Settings to customize the widget and notifications.
  5. Browse to any page on your site. The chat launcher appears bottom-right by default.

FAQ

Does Heyspark connect to a third-party server?

No. Conversations are stored in your WordPress database. All real-time communication happens between the visitor’s browser and your own server via the WordPress REST API.

How does real-time live chat work without a third-party service?

Heyspark uses long-polling against the WordPress REST API. The visitor’s browser holds an open request that returns as soon as new activity happens on your conversation. It works on standard PHP hosting with no special server configuration.

Will it work with caching plugins?

Yes. The widget loads via deferred JavaScript and fetches its state over the REST API after the page loads, so cached HTML is fine. The admin inbox is not cached (WP-Admin is never cached).

How do I customize the widget’s colors?

Open Heyspark Settings, pick a brand color, change the greeting text or launcher position, and save. The live preview shows your changes before you commit.

Can I hide the chat on mobile devices?

Yes. Uncheck Show on mobile devices in Settings.

What happens when I close a conversation?

The conversation is marked closed. The visitor sees a „This conversation has ended“ banner with a button to start a new live chat. Past conversations appear in their widget home screen so they can view the history.

Is it GDPR-compliant?

Enable the GDPR consent checkbox in Settings and set your consent text. The pre-chat form will require the visitor to agree before sending. Visitor conversations are stored with a hashed, HttpOnly cookie. No personal data beyond what the visitor submits.

By default Heyspark does not contact any third-party service with visitor data. See the FAQ entry below if you want to enable Gravatar-based visitor avatars (off by default; requires explicit opt-in).

Does Heyspark contact any third-party servers?

By default, no. Conversations, settings, agents and visitor sessions all live in your own WordPress database.

There is one optional integration: under Settings → Visitor tracking you can turn on „Fetch visitor avatars from Gravatar“. When enabled, hashed visitor emails are sent to Gravatar (run by Automattic) to fetch avatar images shown in the admin inbox. This setting is off by default and the plugin makes no external requests for visitor data unless you opt in.

Agent avatars in the admin inbox use WordPress’s built-in get_avatar_url() for the logged-in agent’s own account — this is standard WordPress behaviour, governed by the agent’s own profile rather than the plugin.

Does the plugin work with multisite?

Each site in a multisite network runs its own Heyspark install with its own conversations and settings. No network-wide inbox in v1.

How do I translate Heyspark?

A POT file is included at /languages/heyspark.pot. Use Poedit, Loco Translate, or translate.wordpress.org to create a translation.

Rezensionen

Für dieses Plugin gibt es keine Rezensionen.

Mitwirkende und Entwickler

„Heyspark – Live Chat Plugin“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

Änderungsprotokoll

1.0.0

  • Initial release.