Skip to content
  • There are no suggestions because the search field is empty.

Troubleshooting Connection and CAPTCHA Issues Between Webgility Desktop and WooCommerce

This article assists Webgility Desktop users in troubleshooting connection problems and CAPTCHA-related issues when integrating with WooCommerce. Such issues can interfere with seamless data syncing, order processing, and overall platform performance. The guide explains common causes behind these problems and provides detailed steps to resolve connection disruptions and CAPTCHA challenges, ensuring smooth operation between Webgility Desktop and WooCommerce.

Symptoms You Might Experience

  • Your WooCommerce store won’t connect to Webgility Desktop.

  • You see error messages related to failed downloads or plugin access.

  • WooCommerce plugin settings pages are unresponsive or inaccessible.

Root Causes

These issues often result from:

  • CAPTCHA (like reCAPTCHA) blocking Webgility Desktop’s API or admin requests.

  • Firewalls or antivirus software blocking Webgility Desktop’s IP or domain.

  • Recent plugin or security updates tightening site restrictions.

Step-by-Step Troubleshooting Guide

1. Confirm the Error

  • Review the exact error message in Webgility Desktop or your WooCommerce logs.

  • Note when the issue occurs (e.g., while syncing data, opening plugin settings).

2. Review CAPTCHA Configuration

  • If you're using CAPTCHA plugins on login, checkout, or admin forms:

    • Temporarily disable CAPTCHA.

    • Retry the integration with Webgility Desktop.

  • If disabling CAPTCHA resolves the issue, consider configuring exceptions for Webgility Desktop traffic or limiting CAPTCHA to public-facing forms only.

3. Check Firewall and Security Settings

  • Get a list of Webgility Desktop’s required IP addresses and domains (refer to Webgility’s IP Whitelist Guide or contact support).

  • Work with your hosting provider or network admin to:

    • Whitelist Webgility Desktop's IP addresses and domains in your site’s firewall, security plugins, and server firewall settings.

    • Remove or adjust rate limiting, geo-blocking, or plugin security features that could block incoming requests.

5. Retest the Connection

  • After updating security settings:

    • Re-attempt the WooCommerce sales channel connection from Webgility Desktop.

    • Run a test sync or access plugin settings to confirm if the issue is resolved.

Resolution Example

In many cases, connection issues are resolved by:

  • Disabling CAPTCHA temporarily or refining its configuration.

  • Whitelisting Webgility Desktop domains/IPs in your hosting or firewall settings.

Be sure to document what worked and keep an eye out for future plugin or security updates that could reintroduce the problem.