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.
Something happens to an order
A customer places an order, or an order is paid, fulfilled or cancelled.
ORDERS_CREATEconnic checks and confirms the delivery
It verifies Shopify's signature with the app's client secret and answers right away.
X-Shopify-Hmac-Sha256Linked 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_PAIDThe 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.
type: shopify
mode: inbound
connection: acme-shopify
config:
topics: [ORDERS_CREATE, ORDERS_PAID]
agents:
- order-reviewTag 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.
type: shopify
mode: outbound
connection: acme-shopify
agents:
- name: order-review
outbound: { usage: automatic, source: [shopify-orders] }{
"tags": ["review", "high-value"],
"note": "Billing and shipping country differ."
}{
"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.
{
"topic": "orders/create",
"order": "#1042",
"order_id": 5841234567,
"url": "https://acme.myshopify.com/admin/orders/5841234567",
"raw": { "total_price": "1249.00", "currency": "EUR", ... }
}{
"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.
{
"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.", ... }
}{
"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.
{
"topic": "orders/cancelled",
"order": "#1038",
"order_id": 5841233987,
"url": "https://acme.myshopify.com/admin/orders/5841233987",
"raw": { "cancel_reason": "customer", ... }
}{
"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.
{
"ticket_id": "T-20931",
"order_id": "5841234567",
"subject": "Wrong delivery address",
"message": "Please ship order #1042 to Hauptstr. 5 instead."
}{
"order_id": "5841234567",
"tags": ["address-change"],
"note": "T-20931: ship to Hauptstr. 5."
}Shopify FAQ
More connectors
Apache Kafka
Consume topics to trigger agents and produce results back to topics under the source message key.
Inbound · Outbound
Google Pub/Sub
Run an agent on every message a Pub/Sub push subscription delivers, checked with Google's signed token, and publish results to a topic.
Inbound · Outbound
Google Sheets
Run an agent on every new row in a spreadsheet and append its results as rows. connic signs in with your own service account.
Inbound · Outbound
Microsoft Teams
Let people chat with an agent in Microsoft Teams through your own Azure Bot. It answers in the chat or channel thread and posts results to channels.
Inbound · Outbound
Telegram
Power a Telegram bot with an agent. Read user messages, reply in the chat, push alerts to any channel.
Inbound · Outbound
Twilio Messaging
Receive SMS, MMS, WhatsApp, and RCS messages with an agent. Send replies, media, and WhatsApp templates through your Twilio account.
Inbound · Outbound