User Manual
Overview

Integration Instructions

Make sure you're running the latest version of WooCommerce before installing the integration. 

Installation is not recommended for WP Fusion users at this time. Please reach out to our support team for more information.

There are two important pieces to the integration: 

  • The Drip for WooCommerce plugin that is installed in your WooCommerce store. 
  • The WooCommerce integrations page in Drip where you enter in your WooCommerce store credentials. 

If you’re migrating from another provider, import your list from your previous provider before you sync the integration. WooCommerce does not have a marketing preference option upon checkout, so Drip must assume that they have not opted in to marketing email. Once people are added to Drip, their email preference only changes via interaction with Drip and Drip emails, so importing your list via CSV file from your previous provider first prevents them from being unsubscribed in Drip after the initial sync.

 

Install the Plugin

To install the Drip for WooCommerce plugin:
  1. Log in to your WordPress account
  2. Go to Plugins > Add New 
  3. Search by author for "getdrip" 
  4. Click Install Now on Drip for WooCommerce (NOT Drip for WordPress)
  5. Click Activate plugin

The plugin is now activated and installed in WooCommerce. Next, we'll walk you through how to connect the plugin to your Drip account. 

Currently, you can connect a single WooCommerce site to a single Drip account.

 

Generate API Keys in WooCommerce

  1. Log in to your store’s admin interface
  2. Go to Woocommerce > Settings > Advanced > REST API
  3. Click Add Key and follow the instructions to generate a new key. Use this key for Drip only
  4. Give the key a descriptive name so it’s easy to remember that it’s used by Drip (“e.g. Drip Integration”)
  5. Set the permissions to Read/Write
  6. Copy the newly generated consumer key and consumer secret

You will paste these keys on the WooCommerce Integrations page in your Drip account. 

Before you enter your API keys in Drip, go to Settings > Permalinks from your store’s admin in WooCommerce and make sure that the Common Settings are not set to “Plain.” This will cause an error when you sync your store.

Enter Your API Keys in Drip

  1. Log in to your Drip account
  2. Expand the Connect your store card on your account dashboard
  3. Select Woocommerce to go to the Integration page
  4. Enter your store’s URL, beginning with https:// (e.g. https://woocommerce.my_store.net/)
  5. Paste the consumer key
  6. Paste the consumer secret

The integration will start syncing. A success message will appear on the WooCommerce Integrations page in Drip when your store is connected. Once the sync is complete, your customer list, orders, and products will be synced to Drip. 

Subscribe People

After the initial sync, all new Woocommerce customers are brought over to Drip as Active and unsubscribed to email marketing. WooCommerce does not have a marketing preference option upon checkout, so Drip must assume that they have not opted in to marketing email. 

Don’t worry, if you have customers from a previous provider who are subscribed to marketing email, we’ll walk you through how to resubscribe them. 

Subscribe customers to marketing email via Bulk Operation with the Subscribe a person action. Keep in mind that if you have existing customers who have opted in or out of your marketing emails, you are required to honor their preference.

 Subscribe people who have opted into marketing email: 

  1. Export a CSV file of subscribed people from your previous provider
  2. Log in to Drip
  3. Go to People
  4. Click + Add People
  5. Under Upload a list of people click Begin 
  6. Upload or drag and drop your CSV file. Once you upload your CSV, you'll see a preview of the first few rows
  7. The box to Treat the first row in your file as headers is turned ON by default 
  8. The option to Tag these people as “Imported YY-DD-MM at HH-MM-SS” is turned ON by default
  9. Click Next
  10. Select Subscribe a person
  11. Click Next > Perform Operation
  12. Click Done to exit the page and view the progress of the operation, or click Cancel this Operation to cancel the operation

People will now be subscribed to marketing email in Drip. Locate the subscribed people you just imported in your account under People > Active > Subscribed to marketing email. From there, segment for the “Imported YY-DD-MM at HH-MM-SS” tag that was applied on import. 

WooCommerce Error States

If you’re seeing any of the following errors when syncing the integration, here are a few common solutions to resolve them.

401 Cases

"We couldn't connect to your API."

Troubleshooting Steps

  • Confirm that your API key is Read/Write
  • Double-check that the URL on the Drip Integrations page matches the Site Address value in Settings > General. For example, check that the URL contains the "www." part if needed (this also shows up as a 404 error).
  • Some implementations of CGI don’t handle Basic Authentication properly. Ensure that the $_SERVER['HTTP_AUTHORIZATION'] variable is set to the value of the "Authorization" header. To see if this might affect you, check the "PHP_SAPI" setting to see if it contains something like "fcgi" or "fast-cgi". If it does and you have an '.htaccess' file, check out this guide to update that - if it does and you don't have an '.htaccess' file, consult your server's documentation for updating that variable.

404 Cases

"We were unable to connect to your WooCommerce store. It responded with an HTTP 404 status, which is often caused by having the "Plain" Permalink settings in WordPress."

Troubleshooting Steps

  • Double-check that the URL on the Drip Integrations page matches the Site Address value in Settings > General. This occurs because a site can have multiple subdomains, "example.com", "www.example.com", "learn.example.com" and the WooCommerce API will only be available for one of them.
  • Confirm that Permalink settings are not set to “Plain.” 
  • Confirm that you’re using a WooCommerce version above 3.5.0. We recommend using the latest version of WooCommerce before installing the integration. 
  • From your WordPress Admin and go to Plugins > Drip for WooCommerce > Activate and confirm that the plugin is Activated.