Shopify

The Shopify connector provides 84 actions for managing orders, customers, products, and more.

Setup

Requirements

• Shopify store (any plan)
• Admin access to create private apps

Connect via OAuth

1. Go to Settings → Integrations → Shopify
2. Click Connect
3. Enter your store URL (yourstore.myshopify.com)
4. Authorize Keva in Shopify
5. Select which store locations to access

Connect via API Key

1. In Shopify Admin, go to Settings → Apps → Develop apps
2. Create a new app for Keva
3. Configure Admin API scopes (see below)
4. Copy the API access token
5. Paste in Keva's Shopify settings

Required Scopes

read_orders, write_orders
read_customers, write_customers
read_products
read_inventory
read_fulfillments, write_fulfillments

Available Actions (84)

Orders

Customers

Products

Discounts

Store

Use Cases

Order Status Inquiry

Customer: "Where is my order 1234?"

AI:
1. Calls get_order(1234)
2. Calls get_fulfillment(order_id)
3. Returns order status with tracking

Response: "Your order #1234 shipped on March 10 via UPS. Here's your tracking number: 1Z999AA10123456784. It's currently in transit and expected to arrive by March 15."

Refund Request

Customer: "I'd like a refund for the sweater in order 1234"

AI:
1. Calls get_order(1234)
2. Identifies line item for sweater
3. Checks refund policy
4. Calls create_refund() for that item

Response: "I've processed a refund of $49.99 for the sweater. You should see it on your card within 5-7 business days."

Inventory Check

Customer: "Is the blue version of product X available?"

AI:
1. Calls search_products("X")
2. Calls get_inventory(variant_id: blue)
3. Returns availability

Response: "Yes! The blue version of Product X is in stock with 12 units available. Would you like me to help you order one?"

Configuration

Order Access

Control which orders AI can access:

• All orders
• Orders from last X days
• Specific statuses only

Refund Permissions

Set refund controls:

• Maximum refund amount
• Require reason
• Auto-refund threshold

Location Access

If you have multiple locations:

• Select which locations AI can view
• Set primary location for fulfillment

Best Practices

For Order Support

1. Enable all read actions
2. Enable update_order for modifications
3. Set refund limits appropriate for your business
4. Enable fulfillment actions for shipping inquiries

For Product Support

1. Enable product read actions
2. Keep inventory sync frequent
3. Add product info to knowledge base

Security

1. Use OAuth when possible
2. Only grant required scopes
3. Review access logs regularly
4. Rotate API keys periodically