Quickstart: Room offer carousel
Goal: Show hotel room offers as a photo carousel in chat — mapped automatically from your API JSON.
Prerequisites
Section titled “Prerequisites”- Standard plan or above recommended
- An HTTP API that returns a list of offers
- Assistant with tools enabled
Step 1 — Create the API Request tool
Section titled “Step 1 — Create the API Request tool”- Go to Tools → Create → API Request.
- Name:
show_room_offers - Description: Browse available rooms with photos and prices for given dates and guest count.
- URL: Your offers endpoint with query params for
arrival,departure,adults, etc.
Step 2 — Add result_transform
Section titled “Step 2 — Add result_transform”- items_path:
data.offers - layout:
carousel - card type:
media - sort_by:
totalGrossAmount.amount:asc - actions: “Book This Room”, “More Details”
The transform engine builds RICH_CONTENT on the server — the LLM does not map fields manually.
Step 3 — Attach and test
Section titled “Step 3 — Attach and test”Ask: “Show me rooms for June 15–17 for 2 adults.” Confirm carousel renders with images and prices.
Trust policy
Section titled “Trust policy”Rich cards appear only when the tool succeeds. Failed or missing tool data never renders as fake offers.