Description
UnravelX Sales connects your WordPress site to UnravelX. Your visitors can chat with an AI that answers their questions any time of day, and the articles you create in UnravelX are published to your site for you.
Setup takes under a minute:
- Install and activate the plugin
- You land on the setup screen (or go to Settings → UnravelX Sales)
- Click Connect to UnravelX, sign in, and choose your workspace
- You come back to WordPress, connected. Your articles and blog posts stay up to date on their own, and you can add the chat button whenever you like
Conversations: Spark (free)
- A chat button on every page, answered by AI
- Up to 50 conversations per month
- 1 channel, 1 seat
- Finds out who is a good fit, answers objections, and books meetings 24/7
- Choose the button’s colour and gradient
- Switch it on or off without losing your settings
Conversations: Grow ($49/month)
- Everything in Spark
- Up to 2,000 conversations per month
- 4 channels, up to 10 seats
- Unified inbox
- Company-level AI training
- Email campaigns
- Learning loop (monthly)
Articles: all plans
- Articles written for you: enter a topic, get a finished page
- Articles are published as normal WordPress pages and match your theme automatically (fonts, colours, header, footer)
- 10 articles published in your first week, then 2 new ones every week
- The short description shown in search results is filled in for you, and works with Yoast SEO, Rank Math, and AIOSEO
External services
This plugin connects to UnravelX (unravelx.app) to:
- Confirm your site is connected, using a secure site token
- Bring the articles you create in UnravelX into WordPress
- Keep UnravelX’s list of your published blog posts up to date
- Show the chat button on your site
Data sent includes the ID of your chat button (if you set one up), your site address, site name, and active theme name, and for each published blog post its address, title, short excerpt, and publish and last-edited dates. See our Privacy Policy and Terms of Service for full details.
Installation
- Upload the plugin folder to
/wp-content/plugins/unravelx-chatbot/, or install it from the WordPress Plugins screen. - Activate the plugin. You land on the setup screen.
- Click Connect to UnravelX, sign in, and choose the workspace for this website.
- You come back to WordPress, connected. You can add the chat button whenever you like.
FAQ
Do I need to copy any IDs?
No. Click Connect to UnravelX and choose your workspace. You don’t need to set up chat first, and you don’t need a Google account.
The chat button isn’t showing up. What do I do?
Clear your site’s cache and open the site in a private window. Make sure Show the chat button is on, and that the site shows Connected on the Conversations tab.
Does this slow down my site?
No. The chat button loads in the background, so it doesn’t hold up your pages.
What data does this plugin store?
The plugin stores the IDs that link your site to UnravelX, a secure site token, how your chat button looks, and whether it is switched on. It also stores the IDs of articles from UnravelX that were published to your site. No visitor data is collected.
What does the plugin send to UnravelX?
While the site is connected, the plugin sends each published blog post’s address, title, short excerpt, and publish and last-edited dates to UnravelX (unravelx.app), and tells UnravelX when a post is unpublished or deleted. UnravelX uses them so new articles don’t repeat your existing posts and can link to them, and, on plans that include articles, to let you improve those posts from UnravelX. Drafts, private posts, pages, and visitor data are never sent. Disconnecting stops it.
Do I need a paid plan to use the plugin?
No. The chat button and articles work on all plans, including the free Spark plan.
What happens if I disconnect?
UnravelX stops accepting your site’s connection and the plugin clears it locally. The chat button disappears from your site until you reconnect.
Changelog
1.17.1
- Plain wording everywhere: the tabs are now “Conversations” and “Articles”, and the screens no longer say “inbound”, “chatbot” or “SEO”.
- The Articles tab is simpler. One “Diagnose and fix” button replaces two links to the same place, and the settings link sits with the connection status.
- “Sync generated pages” is now “Check for new articles”, with plain results such as “No new articles. You are up to date.”
- The empty state explains where articles come from.
1.17.0
- Guided setup: after activating, you land on a focused screen with one button, Connect to UnravelX, and the steps that follow. The Plugins page reminds you until the site is connected.
- The connected screen shows a short checklist (connected, chatbot set up, chat button showing) and a cleaner chat button editor with a live preview.
- A connection that fails or expires now explains what happened and links back to settings, instead of a bare error page.
- The Connect button shows progress and ignores repeat clicks while UnravelX opens.
- Success is confirmed on the SEO tab after connecting.
1.16.0
- Connect through UnravelX: sign in, choose a workspace, and return to WordPress connected.
- Removed manual Chatbot ID and SEO ID setup. Existing connections are preserved.
- Connections use a short-lived, single-use authorization code with a server-side verifier.
1.15.0
- SEO now links itself. Connecting with your Chatbot ID links this site to its UnravelX SEO workspace automatically — there is no SEO ID to copy. Sites already connected pick it up on their own.
- Your published blog posts are sent to UnravelX and kept up to date as you publish, edit, unpublish, or delete them, so new SEO pages don’t repeat your existing posts and can link to them. On plans that include SEO pages, the posts can also be improved from UnravelX.
- Fixed UnravelX’s SEO settings showing “Plugin not connected” for sites where the plugin was installed and connected.
1.14.1
- Fixed the plugin’s “Visit plugin site” link, which pointed at a page that does not exist.
1.14.0
- The plugin now reports each published page’s real WordPress permalink back to UnravelX. WordPress decides that URL from your own permalink settings, so UnravelX previously had to guess it from a configured path — and every automatic fix aimed at a page whose real URL differed was silently refused. Fixes now target the page’s actual URL.
1.13.0
- Updated the plugin icon.
1.12.0
- Added a REST route (
/unravelx/v1/delete-page) so deleting a page in the UnravelX dashboard trashes the matching live WordPress page here too, instead of leaving it published with no way back to it from UnravelX.
1.11.0
- Added a REST route (
/unravelx/v1/publish-page) so clicking “Publish Page” in the UnravelX editor pushes that page live on this site immediately, instead of only marking it published in UnravelX and waiting for a manual “Sync generated pages” click.
1.10.1
- Added a “Diagnose and fix” link on the SEO tab (and in the empty-pages state) so sites with no SEO pages or approved fixes yet are pointed straight to UnravelX to start.
1.10.0
- Removed the manual “Apply approved fixes now” button and the hourly self-check — finding and approving SEO fixes now happens entirely in UnravelX. The plugin only applies a fix the moment it’s approved there, pushed to your site instantly. Nothing to click in WordPress.
1.9.0
- SEO fixes now apply directly through the plugin — no more downloading unravelx-seo.php. When you approve a fix in UnravelX it is applied to the matching WordPress page (SEO title, meta description, structured data, and on-page copy), applied instantly when you click Apply in UnravelX, on demand from the SEO tab, and hourly via cron.
1.8.6
- Deactivating or uninstalling the plugin now tells UnravelX to disconnect the site, instead of leaving the connection looking active on the dashboard forever.
1.8.5
- Use the hosted UnravelX widget loader instead of a plugin-side inline iframe so WordPress mobile behavior matches the native embed.
- Pass saved button colors into the hosted widget loader.
1.8.4
- WordPress plugin access is free on all plans.
- Removed plugin-side Pro plan checks for SEO page sync and WordPress publishing.
1.8.3
- Added SEO ID linking and sync so generated UnravelX SEO pages can be published as native WordPress pages.
- Synced SEO pages now update existing WordPress pages instead of creating duplicates.
1.8.2
- Restyled Configure and SEO page action buttons with UnravelX brand colors instead of WordPress admin blue.
1.8.1
- Renamed the SEO admin tab to SEO.
- Moved SEO onboarding, CTA, writing-style, and generation configuration to UnravelX.
- Added Configure links for connected inbound agents and SEO setup.
- Made connected Chatbot IDs read-only in WordPress.
1.8.0
- Questionnaire now asks 5 questions first, then offers a checkpoint: generate immediately or answer 5 more questions to improve SEO content quality.
1.7.0
- Add icon colour setting — control the chatbot button icon colour independently of the background.
- Live preview now shows the icon inside the button so both colours can be checked before saving.
- Sync version with app dashboard (1.6.0 was released without a readme update).
1.6.0
- SEO questionnaire with 16-question content preference flow.
- Questionnaire answers synced to UnravelX server and restored on new installs.
- Writing style selector — pick existing posts, pages, or entire categories as tone references.
- Folder/category suggestion when 3+ items from the same category are selected.
1.5.0
- Replace batch generate with sequential per-page generation — each page appears as it completes.
- Progress bar shows live generation status.
- Job state saved in wp_options — closes tab and comes back, generation resumes from where it left off.
- Greyed-out placeholders show which pages are still being generated.
1.4.0
- First run generates 10 cross-linked SEO pages automatically.
- Weekly Monday 08:00 cron generates 2 new pages with internal links to existing pages.
- All generated pages link to each other for topical authority.
1.3.9
- Pass existing SEO pages to generator so new pages include internal links to related articles.
1.3.8
- Detect editor type (Gutenberg blocks vs classic HTML) and generate matching page content.
1.3.7
- Fix SEO page generation — route through unravelx.app proxy, fix missing endpoint.
1.3.6
- Route keyword suggestions through unravelx.app proxy (Cloudflare BIC/Bot Fight Mode disabled).
1.3.5
- Revert to calling Railway directly for keyword suggestions — confirmed working, unravelx.app blocked by Cloudflare from TasteWP hosts.
1.3.4
- Fix Cloudflare WAF blocking keyword suggestions — switch to GET request so server-to-server calls pass through.
1.3.3
- Fix keyword suggestions blocked by Cloudflare WAF — call Railway directly, bypassing proxy.
1.3.2
- Add debug info to keyword suggestions error response for diagnostics.
1.3.1
- Fix keyword suggestions URL to use unravelx.app proxy (api.unravelx.app unreachable from some WordPress hosts).
1.3.0
- SEO tab now shows 5 AI-generated keyword suggestions tailored to your business, fetched live from UnravelX using your onboarding context. Clicking a chip populates the keyword field instantly.
1.2.9
- Fixed iframe URL — pointed to chatbot-share (non-existent) instead of chatbot-public.
- Fixed widget button size and icon.
- Fixed chatbot iframe X-Frame-Options (requires server .htaccess update).
1.2.7
- Restored Chatbot ID field in settings form so widget works without going through the Connect flow.
1.2.6
- Fixed chatbot widget not showing — site token is only required for SEO features, not the widget itself.
1.2.5
- Fixed API base URL to unravelx.app.
1.2.4
- Fixed API base URL to app.unravelx.app.
1.2.3
- Fixed API URL — restored correct /api/ path prefix.
1.2.2
- Improved connection error messages to show the actual server response for easier debugging.
1.2.1
- Fixed API URL — removed duplicate /api/ path prefix that broke the Connect flow.
1.2.0
- Renamed plugin to UnravelX Sales.
- Added Inbound & SEO tab with programmatic SEO page generation.
- Added secure site token connection flow — sites now authenticate with a site-specific token instead of the raw Chatbot ID.
- Added plan status messaging on the Inbound & SEO tab.
- Added Connect / Disconnect UI on the Inbound tab.
- Added meta description injection compatible with Yoast SEO, Rank Math, and AIOSEO.
1.1.0
- Added tab navigation (Chatbot / SEO Pages).
- Added SEO page generation tab.
1.0.0
- Initial release.