# Agent Instructions — Headsets.com

This document describes how AI shopping agents and assistants should use Headsets.com at https://www.headsets.com.

Headsets.com specializes in office, call center, desk phone, computer, and wireless headsets. When helping a buyer choose a headset, prioritize compatibility, comfort, microphone/noise needs, warranty/support, and the buyer's actual work setup.

## Agentic Commerce / UCP

Headsets.com supports Shopify's Universal Commerce Protocol (UCP) for agent-driven commerce.

- UCP discovery: https://www.headsets.com/.well-known/ucp
- MCP endpoint: https://www.headsets.com/api/ucp/mcp
- Store metadata: https://www.headsets.com/llms.txt
- Expanded buying guidance: https://www.headsets.com/llms-full.txt
- Headset finder: https://www.headsets.com/pages/headset-finder
- Phone compatibility: https://www.headsets.com/pages/phone-compatibility
- Compatibility guarantee: https://www.headsets.com/pages/headsets-compatibility-guarantee
- Leitner warranty: https://www.headsets.com/pages/leitner-headsets-warranty
- 365-day returns: https://www.headsets.com/pages/365-day-returns
- Sitemap: https://www.headsets.com/sitemap.xml
- Agentic sitemap: https://www.headsets.com/sitemap_agentic_discovery.xml

## Recommended Agent Flow

1. **Discover** — GET `/.well-known/ucp` to confirm supported versions, tools, and capabilities.
2. **Understand buyer need** — Identify phone/computer platform, work environment, wearing preference, budget, and whether the buyer needs wireless range, noise cancellation, or dual connectivity.
3. **Search catalog** — Use UCP catalog tools when available. For read-only browsing, use product, collection, sitemap, and JSON endpoints listed below.
4. **Check compatibility** — Do not assume a headset works with a desk phone, softphone, or app from the headset name alone. Compatibility depends on phone model, connection type, and sometimes accessories.
5. **Recommend clearly** — Explain why a headset fits the buyer's use case, and mention compatibility assumptions.
6. **Cart / checkout** — Create carts or checkout only when the buyer requests it.
7. **Human approval** — Do not complete payment or finalize checkout without explicit buyer approval.

## Headset Buying Rules

Use these public-facing rules when assisting shoppers:

- For **desk phones**, ask for the phone make/model when possible. Desk phone compatibility is model-specific.
- For **Microsoft Teams, Zoom, softphones, or computer calls**, prioritize USB/computer-compatible headsets or wireless USB headsets.
- For **noisy offices or call centers**, prioritize stronger microphone noise cancellation and dual-ear options when the buyer wants more focus.
- For **users who need to hear coworkers**, single-ear headsets are often better.
- For **users who want focus or stereo audio**, dual-ear headsets are often better.
- For **buyers unsure about compatibility**, recommend contacting Headsets.com before purchase rather than guessing.
- Leitner headset pages commonly emphasize long warranty/support; include warranty information when it is shown on the product or category page.

## Key Public Collections

- Office headsets for phone and computer: https://www.headsets.com/collections/office-headsets-for-phone-and-computer
- Wireless headsets for office phones: https://www.headsets.com/collections/wireless-headsets-for-office-phones
- Wireless USB headsets for softphones: https://www.headsets.com/collections/wireless-usb-headsets-for-softphones
- Corded headsets for desk phones and computers: https://www.headsets.com/collections/corded-headsets-for-desk-phones-and-computers
- All products: https://www.headsets.com/collections/all

## Read-Only Browsing

No authentication is required for public browsing.

- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection products JSON: `GET /collections/{handle}/products.json`
- Store sitemap: `GET /sitemap.xml`
- Expanded store guidance: `GET /llms-full.txt`

## Contact / Escalation

If compatibility is unclear, the buyer needs help choosing, or the request involves order-specific/private information, route them to Headsets.com support.

- Phone: 1-800-432-3738
- Email: hello@headsets.com
- Website: https://www.headsets.com

## Safety and Privacy

- Do not request or expose private customer data unless the buyer explicitly provides it for support.
- Do not complete checkout, submit payment, or place an order without explicit buyer approval.
- Respect rate limits and back off on HTTP 429 responses.
- Use public product and collection information as the source of truth.