Workflow Interactions
Buttons, data collection forms, links, and other interactive elements visitors encounter during guided chat workflow conversations.
Overview
Chat workflows present visitors with structured, step-by-step interactions inside the chat. Instead of free-form typing, visitors click buttons, fill in forms, and follow guided paths. This article covers every interactive element a visitor can encounter during a workflow.
How Workflows Appear
When a workflow triggers, messages and interactive elements appear in the chat just like they would from a human agent. Visitors don't see any visual indicator that they're in a "workflow" — it all feels like a natural conversation.
A typical flow:
- A message appears with a question or information
- The visitor responds — by clicking a button, filling a form, or typing
- The next step appears based on the response
- This repeats until the workflow completes or hands off
When the visitor starts a workflow by tapping something — a Home button or a conversation starter — the label they tapped appears as their own message first, and the workflow's first step answers it. If a workflow starts while Yaplet is still writing an answer, the half-written answer stays on screen and finishes normally.
Yaplet.startBot, a yaplet://bot/ link and an Engagement banner or chat message. The label of a tapped Home button or conversation starter reaches the colleague as the visitor's own message instead. In that conversation only a colleague can start a workflow, from the inbox or the mobile app. Automatic triggers stay quiet too while a colleague is in the chat, unless a Rating given trigger is set to start anyway.Buttons
Buttons are the most common interactive element. They appear as outlined chips on the left, under the latest bot message, letting visitors choose from predefined paths.
When a visitor clicks a button:
- The selected option is recorded
- All buttons disappear immediately
- The workflow continues down the branch connected to that choice
Buttons and collect-data cards that no longer belong to a live workflow disappear on their own: when a newer workflow run replaces the old one in the conversation, when the workflow is switched off, or when an edit removes the step they came from.
Collect Data
Collect data actions show a single input field inside a card that appears in the AI's place in the chat. The visitor fills in one piece of information and submits it. In the step you choose What to collect: The visitor's own email address, or Something else (an order number, another email address, …) with an Answer type.
What Visitors See
An elevated card appears with:
- A question label (e.g., "What is your order number?")
- An input field on the page color, matching the expected data type
- A solid Submit button
- A close button (X) to dismiss without answering
Input Types
| Choice in the step | Visitor Experience |
|---|---|
| Text | Free-text input field |
| Number | Numeric input — rejects non-numeric values with an error message |
| Choice from a list | Select menu with the choices you add — must choose from the list |
| Email address (checked, not saved on the visitor) | Email field with format validation, for an address that is not the visitor's own (for example the one an order was placed with) — kept only for this workflow run |
| The visitor's own email address | Email field with format validation (rejects invalid addresses); the address is saved on the visitor |
After submitting, the answer appears in the chat as the visitor's own message (for example "12345") and the workflow continues. For The visitor's own email address the chat shows "You have updated your email to …" instead.
Ask Question
The ask question action sends a message and then pauses, waiting for the visitor to type a free-form response. Unlike buttons (predefined choices) or collect data (structured input), this lets visitors answer in their own words.
The visitor types normally in the chat input and hits Enter. Their response is captured and the workflow moves to the next step.
Forms
The form action opens a full multi-field form overlay inside the widget. Unlike collect data (one field at a time), forms can include many fields — text, email, dropdowns, checkboxes, ratings, and more.
When triggered, the visitor sees a card from Yaplet reading "Yaplet would like you to fill this form:" with one outlined chip carrying the form name. Tapping it opens the form as an overlay within the widget. After submission, the workflow continues.
In the step's Fill in from this workflow section, a workflow can fill in some of the form's text fields in advance with what it already knows — for example the order number the visitor gave a moment earlier. The visitor sees those answers already typed in and can change them before sending. Only free-text fields are filled in this way; choices and ratings are always left to the visitor.
Every form belongs to a ticket board, and its answers are filed as a ticket on that board. Forms are built and edited on the board's own Forms tab, at Tickets → (board) → Forms.
Messages
Message actions send text to the visitor as plain text under the same Yaplet · AI assistant name row as the AI's own answers — the workflow speaks as Yaplet. No interaction is needed — the workflow automatically continues to the next step. Messages are used for welcome text, instructions, confirmations, or any informational content between interactive steps.
A message step with Let the AI say it switched on is written by the AI for this visitor — in their language, same meaning, nothing added. The visitor sees the typing dots first, then the message, exactly like an AI answer.
Links
Link actions (Open link) redirect the visitor to the step's Address automatically when the workflow reaches that step — the widget opens the page itself, nothing is posted in the chat and there is nothing to click. The address can include values the workflow collected, like an order number. The Open in a new tab switch decides how:
- On — opens the address in a new tab; the visitor stays on the current page
- Off — the visitor's current page is replaced by the address, so they leave the page they were on
On Facebook, Instagram and email the address is sent as text instead.
Request Agent
When a workflow reaches a request agent action, the conversation hands off to a human agent. The visitor may see a custom message before the transition — the step's Message to the visitor (optional), e.g., "Let me connect you with someone who can help..."; without one they see "A team member will join this chat.", and then the chat moves to a live conversation. When nobody from your team is available, that line is left out and the visitor gets a card for leaving a message for the team instead.
The agent receives the full workflow conversation history for context. The step's Note for the colleague (optional) is added to the conversation as an internal note just before the handover — only your team sees it.
Reply Time (retired)
Reply time (retired) shows the visitor nothing — the widget never promises how soon your team replies. It can't be added to a workflow, and an existing one can simply be deleted. Until you delete it, a workflow that still has one never starts on a phone call.
Routing Actions
These actions are invisible to the visitor but change where the conversation goes:
- Send to the AI agent — hands the step's question to the brand's AI agent (Yaplet), which answers it straight away: typing dots, then one reply. On that turn it does not start another workflow or offer a human agent; the visitor's next message is an ordinary AI turn.
- Start a workflow — ends the current workflow and starts the one it names, in the same chat thread. If that workflow cannot start (for example it was switched off or deleted), the visitor gets an apology and a colleague is requested.
- Conditions — evaluates visitor properties (country, email, session count, agent availability) behind the scenes and routes down the matching branch. The visitor just sees the next message from whichever path was taken.
- Call an API — fetches data from your own system without showing the visitor anything, then goes on as Worked or Failed. If it fails and the workflow has no Failed branch, the visitor gets an apology and a colleague is requested.
- Stop — don't reply — ends the workflow and sends nothing.
Action Categories
The step picker (Add a step) lists the actions in two groups:
| Group in the picker | Actions | How They Work |
|---|---|---|
| Steps — run one after another | Write a message, Ask a question, Collect data, Start a form, Request agent | Run one after another, top to bottom, within a card |
| Ends the card — the last step, one per card | Buttons, Conditions, Call an API, Send to the AI agent, Start a workflow, Open link, Stop — don't reply | One per card — determines the next step or branch |
The steps in the first group run sequentially. When the workflow reaches the step that ends a card, it either branches (Buttons, Conditions, Call an API), hands over (Send to the AI agent, Start a workflow), or ends (Open link, Stop — don't reply).