Shopify Event

Shopify Event starts a workflow when your Shopify store reports a change to an order: a new order, a payment, a shipment, a delivery, a cancellation or a refund (Runs when: When an order, shipment or refund changes). It does not need an agent attach.

Typical uses:

• Confirm cash-on-delivery orders. New order, payment method Cash on Delivery → the AI agent calls the customer to confirm the order and address before you ship. Fewer refused parcels.
• Ask for feedback after delivery. Shipment status Delivered → a call or SMS a day later.
• Tell the customer about a cancellation or refund. Order cancelled or refund created → SMS or email with the amount.
• Alert your team about big orders. New order over a set total → email or ticket.

What you need before you start

• Shopify connected to the company.
• For shipment events only: the store must grant Voice Logica access to shipments (read_fulfillments). The trigger shows a Grant access in Shopify link when this is needed; the store owner approves it once in Shopify.

First setup

1. + Add Trigger - Shopify Event

   Shopify Events — pick one or more:

   Event	When it happens
   Order created	A customer places an order
   Order paid	The order is marked paid
   Order fulfilled / partially fulfilled	You fulfil all or part of the order
   Order cancelled	The order is cancelled
   Refund created	Money is refunded
   Shipment created	A fulfillment is created, usually with a tracking number
   Shipment status changed	The carrier reports a new status (in transit, out for delivery, delivered, failed…)

   Shipment statuses come from the carrier through Shopify. If your carrier doesn’t send tracking updates to Shopify, Shipment status changed never fires.

2. Narrow it down (all optional; empty means any):

   • Payment Status — e.g. Payment pending for unpaid orders.
   • Fulfillment Status — e.g. Unfulfilled.
   • Shipment Status — shipment events only, e.g. Delivered.
   • Payment Method — matches if the method name contains the text, e.g. Cash on Delivery.
   • Order Tags — the order has at least one of these tags.
   • Minimum / Maximum Order Total.

3. From Work Flow Triggered, add the nodes. Use the values below in any text field, e.g. an SMS: Hi {{customer.first_name}}, order {{order.name}} is on its way: {{fulfillment.tracking_url}}.

4. Save. Voice Logica subscribes the store to the selected events a few seconds after saving. Removing the trigger or the workflow unsubscribes it.

5. Test run: fill in a sample order (event, payment status, phone…) and run. The filters are applied exactly as for a real event.

Values you can use

Value	Example
{{event.topic}}	orders/create
{{order.name}}	#1001
{{order.financial_status}}	pending, paid, refunded…
{{order.fulfillment_status}}	unfulfilled, partial, fulfilled
{{order.total_price}} / {{order.currency}}	42.50 / EUR
{{order.items}}	2× T-shirt M, 1× Hat
{{order.payment_gateways}}	Cash on Delivery (COD)
{{order.tags}}, {{order.note}}
{{order.status_url}}	The customer’s order status page
{{customer.name}}, {{customer.first_name}}, {{customer.phone}}, {{customer.email}}
{{shipping.address}}, {{shipping.city}}, {{shipping.phone}}
{{fulfillment.shipment_status}}	in_transit, out_for_delivery, delivered…
{{fulfillment.tracking_company}}, {{fulfillment.tracking_number}}, {{fulfillment.tracking_url}}
{{refund.amount}}	10.00

Each value is also available as {{node_<trigger id>.<name>}}, e.g. {{node_1.order.name}}.

Example: confirm cash-on-delivery orders

1. Shopify Event — Events: Order created. Payment Method: Cash on Delivery.
2. Make Outbound Call — Phone Number {{customer.phone}}, an agent prompted to confirm orders, and in Context Info: Confirm order {{order.name}} ({{order.items}}, {{order.total_price}} {{order.currency}}) and the delivery address {{shipping.address}}.
3. Optionally, on Call Ends of that agent, tag or cancel the order based on the answer.

Set it up from your AI assistant (MCP)

Ask your assistant to create the workflow; it uses add_trigger with triggerType: "onShopifyEvent" and a triggerConfig such as:

{ "topics": ["orders/create"], "paymentGateways": ["Cash on Delivery"] }

connect_integration with shopify shows the event status (events): events in use, events subscribed, access still missing and the last error. Step install-url with extraScopes: ["read_fulfillments"] returns the link the store owner opens to allow shipment events.

To check the workflow once for real (emails and SMS really go out and are charged), an admin or account manager can ask the assistant to call run_workflow with the Shopify trigger’s triggerId (from get_workflow) and a payload with the order values the nodes use, e.g. { "event.topic": "orders/fulfilled", "customer.email": "you@example.com", "order.name": "#1001" }. The result lists each node and which ones failed. test_workflow does the same as a dry run, without sending.

Troubleshooting

Why doesn't my Shopify event workflow run?

Open the Shopify trigger: a warning shows if access is missing or Shopify refused the subscription (with Retry). Check that the order actually matches every filter, e.g. a Payment pending filter skips paid orders. Run a test with the same values to see which filter stops it.

My store is connected with its own Shopify app token. Why don't Shopify events reach my workflow?

Stores connected with an Admin API access token (the older custom-app method) can only send events if the app’s API secret key was saved with the connection. Reconnect the store through the Voice Logica Shopify app.

Why is the customer name or phone empty in my Shopify order workflow?

The customer did not enter it at checkout. Add an If/Then on {{customer.phone}} before the node that places the call.

Next Steps

Shopify integration - connect the store.→

Make Outbound Call - SMS - If/Then.