View Categories

Corelex FAQ

4 min read

The product cards appear blank — no product name, image or price is shown #

This usually means the Corelex backend could not reach your WooCommerce REST API in time. Corelex fetches live stock and pricing data for each recommended product. If your server is slow to respond or blocks external requests, the lookup times out and the card renders empty.

Things to check:

  • Make sure your WooCommerce REST API is publicly accessible. Test it by opening https://yoursite.com/wp-json/wc/v3/products in a browser — you should see JSON, not a login page or error.
  • If you use a security plugin (Wordfence, All-In-One Security, iThemes Security), check whether it is blocking external access to the WooCommerce REST API (/wp-json/wc/v3/). Corelex uses standard WooCommerce API keys (consumer key + secret) to authenticate — make sure your security plugin allows authenticated REST API requests from external services. Corelex runs on Google Cloud and does not have a fixed IP address that can be whitelisted.
  • If you use Cloudflare or another CDN/WAF, make sure REST API requests (/wp-json/) are not being challenged or blocked.

Product cards appear correctly on some queries but not others #

Broad queries (e.g. “show me lights”) return many matching products from the catalogue. The more products retrieved, the more live WooCommerce lookups Corelex needs to make in parallel. On a slower server this can cause some lookups to time out while others succeed. Queries that match fewer, more specific products tend to work reliably.

This is a known limitation. Corelex already caps the number of parallel lookups at 10, but if your server responds slowly to even a handful of simultaneous API requests, you may still see occasional blank cards.

The chat response is very slow — it takes 15–30 seconds before a reply appears #

The most common cause is slow WooCommerce API responses. Corelex performs live product lookups in parallel with generating the AI reply, so a slow API directly extends the total response time. Check server response times using your hosting panel or a tool like GTmetrix.

If your hosting plan has limited CPU or is on shared hosting, consider:

  • Enabling a server-side caching plugin (WP Rocket, W3 Total Cache) to speed up REST API responses
  • Upgrading to a managed WordPress host or VPS with dedicated resources
  • Contacting your host about API response times under concurrent load

I get a “Cookie check failed” or authentication error in the chat window #

This happens when the security token (nonce) embedded in the page becomes invalid. The two most common triggers are: the page has been cached for more than 24 hours, or WordPress / the Corelex plugin was recently updated (which immediately invalidates all active tokens).

In the current version of Corelex this is handled automatically — the plugin detects the error, silently fetches a fresh token, and retries. Visitors should not see the message at all. If it appears repeatedly, ensure your caching plugin is set to refresh pages within 24 hours, and verify that /wp-json/corelex/v1/nonce is publicly accessible (not blocked by a security plugin).

The chat widget works fine on desktop but product cards are missing on mobile #

Mobile browsers (especially iOS Safari) apply stricter popup and network policies. If you see the assistant message but no cards, the most likely cause is the same WooCommerce API timeout issue — mobile networks can add extra latency on top of a slow server. The fix is the same as above.

Product prices or stock statuses shown in the chat are outdated #

By default, Corelex caches live product data for 60 seconds to reduce load on your WooCommerce server. If a product’s stock or price changed within the last minute, the chat may still show the old value. This resolves automatically on the next request. If you need real-time accuracy, contact support to discuss upgrading to a real-time data plan.

The WhatsApp handoff button does not appear even when the assistant says it cannot help #

Two things to verify:

  • A WhatsApp number must be entered in Corelex → Settings → WhatsApp number. Without it, the button is never shown.
  • On mobile, make sure you tap the button directly — mobile browsers block automatic redirects to external apps unless triggered by a direct user tap.

Featured product is not displayed in the exit modal #

When you update the featured products in your product database after you configured the Sales Agent, then you may have to re-sync the products with Corelex. To do so, navigate to the Integrations tab, there click the ‘Sync Products Now’ button at the bottom of the page.

Powered by BetterDocs

Leave a Reply

Your email address will not be published. Required fields are marked *