This guide walks you through setting up a Where Is My Order (WISMO) configuration using an inbound AI Voice Agent and the Shopify Get Order Details AI Action.
To bring this to life, we will use the following use case: a customer calls in, the AI Voice Agent retrieves and provides their order status, and if the order cannot be located, the call is transferred to a representative.
This setup automates routine order-status calls, giving customers immediate answers on product name, order status, payment status, and shipping details, while reducing wait times and freeing your reps to focus on higher-value work.
Your agent can also do more with Shopify, such as checking returns, holding a shipment, or sending a payment link. Please see Shopify AI Actions: what your AI Voice Agent can do for more details.
You can create the agent from a template or build it from scratch. See Choose how to set up your WISMO agent below.
How it works
Regardless of the use case, this foundation can be adapted to suit virtually any scenario. For our WISMO use case, a typical call flow looks like this:
- The customer calls the company phone number for an order status update.
- The AI Voice Agent greets the customer and asks for their order number, along with either the phone number or email address associated with the order, for verification.
- The AI Voice Agent queries Shopify using the Get Order Details AI Action to find a matching order.
- If the order is found, the AI Voice Agent shares all available information within the parameters of the action.
- If the order isn't found, the AI Voice Agent asks the caller for the email address associated with the order and tries again.
- If the order still can't be located, the AI Voice Agent informs the caller and transfers them to a representative.
Before you start
This guide assumes:
- You have an active Shopify store with existing orders and customer data.
- You have an active Shopify integration on the Aircall Dashboard.
- In Shopify, the customer's phone number and email address are stored in the
phoneandemailfields respectively, and both fields are present on the order object.
Note: The field structure described above applies to this use case. Your object structure may differ depending on your Shopify setup.
Choose how to set up your WISMO agent
There are two ways to create your WISMO agent. You can use the Order support template for a guided setup, or build the agent from scratch.
- Option 1: Use the Order support template (recommended). A guided setup that creates a ready-to-use WISMO agent with the Shopify order lookup already configured.
- Option 2: Build your WISMO agent from scratch. Configure every setting yourself by following Steps 1 to 5 below.
Option 1: Use the Order support template
The template guides you through setup and pre-configures the Shopify order lookup, so your agent is ready to take calls in a few steps.
Note: The template uses the Shopify Get Order Details AI Action, so complete Step 1 below first. You need an active Shopify integration on the Aircall Dashboard with AI Actions enabled.
Steps:
- Navigate to AI Agents > AI Voice Agents from the left-hand navigation menu.
- On the Order support card, click Use template.
- Role and tasks: review the agent’s role and tasks, such as order status and tracking, product and store questions, and returns and refund policy info. The agent explains your return policy but doesn’t process returns or refunds. If none of the tasks fit a caller’s request, the agent takes a message for your team. Click Confirm role & tasks.
- Voice and speech: review the agent’s name, greeting, and farewell. Click Hear how this sounds to preview.
- Knowledge sources: add sources that cover shipping and delivery times, returns and exchanges, product info, store hours, and contact details.
- Shopify intake questions: review the wording of the questions the agent asks to find the caller’s order. The caller’s phone number is detected automatically.
- Conversation overview: review how the agent handles each scenario and edit the scripts if needed. Click Test your agent to try it out.
- Configurations: connect a number to your agent to start taking calls.
Note: The call flow in How it works is the typical flow for this use case. With the template, the caller's phone number is detected automatically, and when the agent can't answer, it takes a message for your team. To transfer callers to a representative when an order can't be found, set up Transfer rules in Step 3 and a fallback transfer in Step 5.
Tip: Once your agent is created, you can fine-tune any of the settings described in Step 3 below, for example Transfer rules or the AI Actions conversational guidelines. Then test your agent as described in Step 4. For more on templates, see AI Voice Agent templates.
Option 2: Build your WISMO agent from scratch
Follow Steps 1 to 5 below to configure every setting yourself.
Step 1: Activate AI Actions
Enable AI Actions on the Shopify integration you want to connect to your AI Voice Agent.
Steps:
- From the left-hand navigation menu, go to Aircall Dashboard > Integrations > Apps.
- Find and select your existing Shopify integration.
- Click the AI Actions tab in the top navigation bar.
- Enable Get Order Details under AI Voice Agent.
Step 2: Create your AI Voice Agent
Next, create your AI Voice Agent.
Steps:
- Navigate to AI Agents > AI Voice Agents from the left-hand navigation menu.
- Click Create an AI Voice Agent and select Inbound.
Note: If your dashboard is set to English, you can use the automated Agent Builder to describe your agent's desired behaviour in plain language, with the option to incorporate call transcripts to inform the configuration. Some elements will still need to be configured manually. For more information, see Using the Agent Builder.
Step 3: Configure your AI Voice Agent
With the agent created, configure the following settings to shape its core behaviour:
- Agent Profile: sets the agent's core identity.
- Company Information: defines how the agent refers to your business.
- Knowledge Base: the information the agent uses to answer caller questions.
- Call Script > Greeting & Farewell Messages: the messages callers hear at the start and end of a call.
- Call Script > Conversational Guidelines: shapes how the agent conducts the conversation, including tone, phrase responses, and boundaries. Example: “If you cannot answer a general FAQ question, inform the customer and direct them to check our online help centre”
Tip: At a minimum, add knowledge base sources relevant to orders, shipping, and returns so your AI Voice Agent can answer FAQs beyond the caller's order status.
Tip: Example conversational guideline: "If you cannot answer a general FAQ question, inform the customer and direct them to check our online Help Centre."
For the WISMO use case specifically, you'll also need to configure Transfer Rules and AI Actions.
Transfer rules
Transfer rules define how and when a call is escalated to a live rep if the AI Voice Agent can't help.
Note: If you don't want your agent to transfer calls to a rep or team, you can skip this step. Transfer is disabled by default on new agents.
Steps:
- Navigate to Call Transfer Rules in the agent's left-hand navigation menu.
- Toggle on Allow AI Voice Agent to escalate the call.
- Select Help First, transfer only when it's clear the AI Voice Agent is unable to help. This aligns with the WISMO use case, escalating to a rep only when the order can't be found using the phone number or email address provided by the caller.
AI Actions
Add the Shopify AI Action to your agent.
Steps:
- Navigate to AI Actions in the agent's left-hand navigation menu.
- Click Add action.
- In the side panel, open the dropdown and select Shopify > Get Order Details.
Once added, the Edit action panel shows how the action is configured, in three parts:
- Preset instructions: the action's default behavior out of the box, including identity verification, handling partial matches, and how to proceed when a caller's details don't exactly match what's on file in Shopify.
- Intake information: the fields the agent collects before performing the lookup. Order name or number is required, and the agent must also collect at least one identifier (phone number or email address) to ensure accurate matching and prevent unintended data exposure.
- Information available to use: what the action returns once the lookup is complete. Click the information icon for a full breakdown of the available fields, since you'll need this for the next step.
- Click Save Action.
AI Actions conversational guidelines
This is where you define which order details the agent should share with the caller, and which to leave out. Use the example below as a starting point, adding or removing lines to suit your needs.
Tip: Refer back to the Information available to use section of the Edit action panel for the full list of available fields.
##Delivering the Result
- If the order is found: when delivering the result, read out the following in this order if available:
- order name
- product name
- quantity
- fulfillment_status
- tracking_company
- tracking_number
- Never provide the following information regardless if asked:
- tags
- tracking_url
Step 4: Test your WISMO agent
Once everything is configured, test your agent thoroughly using the Test call panel on the right-hand side of the agent editor before activating it in your call flow. This test will let you simulate a real call experience, but will not fire any call activity in Shopify as it is not a real call.
Run through three scenarios:
- Happy path: correct order number and matching identifier, everything resolves as expected.
- Fuzzy path: vague or partially incorrect details, to test how the agent handles uncertainty.
- Unhappy path: wrong order number, wrong identifier, and anything else that could go wrong on a real call.
If you encounter unexpected results, identify the issue, make the necessary adjustments, and repeat until you're confident the agent is ready to serve customers.
Tip: You can also use Simulations to test your agent against multiple scenarios before going live, including with real AI actions. See AI Voice Agent Simulations.
Step 5: Activate your WISMO agent
Add your configured agent to the call flow of the number where you want it to handle requests.
Steps:
- Go to Aircall Dashboard > Numbers in the left-hand menu.
- Select the relevant number.
- Click Edit in the top right corner to open the Flow editor.
- Click the + icon to open the widget menu and select AI Voice Agent.
- Select your configured WISMO agent.
- If your agent is set up to transfer calls, click the + icon under Fallback transfer, select Ring to, and add the relevant user or team.
Note: Where you place the agent in your call flow depends on your use case, for example as a first touch, a dynamic voicemail, or out-of-hours support.