Virtual Assistant task setup
Build virtual assistant tasks from reusable steps and data fields, with actions for each answer or skipped step.
What it is
Tasks are virtual assistant flows made from reusable steps. Each step can collect information or present an interaction, then run actions based on the answer or on a skip. Reusing steps and data fields helps you maintain consistent questions across tasks.
Who uses it and why
- Administrators and supervisors with Bot Trainer access build and maintain task flows.
- Developers configure supported scripts and external interactions used by steps.
Where to find it
Use Settings › Bots › Virtual Assistant › Tasks to assemble tasks. Manage reusable content in Settings › Bots › Virtual Assistant › Steps and Settings › Bots › Virtual Assistant › Data Fields.
These screens require the Bot Trainer role. Having the Settings role alone does not grant the bot-authoring screens.
How it works
A task has its own name, type, group and operator controls. Its Task Steps list places reusable steps in an order. Each use of a step can have its own enabled state, completion actions, skip actions and hidden picklist choices.
Completion and skip actions can branch according to the answer, jump to a different step or refer to another task. The step's data field controls the expected answer and validation. The same reusable step can participate in several tasks.
Visitors receive the configured messages, choices and fields through the applicable channel. Operators can send tasks where Operator can Send Task is enabled and the task's team and channel restrictions permit selection. Operator can Cancel Task separately controls operator cancellation.
Configure it
- Create the required Data Fields and Steps.
- In Tasks, select Add Task, enter Task Name and choose Type. The choices are Chat, Pre-Chat and Verification.
- Set Task Group, welcome text and operator controls as needed.
- Under Task Steps, choose Add Step, arrange the steps and configure the actions for answers and skips.
- Save the draft, preview the paths and publish the intended version using Go Live.
Use Copy Task when creating a related task. Review whether its steps should remain shared or be copied as new steps. Editing a shared step can affect other tasks that use it.
Settings
| Setting | Where | Applies to | Default | Who can change it | What it does |
|---|---|---|---|---|---|
| Type | Settings › Bots › Virtual Assistant › Tasks | website | Chat | Bot Trainer role | Selects Chat, Pre-Chat or Verification for the task. |
| Operator can Send Task | Settings › Bots › Virtual Assistant › Tasks | website | Off | Bot Trainer role | Makes the task available for operators to send, subject to its restrictions. |
| Restrict to following Team(s) | Settings › Bots › Virtual Assistant › Tasks | website | Not set: no team restriction | Bot Trainer role | Restricts operator task selection to the selected teams. |
| Restrict to following Channel(s) | Settings › Bots › Virtual Assistant › Tasks | website | Not set: no channel restriction | Bot Trainer role | Restricts operator task selection to the selected channels. |
| Operator can Cancel Task | Settings › Bots › Virtual Assistant › Tasks | website | Off | Bot Trainer role | Allows an operator to cancel the task. |
| Operator Cancel Task Message | Settings › Bots › Virtual Assistant › Tasks | website | Not set: no cancellation message is sent | Bot Trainer role | Supplies the message used when an operator cancels the task. |
| Welcome Message (Operator Available) | Settings › Bots › Virtual Assistant › Tasks | website | Not set: uses the virtual assistant's online welcome message if one is configured and welcome messages are enabled | Bot Trainer role | Supplies the task welcome text when an operator is available. |
| Welcome Message (No Operator Available) | Settings › Bots › Virtual Assistant › Tasks | website | Not set: uses the virtual assistant's offline welcome message if one is configured and welcome messages are enabled | Bot Trainer role | Supplies the task welcome text when no operator is available. |
| Skip Step Label | Settings › Bots › Virtual Assistant › Tasks | website | Not set: uses the standard Skip or Skip this Info label unless the step supplies its own label | Bot Trainer role | Sets the visitor-facing label for skipping eligible steps. |
| Cancel Step Label | Settings › Bots › Virtual Assistant › Tasks | website | Not set: standard cancel buttons use Cancel unless the step supplies its own label | Bot Trainer role | Sets the visitor-facing cancellation label in the No Operator Assigned configuration. |
Fields
| Field | Where | Required | What it is for |
|---|---|---|---|
| Task Name | Settings › Bots › Virtual Assistant › Tasks | Yes | Gives the task a unique website-level name of no more than 255 characters. |
| Description | Settings › Bots › Virtual Assistant › Tasks | No | Describes the task's purpose for people managing it. |
| Task Group | Settings › Bots › Virtual Assistant › Tasks | No | Groups related tasks in the management list. |
Permissions
| Permission | Lets you |
|---|---|
| Bot Trainer | Access virtual assistant Tasks, Steps and Data Fields. |
Limits and good to know
- A task needs a non-blank, unique name within the website, limited to 255 characters.
- An enabled task must contain at least one step.
- Publication rejects references to missing or disabled tasks.
- A task already used as a jump destination in another task cannot itself add a further task jump in the checked publication path. Simplify nested flows if publication reports this restriction.
- INSIDE prevents task deletion while checked references remain in task actions, pre-chat or offline themes, social account settings or SMS start-task settings. Remove or replace those references first.
- Saving a draft does not make it the live version.
Depends on and works with
+12 more · this feature uses
- Virtual Assistant task actionsConfigured by
Business and outbound actions define the updates and messages performed on task branches.
- Task integrations, appointments and embedded pagesConfigured by
Integration actions and their return branches define external interactions within a task.
- Virtual Assistant task previewEnhances
Preview helps review task behaviour before publication.
- Virtual Assistant task import and exportEnhances
Copy, export and import support task reuse.
- Virtual Assistant task validation and retriesConfigured by
Help and invalid-input settings define the recovery choices offered by a task.
- Visitor event updates to customer contextConfigured by
Visitor-event actions choose which task to start automatically.
- Pre-chat survey for visitorsEnhances
A pre-chat survey can collect details before a task starts.
- Offline help for visitorsConfigured by
The theme selects the task used for offline intake.
- Virtual Assistant tasks in messaging channelsEnhances
Channel rendering determines how task steps appear to visitors.
- Messaging channel connectionsConfigured by
Messaging account settings choose the tasks started when operators are available or unavailable.
- SMS number and channel setupConfigured by
SMS account settings choose start tasks and whether operator assignment happens first.
- Admin settings and feature switches · managed by PowerfrontLicence
Powerfront must enable Virtual Assistant for the website to use task features.
+21 more · used by
- Visitor event updates to customer contextConfigured by
The selected enabled task defines the journey requested by Start Task.
- Virtual Assistant task drafts and publishingRequires
Task versions contain the authored task and its step configuration.
- Virtual Assistant task steps and branchesRequires
Execution needs an authored task with enabled steps and configured branches.
- Virtual Assistant task data fieldsConfigured by
Steps bind reusable fields to task questions.
- Existing answers in Virtual Assistant tasksRequires
Answer reuse needs an authored task step linked to the relevant fields.
- Virtual Assistant task messages and identityConfigured by
Task and step authoring supplies the content and action links.
- Virtual Assistant task pauses and handoverRequires
Pause, cancellation and handover need an authored task and its action configuration.
- Virtual Assistant task actionsRequires
Business and outbound actions must belong to an authored task branch.
- Task integrations, appointments and embedded pagesRequires
External interaction actions must be configured within an authored task.
- Virtual Assistant task previewRequires
Preview uses a saved task and its enabled steps.
- Virtual Assistant task import and exportRequires
Transfer operates on the reusable field, step and task definitions.
- FAQ bot training and automatic repliesConfigured by
Task definitions supply the steps run by task-based intent responses.
- Task notes and operator remindersRequires
A task must contain the reminder action on a branch that can run.
- Virtual Assistant tasks started by AutopilotRequires
The function needs an authored task to select and start.
- Virtual Assistant task validation and retriesRequires
Recovery routes need an authored task and its current step configuration.
- Autopilot handover and error handlingConfigured by
The selected tasks define what happens after an expiry, error or intentional handoff.
- AI updates to customer and conversation dataEnhances
Optional Workflow functions select an existing task.
- AI guardrail routing and fallback actionsConfigured by
A selected workflow task defines what happens after a guardrail rule triggers it.
- Virtual Assistant tasks in messaging channelsRequires
Tasks and reusable steps define the questions.
- Live show RSVP, reminders and follow-upConfigured by
Callback Task selects a separately authored, enabled workflow.
- Event, link and Virtual Assistant reportsConfigured by
Task definitions supply the task names and steps shown in Virtual Assistant reports.
View all connections as a list
This feature uses
- TeamsConfigured by
Team choices can restrict operator task selection.
- Website, channel and subsite accessConfigured by
Channel choices can restrict operator task selection.
- Virtual Assistant task drafts and publishingConfigured by
Drafts and publication control which task version is live.
- Virtual Assistant task steps and branchesRelated
Published task definitions supply the ordered steps and branches used during execution.
- Virtual Assistant task data fieldsConfigured by
Reusable field definitions set the answer types, validation and storage used by task steps.
- Existing answers in Virtual Assistant tasksConfigured by
Existing-answer rules decide whether a task asks again, confirms an answer or skips a question.
- Virtual Assistant task messages and identityConfigured by
Task and step content defines the messages, language versions and assistant identity.
- Virtual Assistant task pauses and handoverConfigured by
Handover and task-control settings define pause, resume, cancellation and transfer behaviour.
- Virtual Assistant task actionsConfigured by
Business and outbound actions define the updates and messages performed on task branches.
- Task integrations, appointments and embedded pagesConfigured by
Integration actions and their return branches define external interactions within a task.
- Virtual Assistant task previewEnhances
Preview helps review task behaviour before publication.
- Virtual Assistant task import and exportEnhances
Copy, export and import support task reuse.
- Virtual Assistant task validation and retriesConfigured by
Help and invalid-input settings define the recovery choices offered by a task.
- Visitor event updates to customer contextConfigured by
Visitor-event actions choose which task to start automatically.
- Pre-chat survey for visitorsEnhances
A pre-chat survey can collect details before a task starts.
- Offline help for visitorsConfigured by
The theme selects the task used for offline intake.
- Virtual Assistant tasks in messaging channelsEnhances
Channel rendering determines how task steps appear to visitors.
- Messaging channel connectionsConfigured by
Messaging account settings choose the tasks started when operators are available or unavailable.
- SMS number and channel setupConfigured by
SMS account settings choose start tasks and whether operator assignment happens first.
- Admin settings and feature switches · managed by PowerfrontLicence
Powerfront must enable Virtual Assistant for the website to use task features.
Used by
- Visitor and conversation information panelsEnhances
Available tasks can be launched from the conversation controls.
- Chat queueEnhances
Queue action buttons can start configured tasks instead of continuing to wait for an operator.
- Broadcast for acceptanceEnhances
An optional task handles acceptance expiry.
- Offline messagesEnhances
A configured task can replace the ordinary offline form.
- Custom fields in visitor formsConfigured by
Task-step authoring defines workflow forms.
- Chat tasks and topics for visitorsConfigured by
Tasks and reusable steps define the guided interaction.
- Proactive chat invitationsEnhances
Invitations can start a configured pre-chat task.
- Visitor popup event setupConfigured by
The selected task defines the journey started by an open-chat popup.
- Visitor event updates to customer contextConfigured by
The selected enabled task defines the journey requested by Start Task.
- Virtual Assistant task drafts and publishingRequires
Task versions contain the authored task and its step configuration.
- Virtual Assistant task steps and branchesRequires
Execution needs an authored task with enabled steps and configured branches.
- Virtual Assistant task data fieldsConfigured by
Steps bind reusable fields to task questions.
- Existing answers in Virtual Assistant tasksRequires
Answer reuse needs an authored task step linked to the relevant fields.
- Virtual Assistant task messages and identityConfigured by
Task and step authoring supplies the content and action links.
- Virtual Assistant task pauses and handoverRequires
Pause, cancellation and handover need an authored task and its action configuration.
- Virtual Assistant task actionsRequires
Business and outbound actions must belong to an authored task branch.
- Task integrations, appointments and embedded pagesRequires
External interaction actions must be configured within an authored task.
- Virtual Assistant task previewRequires
Preview uses a saved task and its enabled steps.
- Virtual Assistant task import and exportRequires
Transfer operates on the reusable field, step and task definitions.
- FAQ bot training and automatic repliesConfigured by
Task definitions supply the steps run by task-based intent responses.
- Task notes and operator remindersRequires
A task must contain the reminder action on a branch that can run.
- Virtual Assistant tasks started by AutopilotRequires
The function needs an authored task to select and start.
- Virtual Assistant task validation and retriesRequires
Recovery routes need an authored task and its current step configuration.
- Autopilot handover and error handlingConfigured by
The selected tasks define what happens after an expiry, error or intentional handoff.
- AI updates to customer and conversation dataEnhances
Optional Workflow functions select an existing task.
- AI guardrail routing and fallback actionsConfigured by
A selected workflow task defines what happens after a guardrail rule triggers it.
- Virtual Assistant tasks in messaging channelsRequires
Tasks and reusable steps define the questions.
- Live show RSVP, reminders and follow-upConfigured by
Callback Task selects a separately authored, enabled workflow.
- Event, link and Virtual Assistant reportsConfigured by
Task definitions supply the task names and steps shown in Virtual Assistant reports.
FAQ and troubleshooting
Why can I not see Tasks?
The task-authoring screens require the Bot Trainer role. Check the roles assigned to your account.
Why can an operator not send a task?
Check that the intended version is live and enabled, Operator can Send Task is on and the operator meets its team and channel restrictions.
Why did a change affect several tasks?
Those tasks may share the same reusable step or data field. Review its uses before changing it, or create a separate definition for different behaviour.
Why is publishing blocked by another task?
Check whether a referenced task is disabled or missing, and whether the flow adds an unsupported further level of task jumps.
Why can I not delete an unused-looking task?
It may still be referenced by a cancellation action, chat theme or messaging account. Follow the reference described in the error and remove it first.