Flume

Text only, for your own work: the person sees nothing. Use it once per item when there are two or more items (a spec list, several photos or links, a comparison, a bid package); for one item the person should watch, use search_products. Returns rows as text and draws no card: the person sees nothing from this call, so what they need must be in your reply or your document. To show the person results in a Flume card, call search_products with the same request. Set category to tile or vinyl. Every search needs a photo: the person's (reference_image or photo_url), a product's main image link or its page link as a last resort (Flume then reads its og:image, often a collection or room photo, not always the product), or the photo_ref of a photo Flume already holds; with none, ask in one line with both halves, word for word: "Do you have a photo? Upload it, or I can find a reference image on the web." On "find one", pass a web image of the look in photo_url and tell them which image you used. Pass the person's words in request; pass filters only for what the person stated, and list in open the topics they left open (Flume asks nothing here). Each call is a new search. On tile Flume narrows by where it goes, material, size, finish, a finish to leave out, thickness, glazed or unglazed and mosaics; on vinyl by wear layer, plank size, installation method, thickness, finish, texture, rigid core and attached pad. The look and color come from the photo. It does not narrow or sort by price, brand, supplier, collection, stock, lead time or ship origin. Each row carries the as-low-as price per sq. ft. and the lead time. Rows carry the rank, strong or other match, sku_uuid, the name, the as-low-as per sq. ft., where each option ships from with its country flag and lead time, the minimum order, Flume's inferred application areas, the primary product shot as a Flume image link and the product page link; detail full adds the product page's At-a-glance facts. A marble, travertine, terrazzo, concrete or wood look in a tile request is tile, in porcelain and ceramic: unless the person named porcelain or ceramic, confirm that with them in one line before searching. Real stone, stone slabs and countertops, quartz, hardwood, carpet, laminate, trims and trim pieces, and tile that is not ceramic or porcelain are not in this search: Flume's sales team sources them (tell the person, ask, then contact_sales). A stated quantity far below Flume's smallest full order (a home bathroom's 60 sq. ft.) gets the minimum first: one plain line and one question, see options anyway or ask Flume's sales team about a smaller order; no search, card or other question in that reply. For a wood-look tile floor the person has not ruled vinyl out for, also call this with category vinyl and the same photo, and show at most 2 of those rows as their own group after the tile one ('Living room · Wood-look vinyl plank, also worth a look'); never the other way round. A photo attached to the person's message goes in reference_image.

find_products

Use this when the person wants Flume's sales team: a question about a product or an instant quote they have seen, a larger quantity, the other ship option, or a product Flume search does not cover. Draws no card; the result text says what happened. Real stone, stone slabs and countertops, quartz, hardwood, carpet, laminate, trims and trim pieces, and tile that is not ceramic or porcelain are not in Flume search. Sends the team the person's message, with the product and the instant quote when there is one. Each call files one request, up to an hourly limit and a limit on open requests. The team replies by email.

contact_sales

Use this when the person wants a new Flume project. Draws no card; the result text says what happened. To show the person their projects, call show_projects. Creates the project in the person's account. Needs a name, at least one project type and the month the material is needed. Multi-family, Single-family and Hotels take a unit count; every other type takes a size in square feet (an estimate is fine). A name matching one of the person's active projects creates nothing and the result names that project, unless person_confirmed_new is true. find_project lists the person's projects as text.

create_project

Use this when the person asks which Flume account is connected, or whether it can get instant quotes. Draws no card; the result text says what happened.

get_profile

Use this when the person asks for an instant quote on ONE product, or what one tile or floor costs delivered to a US ZIP; for two or more products, use quote_products once with every line. Draws Flume's instant quote card for the person. Creates the instant quote in the person's account. Needs three things, all stated by the person: the product (its sku_uuid), the quantity in square feet, and the 5-digit US delivery ZIP. Instant quotes cover ZIP codes in the contiguous US; Alaska, Hawaii, US territories and military addresses get none. Below the product's minimum order (tile 1,000 sq. ft. from a US warehouse or 5,000 sq. ft. from overseas; vinyl 10,000 sq. ft. or one container) no instant quote runs and the result states the minimum. The result is the delivered price for that quantity and ZIP, with sales tax. The as-low-as price in search results is for a full load, before tax. If Flume tries and cannot price the product, it may send that ask to Flume's sales team as a pricing request, and the result then names its number; nothing is sent otherwise. Not for orders or samples: orders go through Flume's sales team (contact_sales), samples through Flume's self-serve app or the team.

get_instant_quote

Use this when an instant quote came back still pricing and the person asks whether it is ready. Draws Flume's instant quote card for the person when it is. Pass the request_uuid from that result.

check_quote

Use this when the person asks about their instant quotes on Flume: which ones they have, an instant quote's number, or when one expires. Draws Flume's card of their instant quotes for the person, each with its product's picture; the result text lists the same, one line per instant quote.

show_quotes

Use this when there are two or more products to price (up to 5, each with its quantity, delivered to one US ZIP): a spec list, a comparison, a bid package; for one product the person should watch, use get_instant_quote. Creates an instant quote per line in the person's account, returns each as text and draws no card. To show the person one instant quote in a Flume card, call get_instant_quote. Each line needs its sku_uuid and the quantity in square feet the person stated, and the call one 5-digit delivery ZIP the person gave. Instant quotes cover ZIP codes in the contiguous US; Alaska, Hawaii, US territories and military addresses get none. Below a product's minimum order the line is refused with the minimum. Two instant quotes run at once; the call waits up to 20 seconds and answers each line as ready, still pricing or not run. If Flume tries and cannot price a line, it may send that ask to Flume's sales team as a pricing request, and the line then names its number; nothing is sent otherwise. A repeat with the same lines collects the pending ones and creates nothing more.

quote_products

Use this when Flume's crop card is showing (or search_products ran on part of a photo) and the person answers in the chat instead of tapping the card. Draws Flume's crop card again for the person to confirm the area, or the search's next card. 'Yes', 'looks good' or 'search that': area card, with the crop_box the card last reported if any; Flume searches that box. 'Search the whole photo': area whole. 'No, the tile behind the mirror' or 'the floor, not the wall': their words as photo_focus, or a crop_box of your own when you can see the photo, which Flume searches straight away; with the words alone Flume draws the box on that tile and shows the crop card again for the person to confirm. Pass the photo_ref from the last result when there is one, and the quantity_sqft and destination_zip the person stated. Not for a new photo: that is a search call.

crop_photo

Use this when the person says 'show me', 'open it' or 'the second one' about one product from a Flume result: they want to look at it. Draws Flume's product card for the person. For a fact question (a spec, a lead time, a minimum), or for your own work, use get_product instead: it returns text and draws no card. Pass the sku_uuid from the result.

show_product