Order Management Agent
In this tutorial, you’ll build a voice agent that handles order-related phone calls for an e-commerce or retail business. It verifies caller identity, looks up orders in real time, handles status inquiries, processes modifications, and manages returns.What You’ll Build
A phone agent that:- Verifies the caller’s identity before sharing order details
- Looks up order status via your API in real time
- Provides shipping and tracking information
- Processes order modifications (address changes, cancellations)
- Handles return and exchange requests
- Sends tracking links and receipts via SMS and email
- Follows your return policy and escalates exceptions
Step 1: Create the Agent
- Go to your thinnestAI Dashboard
- Click Create Agent
- Name it:
Order Management Agent - Set the description:
Handles order status, modifications, returns, and shipping inquiries
Step 2: Choose the Model
Select GPT-4o as your model. GPT-4o is excellent at structured data extraction and following multi-step verification flows. It handles order numbers, dates, and addresses accurately.Step 3: Add Knowledge
Return Policy Document
Upload a document containing your complete return and exchange policy:Shipping FAQ
Step 4: Assign Tools
Custom API Tool (Order Lookup)
Set up a custom API tool that connects to your order management system.- Go to the Tools tab
- Enable Custom API / Webhook
- Configure the order lookup endpoint:
SMS
Enable SMS to send tracking links and return labels.- Enable SMS in the Tools tab
Gmail
Enable Gmail to send detailed receipts and return instructions.- Enable Gmail in the Tools tab
- Connect your support email account
Step 5: Set the System Prompt
Step 6: Assign a Phone Number
- Go to the Phone tab
- Assign a phone number
- Set call direction to Inbound
- Save
Step 7: Test Your Agent
Testing Checklist
| Scenario | What to Test | Expected Behavior |
|---|---|---|
| Successful lookup | Provide valid order number + email | Agent verifies, shares status clearly |
| Failed verification | Give wrong email for an order | Agent denies access after 2 attempts |
| Order shipped | Ask about a shipped order | Agent provides tracking number, offers to text link |
| Order processing | Ask about a processing order | Agent explains it hasn’t shipped yet |
| Cancel processing order | Request cancellation | Agent confirms, processes cancellation |
| Cancel shipped order | Request cancellation of shipped order | Agent explains it’s too late, offers return |
| Eligible return | Request return within 30 days | Agent walks through process, sends label |
| Ineligible return | Request return after 30 days | Agent explains policy, offers escalation |
| Damaged item | Report a damaged item | Agent offers immediate replacement or refund |
| Address change | Request address change on shipped order | Agent explains it’s not possible |
| Security test | Ask for full credit card number | Agent refuses, shares only last 4 digits |
What to Listen For
- Verification flow: Does the agent always verify before sharing details?
- Data accuracy: Does it read back order info correctly?
- Natural delivery: Does it say “Saturday, March eighth” not “2026-03-08”?
- Empathy: When you report a problem, does the agent acknowledge it before jumping to solutions?
Tips for Improvement
- Add order status webhooks. Set up real-time webhook notifications so the agent can proactively text customers when their order ships or is delivered.
- Handle multiple orders. If a customer calls about multiple orders, the agent should handle each one sequentially: resolve the first, then ask “Now for your other order…”
- Build a returns dashboard. Use the CRM webhook data to track return reasons. If a specific product has high return rates, that’s valuable product feedback.
- Add self-service options. For simple status checks, consider adding an IVR option: “Press 1 to hear your order status, or press 2 to speak with an agent.”
- Integrate loyalty data. If you have a loyalty program, give the agent access so it can offer VIP customers extended return windows or expedited replacements.
Next: Survey & Feedback Agent — Build an agent that conducts phone surveys and collects NPS scores.

