How to Connect Your WooCommerce Store to Botline (Step-by-Step)

Before opening Botline, make sure you have:

• A WordPress site with WooCommerce (version 4.0+) — either self-hosted or WordPress.com Business plan or higher.
• Access to your WordPress admin dashboard — you will need to create REST API keys in WooCommerce settings.
• A Botline account on a paid plan (Starter or above) — WooCommerce integration is not available on the Free plan.
• About 5 minutes — there is no code to write, no servers to set up.

If you are on Free today and want to try this, upgrading to Starter is $29/month and takes 30 seconds.

1. Log in to your Botline dashboard.
2. Go to Settings → Integrations (or navigate directly to /dashboard/integrations).
3. Scroll down to the WooCommerce card — it shows a purple gradient with a "W" logo.
4. Click Connect WooCommerce to open the 4-step wizard.

If you see a locked icon on the WooCommerce card, your plan doesn't include integrations yet. Click the card to upgrade to Starter (or higher).

In the first wizard screen, paste your WordPress store URL.

• Self-hosted WordPress? Paste exactly: `https://myshop.com` (or whatever your domain is). No /wp-json, no trailing slash — just the domain.
• WordPress.com Business plan? Paste your custom domain if you have one (e.g., `https://mybusiness.com`). If you only have a WordPress.com subdomain, check with Bluehost / GoDaddy / WP Engine first — we support custom domains; WordPress.com subdomains may have API restrictions.

The URL must start with https:// (not http://). WooCommerce API requires HTTPS for security.

Click Next →.

Now you need to create a consumer key and consumer secret in your WordPress admin. Botline will show you a direct link to the right page — you can click it to jump straight there, or follow these steps:

1. Log in to your WordPress admin dashboard at `https://yoursite.com/wp-admin`.
2. Go to WooCommerce → Settings (in the left sidebar).
3. Click the Advanced tab.
4. Click REST API in the dropdown menu.
5. Click the blue Create an API key (or Add key) button.
6. Fill in the form:
   • Description: `Botline` (or whatever you want to remember it by)
   • User: Select yourself (or whoever manages the store)
   • Permissions: Select Read (that's all Botline needs)
7. Click Generate API key at the bottom.
8. WooCommerce shows you the Consumer key and Consumer secret — copy both of these strings. They're long and look like random characters.

Important: Do NOT share these strings publicly or paste them anywhere except Botline. They're like passwords for your WooCommerce API.

Back in the Botline wizard, you'll see two text fields:

• Consumer key: paste the long string that starts with `ck_`
• Consumer secret: paste the long string that starts with `cs_`

Below these fields, there's a Webhook secret — Botline generates this for you (a random 32-character string). You'll need to copy this and paste it into your WC settings in the next step. There's a Copy button next to it.

Click Validate & Connect. Botline will:

• Hit your WooCommerce store to confirm the keys are valid
• Fetch your store name and WC version
• Start syncing your product catalog (usually takes 30-60 seconds)

If you see an error like "401 Unauthorized," the consumer key or secret is wrong. Go back to your WC admin, double-check you copied the entire string (it's long!), and try again.

Webhooks tell WooCommerce to send Botline a notification every time an order is created or updated. Without this, your order lookups are only as fresh as the last catalog sync. With it, order changes arrive within seconds.

Botline shows you the exact webhook URL and secret you need — keep that window open, or write them down.

1. Go back to your WordPress admin.
2. Go to WooCommerce → Settings → Advanced → Webhooks.
3. Click Add webhook.
4. Fill in:
   • Webhook name: `Botline - Order Created` (or anything you want)
   • Status: Active
   • Topic: Select `Order - Created` from the dropdown
   • Delivery URL: Paste the URL Botline showed you (it will look like `https://botline.cc/api/woocommerce/webhook?tenant=...`)
   • Secret: Paste the webhook secret Botline generated (the 32-character string)
5. Click Save webhook.
6. WooCommerce will test the webhook — you should see a green checkmark.

Now create a second webhook for order updates:

1. Click Add webhook again.
2. Fill in the same fields, but for Topic select `Order - Updated`.
3. Use the SAME delivery URL and secret as before.
4. Click Save webhook and confirm the test.

You should now see two active webhooks in the list. You're done!

Once you've configured the webhooks:

• Your catalog is synced. Botline fetches all your products, variants, prices, and stock levels. This usually takes 30-60 seconds. The AI can now answer "do you have this in stock?" questions instantly.
• Your orders are visible. Any future orders (and historical orders within the last 30 days) are synced. When a customer asks "where's my order?", the AI looks them up by email or phone and replies with status + tracking.
• Nightly sync keeps data fresh. Botline syncs your catalog every night automatically, and order updates arrive in real-time via the webhooks you just configured.
• The AI uses it automatically. No separate training needed — your existing AI agent on WhatsApp and Instagram now has catalog + order capabilities built in. The next customer who asks a product or order question gets an instant, accurate answer.

Once you've set everything up, here's a quick test:

1. Send a test WhatsApp message to your Botline number: "Where's my order?" (or similar).
2. If Botline knows your phone number from a past order, the AI will fetch it and reply with the order status.
3. If you don't have an old order, create a test order in your WC admin (or have a friend place a real one), then wait 10-30 seconds for the webhook to fire.
4. Send another message — this time the AI should find the order instantly.

If the AI doesn't find the order, check:

• Webhook status: In your WC admin, click the webhook to view delivery logs. You should see recent POST requests with "success" or similar.
• Customer email/phone in the order: Botline looks up by email first, then phone. Make sure the order has at least one of these fields populated.
• Botline dashboard logs: Go to Help → Contact support and mention the test — the team can check logs on their end.

Q: I see "Invalid consumer key/secret" error.

A: Your WC REST API credentials are wrong. Go back to WooCommerce → Settings → Advanced → REST API and confirm you copied the entire consumer key and secret. They're long strings — easy to accidentally cut them short.

Q: Webhooks test passed, but orders aren't appearing in Botline.

A: Check the webhook delivery log in your WC admin (click the webhook to view details). If it shows "failed," the delivery URL might be wrong. If it shows "success" but orders still aren't syncing, contact Botline support — there may be a backend issue.

Q: Can I use the same API key for multiple tools/apps?

A: Yes. The consumer key and secret work for any app that needs read access to your WC store. You can reuse them for Botline, Zapier, or other integrations — they all get the same data.

Q: What permissions does Botline need?

A: Read-only. Botline cannot modify, delete, or create orders. It only reads your catalog and order history. You stay in control of your data and your store.

Q: Can I disconnect later?

A: Anytime. Go to Integrations → WooCommerce → Disconnect. Botline stops syncing your catalog and orders immediately. Your past conversations stay in your inbox, but the AI loses access to your store data.

Your WooCommerce store is now connected to Botline. Every product question, every "where's my order?" message, and every customer looking for a recommendation will be handled by your AI instantly — 24/7, in the channels they already use (WhatsApp, Instagram, or both).

No human intervention required. No more manual order lookups. Just working AI.

If you have questions, the Botline team is on WhatsApp — message the support number from your dashboard's Help tab.