A
/dashboard/chat route exists (breadcrumb Chat) with placeholder copy Chat with support or your team. It is not in the sidebar. Do not use that page — open Zippy from the header instead.Where it lives
Every authenticated dashboard screen. The control sits in the top bar next to the breadcrumb: icon plus the label Zippy (icon-only on small viewports). Pressed state uses a purple fill while the panel is open.

Header Zippy button — click it or press ⌘J / Ctrl+J
min(560px) wide, min(640px) tall). Expand panel grows it to a centered modal; Collapse panel returns it to the corner.
Idle panel (new thread)
On a fresh thread the header title is New chat. Body:
Clicking a chip sends that prompt immediately.


Idle Zippy — Welcome to Zippy, three suggestion chips, Ask Zippy composer
Composer
There is no file-attach control in this composer.


Prompts menu — Find shipment, Create shipment, Set up carrier, Shipping rules
Prompt texts
Shipping rules appears only in Prompts, not as an idle chip.
Top bar


Expanded Zippy panel — same composer, more room for the thread
Chat history
Modal idzippy-chat-history. Title Chat history. Subtitle View and manage your chat history.
With no threads, the modal is only the empty state (no search field):


Chat history — empty before the first thread
Dates: Today, Yesterday, {{count}} day(s) ago, or a formatted date after a week.
Search misses: No matching conversations / Try a different search or clear the filter. Button Clear search.
In a conversation
While Zippy works you see Zippy is thinking (reduced motion) or a shimmering equivalent. Tool calls show a short status such as Looking up… / Fetched, Creating… / Created, Updating… / Updated, Deleting… / Deleted. Click the row to expand details when Zippy returned a list or table. If Zippy shows its reasoning, the chip reads Thinking (while streaming), Thought process, or Thought for {{seconds}}s. Click to expand. When you scroll up, a circular control (Scroll to latest message) jumps back to the newest bubble.Message actions (assistant replies, after streaming)
What Zippy can do
Zippy calls the same org-scoped API you use in the dashboard. Typical jobs:- Find shipments and orders (status, reference, tracking)
- Walk you through Create shipment (carrier, product, parcels)
- Connect a carrier (lists required credential fields first)
- Explain or create shipping rules
- Help finish onboarding after an import (reconnect channels, complete carrier setup)
post_shipments_send and all delete_* tools).
What it cannot do from this panel
These routes are not exposed as Zippy tools: billing, API tokens, Shopify/WooCommerce install internals, Zippy’s own chat APIs, MCP, printer authorization and printer jobs, migrations, admin, and inbound webhook endpoints. For store checkout rates use Get a shipping quote. For Slack/Klaviyo use Connect an integration.Locked add-on (paywall)
WhenzippyEnabled is off, the composer is replaced by Unlock Zippy:
History, expand, and close still work. See docs exists in the lock catalog but is not rendered on this panel.
If you send a message without the add-on, the assistant bubble reads Zippy is a paid add-on. Purchase it from your billing portal to keep chatting. (
ZIPPY_ADDON_REQUIRED).
Monthly cap: Your organization has reached its monthly Zippy message limit. The limit resets at the start of your next billing month. (ZIPPY_MESSAGE_LIMIT_REACHED).
Errors in the thread
You are done when the Zippy header button opens the panel, the composer shows Ask Zippy…, and (if the add-on is on) a suggestion chip or a typed question returns a reply. Buy the add-on from Billing and usage if you see Unlock Zippy.
Related
- Billing and usage — Zippy add-on buy/remove
- Dashboard — where the header control sits
- MCP overview — agents outside the app
- Send a shipment / Shipping rule fields