> ## Documentation Index
> Fetch the complete documentation index at: https://docs.textyess.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce troubleshooting

> Solutions to common issues when connecting and using TextYess with WooCommerce.

## Connection errors

<AccordionGroup>
  <Accordion title="'Invalid credentials' or 401 Unauthorized">
    Your Consumer Key or Consumer Secret is wrong, or the key has been revoked.

    * Double-check both values were copied correctly — they are long strings and easy to truncate accidentally.
    * Make sure you are using **Read/Write** permissions, not **Read only**.
    * If in doubt, generate a new key in **WooCommerce → Settings → Advanced → REST API** and try again.
  </Accordion>

  <Accordion title="'Store not reachable' or connection timeout">
    TextYess cannot reach your store URL.

    * Verify the URL is correct and does not include a trailing slash (use `https://myshop.com`, not `https://myshop.com/`).
    * Make sure the store is publicly accessible — if you are behind a firewall or using a local development environment, the connection will fail.
    * Check that your server is not blocking requests from external IPs.
  </Accordion>

  <Accordion title="REST API returns 404">
    The WooCommerce REST API may be disabled or the permalinks may need refreshing.

    * In your WordPress admin, go to **Settings → Permalinks** and click **Save Changes** (no changes needed — just saving regenerates the rewrite rules).
    * Confirm the REST API is enabled in **WooCommerce → Settings → Advanced**.
  </Accordion>

  <Accordion title="HTTP store connection issues">
    WooCommerce may block REST API calls on stores without HTTPS depending on your server and WordPress configuration.

    * Migrate your store to HTTPS if possible. Most hosting providers offer free SSL certificates.
    * If you must use HTTP, check that the `FORCE_SSL_ADMIN` constant is not set to `true` in `wp-config.php`.
  </Accordion>
</AccordionGroup>

## Product sync issues

<AccordionGroup>
  <Accordion title="Products are not appearing after connection">
    The initial sync runs asynchronously and can take a few minutes for large catalogs.

    * Wait a few minutes and refresh the dashboard.
    * If still empty after 10 minutes, go to **Knowledge Base → Products catalog** and use the **Resync** button to trigger a new import.
    * Make sure your products are set to **Published** status in WooCommerce — draft and private products are not imported.
  </Accordion>

  <Accordion title="Product data is outdated">
    TextYess receives product updates via webhooks. If a product was updated while webhooks were not working, the data may be stale.

    * Go to **Knowledge Base → Products catalog** and use the **Resync** button to trigger a full re-import of your catalog.
  </Accordion>

  <Accordion title="Product images are missing">
    * Confirm the images are publicly accessible by opening the image URL in a browser.
    * Check that your server is not restricting hotlinking.
  </Accordion>
</AccordionGroup>

## Abandoned checkout tracking

<AccordionGroup>
  <Accordion title="Abandoned checkouts are not being tracked">
    Abandoned checkout tracking requires the **TextYess WooCommerce plugin** to be installed and activated on your store.

    The plugin adds a custom REST endpoint (`/wp-json/textyess/v1/abandoned-checkouts`) that TextYess uses to retrieve checkout data. Without it, this feature is unavailable.

    Contact support if you need the plugin file.
  </Accordion>
</AccordionGroup>

## Widget issues

For problems with the WhatsApp bubble or onsite chat widget, see the dedicated guides:

* [WhatsApp Bubble troubleshooting](/widget-installation-woocommerce)
* [Onsite Widget installation](/onsite-widget-installation-woocommerce)

## Still stuck?

Reach out to our support team at [TextYess Support](https://textyesssupport.zendesk.com/hc/en-us). Include your store URL and a description of the issue so we can help faster.