Skip to main content
connic

Shopify

Run connic agents on orders in your Shopify store. Agents tag orders and add notes for your team.

Modes
Inbound, Outbound
Set up in
Dashboard or connectors/*.yaml
Documentation
Shopify docs
Publisher
By connic

Act on new, paid and cancelled orders

When Shopify sends an order event for one of an inbound connector's topics, every agent linked to it starts. An outbound connector on the same Connection tags the order or adds a note.

Pick the topics
Created, paid, fulfilled, partially fulfilled and cancelled orders. Each connector subscribes only to its own topics.
One conversation per order
Every event of an order has the same conversation_id, so an agent with a session knows what happened to the order before.
No double runs
A delivery that Shopify sends again doesn't start a second run.
  1. Something happens to an order

    A customer places an order, or an order is paid, fulfilled or cancelled.

    ORDERS_CREATE
  2. connic checks and confirms the delivery

    It verifies Shopify's signature with the app's client secret and answers right away.

    X-Shopify-Hmac-Sha256
  3. Linked agents start

    The run gets the topic, the order's name and ID, a link to it in the Shopify admin and the whole order.

    ORDERS_PAID
  4. The result lands on the order

    An outbound connector on the same Connection adds tags or a note to the order that started the run.

One app, the webhooks are set up for you

You create an app in the Shopify Dev Dashboard and paste its client ID and secret once. Saving an inbound connector subscribes the app to its topics, and deleting the connector removes them.

Your app, your store
The app belongs to your Shopify organization and is installed on your store. You decide its scopes and which customer data it may read.
No tokens to rotate
connic gets a short-lived token from the client ID and secret whenever it calls Shopify.
Subscriptions come back
Shopify deletes a subscription after 8 failed deliveries in a row. Saving the connector again subscribes it again.
connectors/shopify-orders.yaml
type: shopify
mode: inbound
connection: acme-shopify
config:
  topics: [ORDERS_CREATE, ORDERS_PAID]
agents:
  - order-review

Tag orders and add notes

An outbound Shopify connector applies the agent's output to an order, whether the run started from that order or from another connector.

Routing
An order_id in the output wins. Without one, a run started from an order on the same Connection changes that order.
Three ways to send
Send after every completed run, give the model a tool to call, or call send_connector from middleware when your code decides.
Rate limits handled
When Shopify rate-limits a change, connic waits and retries the delivery.
connectors/shopify-tags.yaml
type: shopify
mode: outbound
connection: acme-shopify
agents:
  - name: order-review
    outbound: { usage: automatic, source: [shopify-orders] }
output.json
{
  "tags": ["review", "high-value"],
  "note": "Billing and shipping country differ."
}
connector-payload.json
{
  "remove_tags": ["review"],
  "tags": ["address-confirmed"],
  "order_id": "5841234567"
}

Where Shopify fits

Pick a setup to see what reaches the agent and what it writes back to the order.

A new order comes in, and the agent tags orders that someone should check before shipping.

New order
Inbound Shopify
order-review
Tag on the order
shopify-payload.json
{
  "topic": "orders/create",
  "order": "#1042",
  "order_id": 5841234567,
  "url": "https://acme.myshopify.com/admin/orders/5841234567",
  "raw": { "total_price": "1249.00", "currency": "EUR", ... }
}
output.json
{
  "tags": ["review"],
  "note": "Over 1,000 EUR. Check the address before shipping."
}

An order is paid, and the agent reads the customer's note and tags gift orders for the warehouse.

Paid order
Inbound Shopify
gift-check
Tag and note
shopify-payload.json
{
  "topic": "orders/paid",
  "order": "#1043",
  "order_id": 5841234601,
  "url": "https://acme.myshopify.com/admin/orders/5841234601",
  "raw": { "note": "Please gift wrap, no invoice in the parcel.", ... }
}
output.json
{
  "tags": ["gift-wrap"],
  "note": "Gift wrap, no invoice in the parcel."
}

An order is cancelled, and the agent notes why and tags it when someone should follow up.

Cancelled order
Inbound Shopify
cancellation-review
Note on the order
shopify-payload.json
{
  "topic": "orders/cancelled",
  "order": "#1038",
  "order_id": 5841233987,
  "url": "https://acme.myshopify.com/admin/orders/5841233987",
  "raw": { "cancel_reason": "customer", ... }
}
output.json
{
  "tags": ["follow-up"],
  "note": "Cancelled by the customer before shipping."
}

Your helpdesk sends a ticket about an order, and the agent adds a note to that order.

Helpdesk
Inbound webhook
support-desk
Note on #1042
ticket.json
{
  "ticket_id": "T-20931",
  "order_id": "5841234567",
  "subject": "Wrong delivery address",
  "message": "Please ship order #1042 to Hauptstr. 5 instead."
}
output.json
{
  "order_id": "5841234567",
  "tags": ["address-change"],
  "note": "T-20931: ship to Hauptstr. 5."
}

Shopify FAQ

The client ID and client secret of an app you create for your store in the Shopify Dev Dashboard, and the store's myshopify.com domain. connic gets a short-lived token with them whenever it calls Shopify, so there is no access token to copy or rotate.

read_orders for inbound connectors and write_orders for outbound ones. Order webhooks carry customer data, so the app also needs access to protected customer data. The app and the store must belong to the same Shopify organization.

No. Saving an inbound connector subscribes the app to its topics in the store, and deleting the connector removes the subscriptions. If Shopify deletes a subscription after 8 failed deliveries in a row, saving the connector again subscribes it again.

Yes, with type: shopify, the topics for inbound connectors, and the name of a Shopify Connection that holds the app's credentials.