Overview
The WooCommerce integration allows UserDeck to fetch and display customer order information from your WooCommerce store. When viewing a conversation with a customer, you'll see their recent orders, order totals, and purchase history in the sidebar, making it easier to provide personalized support.
Prerequisites
A WooCommerce store with REST API enabled
Administrator or Shop Manager access to your WooCommerce store
Access to UserDeck settings with integration permissions
Steps to connect WooCommerce to UserDeck
Step 1: Generate WooCommerce API Keys
Log in to your WooCommerce store's WordPress admin panel.
Navigate to WooCommerce Settings: Go to WooCommerce → Settings → Advanced → REST API, or visit https://yourstore.com/wp-admin/admin.php?page=wc-settings&tab=advanced§ion=keys
Create a new API key: Click Add key, then fill in the details.
Description: Enter a descriptive name (e.g., UserDeck Integration)
User: Select an Administrator or Shop Manager account
Permissions: Select Read/Write (required for fetching order data)
Click Generate API key
Copy your credentials:
Consumer Key (starts with ck_)
Consumer Secret (starts with cs_)
Important: Copy both values immediately. The Consumer Secret is only shown once. Store them securely.
Step 2: Connect WooCommerce to UserDeck
Navigate to UserDeck Settings: Log in to your UserDeck account, go to Settings → Integrations.
Select WooCommerce: Find the WooCommerce integration card and click Connect.
Enter your store details:
Store URL: Enter your WooCommerce store’s base URL (e.g., https://myshop.com). Do not include /wp-admin or /wp-json.
Consumer Key: Paste the Consumer Key you copied.
Consumer Secret: Paste the Consumer Secret you copied.
Test the connection: Click Connect. UserDeck will verify your API credentials.
Step 3: Verify the Integration
Check integration status: Go to Settings → Integrations. You should see WooCommerce listed as “Connected” with your store URL displayed.
Test in a conversation: Open a conversation with a customer who has WooCommerce orders. You should see a WooCommerce section in the sidebar showing customer info, recent orders, order details, and product information.
Troubleshooting
Connection Failed Error
Problem: “Failed to connect to WooCommerce store.”
Solutions:
Verify API credentials — ensure keys are copied correctly and have no spaces.
Check API permissions — must have Read/Write and the user must be Admin or Shop Manager.
Verify REST API is enabled in WooCommerce → Settings → Advanced → REST API.
Check store URL format — use https://example.com (no trailing slash).
Test API access directly via https://yourstore.com/wp-json/wc/v3/system_status
No Orders Showing
Problem: Integration is connected, but no orders appear.
Solutions:
Verify customer email matches between UserDeck and WooCommerce billing email.
Check order age — only 5 recent orders are displayed.
Verify the customer actually has orders.
Check API permissions — must have at least Read access.
Timeout Errors
Problem: “Request timeout” or “Maximum execution time exceeded.”
Solutions:
The customer may have many orders — wait and refresh.
Optimize WooCommerce database and check server performance.
Security Best Practices
Store API keys securely. Never share or commit them to version control. Rotate them every 90 days.
Use appropriate permissions — Read/Write only if needed; Read is enough for viewing.
Monitor API usage — check WooCommerce → Settings → Advanced → REST API, and revoke unused keys.
Disconnecting WooCommerce
To disconnect:
Go to Settings → Integrations.
Find WooCommerce.
Click Disconnect or Remove, and confirm.
Note: Disconnecting removes WooCommerce data from UserDeck conversations. You can reconnect anytime.
Support
If issues continue:
Check the UserDeck Help Center for updated documentation.
Make sure WooCommerce and WordPress are up to date.
Contact UserDeck support with your store URL (no credentials), error messages, and troubleshooting steps taken.