WooCommerce Integration

Connecting your WooCommerce store to Deskwoot lets you view customer order history and data directly inside conversations. Your support agents get full context without switching tabs, and your AI bot can reference order information when answering customer questions. This guide walks you through setup, what to expect once connected, and how to troubleshoot common issues.

Generating API Keys in WooCommerce

1. In your WordPress admin, navigate to WooCommerce > Settings > Advanced > REST API.
2. Click Add Key.
3. Enter a description (e.g. Deskwoot Integration), select a user with admin privileges, and set permissions to Read.
4. Click Generate API Key.
5. Copy both the Consumer Key and Consumer Secret immediately — they are only shown once.

Tip: Store the keys somewhere secure before closing the page. If you lose them, you'll need to generate a new pair.

Connecting in Deskwoot

1. In Deskwoot, go to Settings > Integrations > WooCommerce.
2. Enter your WooCommerce site URL (e.g. https://yourstore.com), the Consumer Key, and the Consumer Secret.
3. Click Connect.

Deskwoot will verify the connection by fetching a test request from your store. Once verified, order and customer data will begin appearing in your workspace.

Order History in Conversations

Once connected, the conversation sidebar displays the customer's recent orders, including order number, status, total amount, and date. Click any order to see line items, shipping address, and tracking information. Orders are matched by the customer's email address.

Customer Data Sync

Deskwoot syncs customer data from WooCommerce, including name, email, billing address, and total spend. This data enriches contact profiles and helps agents provide personalised support.

AI Bot Context

When the AI bot is enabled, it automatically receives order context for the current customer. This allows it to answer questions like "Where is my order?" or "What did I order last time?" without agent intervention.

Troubleshooting

• Connection fails during verification: Double-check that your site URL includes https:// and does not have a trailing slash. Confirm the REST API is accessible and not blocked by a security plugin or firewall rule.
• No orders appear in the sidebar: Ensure the customer's email address in the conversation matches the email on their WooCommerce account. Orders are matched by email, so mismatches will result in missing data.
• Permission errors: Verify the API key was created with a user that has admin privileges and that permissions are set to Read.

Best Practices

• Use a dedicated WordPress user account for the API key so you can revoke access without affecting other integrations.
• Set permissions to Read only — Deskwoot does not need write access to your store.
• Periodically review your WooCommerce REST API keys and remove any that are no longer in use.

FAQ

Can I connect multiple WooCommerce stores?

Each store requires its own set of API keys. Repeat the steps above for each store you'd like to connect.

How quickly does order data appear in Deskwoot?

Order data is fetched in real time when a conversation is opened, so agents always see the most current information.

Is my WooCommerce data secure?

Deskwoot communicates with your store over HTTPS using the API credentials you provide. Only read-level access is requested, so no changes can be made to your store through the integration.