Manual & shortcut trigger (button on a contact/conversation)
Launch a workflow with one click: the Shortcut trigger runs from the inbox on a conversation, and the Manual trigger is invoked by another workflow or the API.
Watch this step in the video · Shortcuts for your team in the inbox
Not every workflow should fire on its own. Sometimes you want a person to launch the process with one click on a conversation or a contact, or to have another workflow invoke it. That's what the two manual triggers are for:
- Shortcut (manual from the inbox): an agent runs it on the conversation they're handling. The flow receives the conversation and the contact, so it can reply, assign, tag, create a task, and more. Great for "send payment details", "open a warranty ticket" or "escalate to support" in a single click.
- Manual (invoked by another workflow / API): it doesn't show up in the inbox; it runs from the editor's Test button, through the API, or when another workflow calls it with a Call workflow node. Think of it as a reusable sub-routine.
Requirements
- Available on all plans (from Lite), with a monthly quota of workflow runs based on your plan.
- For the shortcut, the agent needs Inbox access.
Create an inbox shortcut
- Go to Settings → Workflows and click Create workflow.
- Click Add trigger and pick Shortcut (manual from the inbox).
- Give the workflow a clear name (this is what agents will see), for example Send payment details.
- Add your action nodes. You can use context variables such as
{{$contact.name}}and{{$shortcut.triggered_by_name}}(who pressed the shortcut). - Activate the workflow.
- From the Inbox, open a conversation and run the shortcut: the flow runs against that contact instantly.
Create a reusable manual workflow
- Create a workflow with the Manual (invoked by another workflow) trigger.
- In the filters, define the expected input parameters (for example
order_id = number). - From another workflow, add a Call workflow node and pass it those parameters; you'll receive them in
{{$caller.input}}. - For a one-off test, use the Test button or call the workflow's API endpoint.
Verify it
After running the shortcut or hitting Test, open the workflow's Executions tab: you'll see the source (which user triggered it), the time, and the nodes that ran. In the inbox, the actions (message sent, assignment, tag) show up immediately on the conversation.
If it doesn't work
- The shortcut isn't in the inbox: confirm the trigger is Shortcut (manual from the inbox) and the workflow is Active.
- "Shortcut workflow not found or inactive": the flow is off or was deleted; activate it again.
- The manual workflow gets no data: check that the parameter names match between the Call workflow node and the input filter.
Tip: name shortcuts after the action they perform ("Send payment details", "Escalate to support"). That's the text your team sees when choosing one.
Tip: combine both: an inbox shortcut can call a reusable manual workflow so you don't duplicate the same logic across several flows.
Related articles
Related articles
-
Build your first workflow
Omnifox workflows automate your operation: a trigger starts the automation and action nodes do the work. Build a welcome message in minutes.
-
Workflow triggers catalog
Learn which events can start a workflow automatically in Omnifox.
-
Workflows complete guide
Workflows in depth, in 54 chapters: triggers, nodes, variables, testing, history, templates, import and export, with every setting explained and a real workflow end to end.
-
Action nodes available in workflows
Discover the actions a workflow can run automatically.
-
Conditions and branching (if/then) in a workflow
Make your flows take decisions and follow different paths based on each contact data.