When to use a workflow
Use a workflow when:- An agent should decide when the process starts.
- The process needs extra input from the agent.
- The same set of ticket updates, notes, messages, or assignments happens repeatedly.
- You want the process to appear only for tickets that match specific filters.
Workflow availability
A workflow appears on a ticket only when:- The workflow is enabled and published.
- The ticket matches the workflow trigger filters.
- The ticket is in the workflow’s App/Game scope.
- The agent has access to that App/Game scope.
Workflow inputs
Workflows can ask the agent for information before running. Supported input types include:
Inputs can be required or optional. Required inputs must be filled before the workflow can run.
Free-text inputs can also have:
- A prefill, which is a Liquid template rendered against the ticket when the agent opens the workflow. The rendered text is the initial value and can still be edited. For example,
{{ trigger.issueSummary }}prefills the ticket summary. - A placeholder, which is hint text shown when the field is empty.
Example: escalation workflow
An escalation workflow might:- Ask the agent for an escalation reason.
- Add a private note containing the reason.
- Add an
escalatedtag. - Assign the ticket to a specialist.
- Put the ticket on hold.
- Send a Slack message to the escalation channel.
Best practices
- Give workflows clear names that describe the agent action, such as
Escalate to payments. - Use filters so agents only see relevant workflows.
- Use required inputs for information the process depends on.
- Add a private note when a workflow changes ticket ownership, status, or priority.
- Check the run history after publishing a workflow to confirm it behaves as expected.