Well Told

Builds a welltolddesign.com cart link that adds an approved design at the buyer's quantity, with the same design details the Well Told customizer puts on a cart line. Used by the quote card's and proof viewer's buttons. sample: true adds a single unit. Nothing is ordered until the buyer pays on welltolddesign.com.

Creates a draft design the same way the Well Told customizer does and shows it in the proof viewer (flat preview, 3D view, warnings, approval checkboxes). design_type "map_logo" (default): a map of a location in a Well Told map style, plus the buyer's logo; needs location. design_type "logo_only": for each area (front, back, and bottom where search_catalog lists it) the buyer's logo, text (one or two lines, a layout and a font style) or nothing; by default the logo on the front only. Placement, size and rotation are set by Well Told's artwork engine. Returns an error explaining why when an entry can't be made (an unknown place, text too long to etch, an area combination Well Told doesn't sell).

Looks up where a buyer's designs stand: proof history, approval, and hand-off to checkout on welltolddesign.com. It does not see paid orders or shipping tracking.

Prices a design (design_id) or a product (product_id) at a quantity from Well Told's live store prices: unit price, setup fees, shipping fee, total, lead time, estimated ship and delivery dates, budget check, and the single-sample price. Shows the quote card, where the buyer can continue to welltolddesign.com.

Records the buyer's approval of a draft design. Used by the proof viewer's Approve button after the buyer ticks the proof approval and logo rights checkboxes; it requires both confirmations.

Searches Well Told's catalog of custom gifts for clients, employees, teams and events: glassware, tumblers and bottles personalized with a map of a meaningful place, a logo or text. Use it when someone is looking for custom, branded or personalized gifts in quantity. Filters by budget per unit, quantity (minimum order and volume pricing), category, and in-hand date (lead time). Returns each product's id, live price, minimum, estimated delivery date, the design types it offers (map_logo, logo_only) and its Logo Only areas.

Shows up to 8 products from search_catalog in an interactive grid where the buyer can see photos and prices and pick the products they want proofs for. Pass logo_id once a logo is uploaded so a pick can go straight to a proof.

Stores the buyer's own logo with Well Told and checks it for etching problems, returning a logo_id and plain-language warnings. Accepts a chat attachment (logo_file, where the app can pass attachments to tools), a logo_url the buyer pasted, or the upload_code from an earlier call. Called with no arguments it shows an upload box in the chat (with a secure upload page link as a fallback, works on phones) and returns an upload_code; calling again with that code returns the logo once the buyer has uploaded it.