WordPress plugin Coming soon

A real WordPress plugin, not a script-injector. Full WP admin dashboard, native settings screens, OAuth-based connection, WooCommerce order sync, and an AI bridge that lets our model query your wp_posts and product catalogue to ground answers in your live data.

Installation

Once published, install from Plugins → Add New in WP admin and search for message.com. The first run opens an OAuth handshake to your message.com workspace; no API keys to copy.

1. Install and activate from the WP plugin directory.
2. Click Connect to message.com; sign in, pick a workspace.
3. Choose which channels to enable on this site (chat, tickets, calls).
4. Save. The widget appears immediately on the front-end.

Capabilities

The plugin covers the four jobs a WordPress integration needs.

• Widget injection. Site-wide by default, with per-page overrides via shortcode or a block.
• User sync. Every WP user (and WooCommerce customer) is mirrored as a visitor in your workspace, with the user role and registration date as attributes.
• WooCommerce sync. Orders, products, refunds, and customer history flow into the workspace so AI knows what each visitor has bought.
• Knowledge base. Published pages and posts in wp_posts are auto-indexed into your KB, so the AI answers from the same source your humans wrote.

Shortcode and block

For sites that want the widget only on certain pages, disable the global injection in settings and drop the shortcode where you want chat.

[message-widget]
[message-widget position="left" color="#FF4D1F"]

A Gutenberg block is also registered with the same options exposed as a sidebar panel.

Custom events

Fire do_action('message_event', ...) anywhere in your theme or other plugins to push a tracked event into the visitor's conversation context. Useful for cart abandonment, viewed-product nudges, or post-checkout surveys.

<?php
// Inside your theme or a child plugin
do_action('message_event', 'cart_abandoned', [
    'cart_total' => 89.50,
    'items'      => 3,
]);

Filter and action hooks

The plugin exposes hooks for every common customisation point. Examples:

• message_widget_should_load. Decide per-request whether to inject the snippet.
• message_visitor_attributes. Mutate the visitor payload before it is sent.
• message_woo_order_synced. Fires after an order is mirrored to the workspace.

<?php
add_filter('message_widget_should_load', function ($load) {
    // Disable widget on admin pages
    return ! is_admin();
});

AI grounding on WordPress content

The AI bridge runs as a background job. On install we crawl your published pages and posts, chunk them, and index them into your AI knowledge base. New and updated posts are re-indexed within sixty seconds via the standard save_post hook. See knowledge base for the underlying mechanics.

WordPress multisite

On WP multisite, each subsite maps to its own message.com site (sharing the workspace). The plugin handles the per-site OAuth without forcing each subsite admin through a fresh handshake.

Common pitfalls

• Aggressive page caching can hide identify calls. If you run a full-page cache plugin, the widget script still loads, but logged-in-user attributes need a small fragment that bypasses cache.
• Custom post types do not auto-index. Enable them explicitly under message.com → Knowledge Base → Sources.
• Do not also include the manual snippet. The plugin loads the bundle; doubling up will double-mount the launcher.