AI Studio Docs
Flow Builder

Cards

Every card type, what it does, and when to reach for it

Cards are grouped by what they do. Drag one onto the canvas and connect it to build your conversation.

Sending

  • Send a message: sends a message to the visitor. Use {{message}} to include what they just said, or {{name}} to include an answer saved by an earlier Ask or Choice card.
  • Send media: sends an image, video, audio clip, or file, with an optional caption (not available for audio, since WhatsApp doesn't support one).
  • Send a location: sends a pin (latitude/longitude, with an optional name and address). No upload involved, use it to point a visitor to a physical address.
  • Ask an AI Agent: sends the visitor's message to one of your workspace's AI Agents and replies with its answer, then continues to the next card.
  • Send a product (WhatsApp only): shows a product, a curated list, or the whole catalog from the bot's connected product catalog. Sends immediately and doesn't wait for a reply.

Collecting

  • Ask a question: asks an open question and waits for the visitor's reply, saving it into the attribute you pick. Name, Email, and Phone update the contact's own details directly.
  • Offer choices: offers a fixed set of options and waits for the visitor to pick one. Anything that isn't one of the options re-asks rather than moving on, so the answer is always something you can branch on. On WhatsApp, more than three options becomes a numbered list instead of buttons; on SMS, every choice becomes a numbered list.
  • Send a WhatsApp Form (WhatsApp only): sends a published WhatsApp Form (built under the bot's Forms tab) and waits for the visitor to submit it. Each field you link is saved into an attribute.
  • Request a location (WhatsApp only): asks the visitor to share their location and waits for their reply.

Logic

  • Branch on an answer: compares some text and runs one of two paths depending on the result, contains, is exactly, is more/less than, or simply answered at all. Check the visitor's latest message, or an answer saved earlier.
  • Call an API: calls one of your workspace's API connections (configured under Workspace → APIs) and continues down one of two paths depending on whether it succeeded, saving whichever response fields you pick into variables.
  • Jump to another flow: ends this flow and continues in another flow of the same bot, carrying saved answers across. Use it to split a long conversation into separate flows.
  • Run another flow: runs another flow and then carries on here, at the next card. Saved answers are shared both ways, use it for logic you want in one place (like collecting contact details) rather than copying the same cards into several flows.
  • Update the conversation: adds tags, changes status, reassigns, or sets a custom attribute, without a message to the visitor. Runs once, then continues. The same actions are also available directly on Choice options, Condition branches, Ask, and Agent cards.

Handover

  • Hand over to a human: ends the automated conversation and passes it to a human agent in the Inbox. The visitor keeps talking in the same chat and the agent's replies reach them live. Leave the agent unset to land in the unassigned pool.

On this page