When to use it
Card is Button with pictures. Reach for it when the choice is easier to make by sight than by name: a plan, a product, a room type, a branch location. Where the choices are plain words, Button is simpler to set up.The gambit and its editor
Every page in this section shows the same demo flow: Start, a Welcome message, the gambit this page covers, then End. The gambit sits third, selected, with its editor open on the right. The rest of the screen is dimmed. The gambit carries one handle per card, plus a Free Input handle while Allow Free Text is on.Cards
Each card is a collapsed row with a thumbnail, its title, and a trash icon. Select the chevron to expand it. Add Card appends a row and shows how many you have used out of a maximum of 10. An expanded card holds:
The image address, title, value, subtitle, and button fields accept variables. Tars fills them in when the agent sends the cards.
Drag the grip handle to reorder cards. The list icon on a card row turns on Auto populate: one card per list item. See Auto populate cards.
Auto populate cards
An auto-populated card becomes one card for each item in a list variable. Use it when the cards come from an earlier step, such as the products an API call returns. When you select the list icon on a card row, a field with the placeholder List variable, type @ to pick appears. Pick the variable that holds the list. In any field of the card, type @ and pick{{item}} for the current list item. For a list of objects, select the pill to add a field, such as {{item.title}} or {{item.image}}.
Each generated card keeps the template card’s Jump To route, so every card from one row leads to the same gambit. Selecting a generated card stores that item’s value, or its title when the value is empty. Static cards can sit beside an auto-populated card, each with its own route.
Tars skips an item whose title is empty, and keeps only the first card for each value. The gambit shows 10 cards at most, and static cards count toward that limit.
The builder labels an auto-populated card’s handle with its list variable. It shows a warning on the gambit in two cases:
- The card has no list variable selected.
- The title does not use
{{item}}, so every generated card looks the same.