Overview

The Picqer integration connects your warehouse management system to Bugalou. Once connected, you can trigger automations on order and return events, and the AI agent can look up order information and stock levels on demand. Navigate to Channels → Picqer and click "Connect".

What You'll Need

• An active Picqer account with admin access
• Your Picqer subdomain (the part before .picqer.com — e.g. mycompany)
• A Picqer API key (generated in Picqer Settings → API keys)

Step 1: Create an API Key in Picqer

1. In Picqer, go to Settings → API keys
2. Click "Add API key"
3. Give it a name (e.g. Bugalou) and save
4. Copy the generated API key — you'll only see it once

Step 2: Connect in Bugalou

1. Navigate to Channels → Picqer
2. Enter your Subdomain (e.g. mycompany)
3. Paste your API Key
4. Click "Connect" — Bugalou will verify the connection

Step 3: Configure Webhooks in Picqer

To receive real-time order and return events, add webhooks in Picqer (Settings → Webhooks). The webhook URL is shown on the Picqer integration page in Bugalou. Add a separate webhook for each event you want to use:

Event	When It Fires
orders.completed	Order is fully processed and completed
orders.status_changed	Order status changes (e.g. to "shipped")
orders.closed	Order is closed
returns.status_changed	Return status changes
returns.products_received	Returned products are received in the warehouse

Step 4: Sync Your Products

After connecting, click "Sync Products" to import your product catalogue. This allows the AI agent to answer stock questions and look up product details. Syncing can take a minute for large catalogues — the page shows the sync status and a product count when complete.

What You Can Do

• Automation triggers — trigger WhatsApp, email, or SMS automations on Picqer order and return events. See the Picqer trigger reference for all sub-events and variables
• AI agent order lookup — when a customer mentions an order number, the AI agent automatically looks it up in Picqer and includes the status, products, and tracking information in its response
• AI agent stock queries — the AI agent can answer product availability questions using your synced Picqer catalogue
• Available variables — {{customer_name}}, {{order_number}}, {{order_status}}, {{tracking_url}}, {{tracking_code}}, {{return_number}}

Use Cases

• Order completed → review request — when an order is completed, wait 2 days and automatically send a review request via WhatsApp
• Order shipped → track & trace — when an order status changes to "shipped", send the tracking link to the customer
• Return received → confirmation — when returned products arrive, automatically send a return confirmation
• Stock questions via AI — customers can ask "Is the blue jacket in stock?" and the AI agent answers using the synced product catalogue

Disconnecting

To disconnect Picqer, click "Disconnect" at the bottom of the Picqer integration page. This removes the credentials and stops all incoming webhooks. Previously synced products and existing automations are not deleted.