Shopify + Qdrant Sales Bot POC

What this POC does:

• Sales bot can create products in Shopify (Admin API).
• Shopify webhooks push create/update/delete events to a listener.
• The listener syncs Qdrant (upsert/delete). On updates it stores a small reflection (change_diff, change_summary).

Setup

1. Create an env file:

cp .env.example .env

Fill in:

• OPENAI_API_KEY
• SHOPIFY_STORE_DOMAIN
• SHOPIFY_ADMIN_ACCESS_TOKEN
• SHOPIFY_STOREFRONT_TOKEN
• SHOPIFY_WEBHOOK_SECRET

2. Install deps:

pip install -r requirements.txt

Run the services

A) Start Qdrant (local)

docker run -p 6333:6333 qdrant/qdrant

B) Start webhook listener

python shopify_webhook.py

Default: http://localhost:8000

C) Start sales bot API

uvicorn sales_api:app --host 0.0.0.0 --port 8001

Default: http://localhost:8001

Shopify webhooks

Create Shopify webhooks to point to:

• products/create -> http://<your-public-host>/webhooks/shopify/products-create
• products/update -> http://<your-public-host>/webhooks/shopify/products-update
• products/delete -> http://<your-public-host>/webhooks/shopify/products-deletion

Optional: bulk index your current catalog

python product_indexer.py