Build with

Read an existing order for an authenticated customer. The Shopify worked example checks order NS-1042; it does not claim that the order has shipped or been delivered.

For other stores, follow WooCommerce order reads, Wix orders and fulfillments or Squarespace order reads. Each needs the application-authorized API ID; display numbers and delivery evidence differ.

Before you begin

  • A dedicated test project and a verified Shopify connection for connector examples. Use your actual store values instead of the fictional Northstar examples.
  • An application-owned customer/order access check for personal data or changes. Search values and tool Triggers are not authorization.
  • A permitted test order that you can inspect in Shopify, with its email, exact order number and authoritative order ID saved by your application.

Studio

Open the test project in Agent studio.

Code

Use a Voiceflow bearer credential with access to your test project and Environment. Keep it on your backend or development machine. Set:

Use a current Voiceflow CLI if you choose CLI. API and CLI examples use the Environment’s saved Draft. Standalone execution does not attach a tool, compile an agent or publish a release.

Read the permitted order

1

Establish the customer's access

Have your application authenticate the customer and resolve the permitted order from its customer-to-order mapping. Supply the verified lookup values to the conversation or backend.

A customer-supplied email, order number or postal code is not an access check. Use one dedicated test order for the builder test.

2

Retrieve the order

Studio

Add Shopify → Get order to the intended path. Configure the verified email and exact order number. Test the question, then inspect the actual tool result before using it in an answer.

Read one permitted order using its verified lookup values. Photo:

Code

Require success: true, error: null and truncated: false before using output.data. An HTTP 200 alone does not establish a successful action. Confirm output.data.id equals the application-authorized order ID. The handler returns the first match, so the existence of a record is insufficient.

3

Return the supported information

Compare the returned ID with the application-authorized order ID before sharing details.

Carrier tracking events, payment status and verified delivery time need another source; this action does not return them.

Verify the customer result

  • Permitted order: compare the answer with the same test order in Shopify.
  • Missing order: do not claim a delivery or cancellation state; offer your support fallback.
  • Failed customer association or wrong returned ID: stop disclosure and use the configured support path.

The lookup checks at most ten results and returns the first match. Email plus postal code does not uniquely identify an order.

For a confirmed change, continue with Change or cancel an order. For an unresolved delivery question, route the request to support with permitted order context.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.