|
This article covers the following: |
Overview
You can build a workflow in four steps: create it, configure what triggers it, add one or more Agent nodes to perform tasks, and define what happens once it ends. These four steps apply to every workflow. Beyond them, you can optionally add Logic nodes to branch, route, or run agent tasks in parallel. Each step corresponds to one of the building blocks of Wandz workflows. To build a complete workflow, you must configure each of these on the Workflows canvas.
You can build a workflow to run its agent tasks either sequentially or parallely. A sequential workflow runs one Agent node after another, where each task waits for the previous one to complete. A parallel workflow, in contrast, runs more than one Agent task at the same time, then brings the results back together before the workflow continues.
For example, a sequential workflow could summarize a paused A/B test and email the result, one step naturally following the next. A parallel workflow could analyze a heatmap and review session recordings for the same campaign at the same time, then combine both findings into a single report. This allows independent tasks to run without waiting for one another.
Build a Sequential Workflow
Step 1: Create a Workflow
To create a new workflow from the Workflows dashboard:
- Log in to your Wingify account.
- From the left navigation panel, go to Wandz > Workflows. This opens the Workflows dashboard, which displays a workflow template gallery and your existing workflows list (if there are any).
-
From the dashboard, choose a starting point for the workflow:
-
Use a template:
Click a listed template, for example, Automated Campaign Debrief or Conversion Drop Alert, to open the workflow canvas pre-filled with a Start node, Agent node, and End node already connected for that use case. Choose this when your automation is close to a common pattern. You can then edit the pre-filled nodes instead of building the flow from scratch.
Click See All to browse the full set of available templates, or use the Search and Add filter options on the dashboard to find one that matches what you need.Tip: Starting from a template that closely matches your requirement is usually faster than building a workflow from scratch. You can rename, reconfigure, or extend any template's nodes once it opens on the canvas. -
Start from scratch:
Use this option or click Create, to open a blank canvas with a Start node and an End node already placed on it. Choose this when your automation doesn't match an existing template, or when you want to configure every node yourself from the start.
-
Once the Workflow canvas opens, the Wandz Workflow Assistant panel sits on the left, the node palette sits next to it, and a Workflow settings panel opens on the right, where you can edit the workflow's Name and add a Description.
Step 2: Define the Start Trigger
The Start node determines when the workflow runs or initiates. Click the Start node on the canvas to select it, then choose a Trigger Type in the right panel. You can choose from two available options:
- Select Time Based to run the workflow on a recurring schedule, then set Schedule to Daily, Weekly, or Monthly.
-
Select Condition Based to run the workflow when a campaign matches conditions you set, then configure the following:
- Campaign Type
- Campaign Event
- Campaigns
For details on how each trigger type works and what its fields control, see the Start Node section in Components of a Workflow.
Step 3: Add Agent Nodes
An Agent node runs a Wandz agent to perform one task in the workflow, such as analyzing a heatmap or generating a PDF. To add an agent node:
-
Drag an Agent node from the Wandz section of the node palette and drop it onto the canvas.
Note: There is no limit to the number of Agent nodes you can add to a workflow. - Connect it to the Start node, or to the output of another node already on the canvas. To delete the connection between two nodes, click on the connecting wire and press the Delete key on the keyboard.
- While the Agent node is selected, from the node settings panel on the right, choose whether to use an existing agent or create a new one.
-
To use an existing agent:
- Select an agent from the Select an agent dropdown.
- Optionally, add context in the Additional Instruction field to guide this specific run without changing the agent's own configuration. For example, if the agent's goal is to analyze campaign performance, adding focus on the mobile segment only narrows this one run. For more information, see Agent Node.
-
Review the Agent Details shown below the dropdown. Click Edit Agent to update:
- Name
- Goal
-
Prompt
Based on the Goal and Prompt you provide, Wandz automatically determines and uses the appropriate tools to execute the task.
-
To create a new agent:
- Click Create New Agent to define a new agent directly within the node.
- Configure the new agent's Name, Goal, and Prompt.
- Click Create.
- Review and edit the agent’s details.
- Click Save.
Step 4: Configure the Workflow's End Action
The End node determines what happens when the workflow ends. To configure the end action:
- Click the End node on the canvas to select it.
-
In the right panel, set Output Type to:
- Do Nothing to end the workflow without any further action, or
- Notify to send an email when the workflow ends
- If you select Notify, select the Email checkbox under Notify me on, then add recipient email addresses. Add each address on its own line, or separate multiple addresses with commas. Each recipient appears as a removable chip above the field.
- Select Generate AI email summary to have Wandz summarize the workflow's results, including PDF reports, in the notification email. Leave it unchecked to send the raw output instead.
- If you selected Generate AI email summary, optionally edit the AI summary instructions field to change what the summary covers. You can also change how it is structured, or click Reset to default to restore the original template.
For example, set Output Type to Notify with your own email address to get a summary every time the workflow completes, or leave it at Do Nothing for a workflow that only needs to update data in the background without alerting anyone.
Note:
- When an End node's Output Type is set to Notify, Wingify emails a notification to the recipients once the workflow ends. If Generate AI email summary is selected, the email contains an AI-written summary of the run, and a PDF report where applicable. Otherwise it contains the report's raw output, truncated if it exceeds the email's size limit.
- Wandz workflow notifications are always sent by email.
Step 5: Save, Test, and Publish the Workflow
Once all nodes are configured, save your changes, verify that the workflow behaves as expected, and then activate it. Complete the following steps:
-
Click Save to save your changes without activating the workflow.
Note: Before clicking Save, confirm every node you've added is connected to the workflow, from the Start node through to the End node, with no isolated or dangling nodes left on the canvas. -
Click Test on the top-right to run the workflow once. The test run is independent of its normal trigger, so you can confirm each Agent node produces the expected output before it runs automatically.
Note: The Test button appears only after you have saved the workflow changes. - If the workflow uses a Condition Based trigger, the Run Workflow dialog opens, since the workflow needs a specific campaign to run its test against. Select a Campaign Type and a Campaign, then click Test in the dialog to start the run.
-
The Previous run history panel opens, showing the run you just started at the top of the list.
- A spinner means the run is still executing.
- A green checkmark means the run completed successfully.
- A red cross means the run failed.
- After the run completes, click View Details on that entry to review what each node produced.
- Review the test results, and if they look correct, switch on the Publish toggle to activate the workflow. The workflow now runs automatically according to its Start trigger.
After you save the workflow, it switches from edit mode to a read-only view. In this view, the Edit and Test options appear in place of Save. You can return to edit mode by clicking Edit whenever you need to make further changes.
Build Parallel Agent Workflows
The Build a Sequential Workflow section built a sequential workflow, where each Agent node waits for the one before it to complete. This section covers the parallel pattern instead, using Duplicate and Merge nodes to run multiple Agent tasks from the same point in the workflow. For details on what these nodes do and how to configure their fields, see Duplicate Node and Merge Node in Components of a Workflow.
You can build a parallel agent workflow using the following steps.
Prerequisite:
Before branching a workflow, complete:
Once the workflow exists with its trigger and at least one Agent node, use the following steps to branch it into parallel paths:
Branch Node Output Using a Duplicate Node
A Duplicate node splits one node's output into two or more parallel branches, so you can run more than one Agent task from the same point in the workflow.
To add a Duplicate node wherever you want the workflow to split into multiple paths:
- Drag a Duplicate node from the Logic section of the palette onto the canvas.
- Connect it after the node whose output you want to branch, for example, the Start node or an Agent node.
- In the right panel, set Number of output nodes to the number of branches you need. The default is 2.
- Connect each of the Duplicate node's outputs to a separate node, such as an Agent node, so each branch performs its own task.
For example, to run a heatmap analysis and a session recording analysis in parallel, set Number of output nodes to 2, then connect one output to an Agent node configured for heatmap analysis and the other to an Agent node configured for session recording analysis.
Recombine Node Output Using a Merge Node
A Merge node combines the outputs of two or more parallel branches (created by a Duplicate node) back into a single output, so the workflow can continue as one path again.
To bring the parallel branches back into a single path before the workflow continues:
- Drag a Merge node from the Logic section of the palette onto the canvas. Place it after the parallel Agent nodes you want to combine.
- In the right panel, set Number of input nodes to match the number of branches feeding into it. The default is 2.
- Connect the output of each parallel Agent node into one of the Merge node's inputs.
- Connect the Merge node's single output
onwardto the next node, such as another Agent node or the End node.
For example, after running a heatmap analysis and a session recording analysis in parallel, set Number of input nodes to 2. Connect both Agent nodes to the Merge node, then connect its output to an End node set to Notify, so a single email summarizes both results.
Once you've connected the parallel branches to an End node, complete Step 4: Configure the Workflow's End Action and Step 5: Save, Test, and Publish the Workflow to activate the workflow.
See Manage Wandz Workflows for information on how to find a published workflow in the list, edit it, and review its run history to confirm each node completed as expected.
Troubleshooting
| Issue | Possible Cause | Recommended Solution |
|---|---|---|
| Agent node produces no useful output. | The agent's Goal doesn't clearly describe the task the workflow needs it to perform. | Edit the agent details and refine the Goal to describe the task more precisely, for example specifying 'analyze heatmap data' rather than a vague goal like "analyze the campaign." |
| A Condition Based trigger never fires. | No campaign matches the selected Campaign Type and Campaign Event. | Confirm the target campaign's type and status match the trigger configuration. |
| A Merge node's output looks incomplete. | Not every branch from the connected Duplicate node has finished running. | Wait for all parallel Agent nodes to complete, or check the history log for a stalled node. |
FAQs
-
Do I need a Merge node after every Duplicate node?
Not necessarily, but a Merge node is how you bring parallel branches back into a single path. Without one, each branch continues independently to its own End node or downstream node
-
Why does my workflow show as Paused?
A workflow shows as Paused whenever its Publish toggle is switched off. Switch the Publish toggle on to let the workflow run according to its trigger.
-
Is it mandatory to test a workflow before publishing it?
Testing is not mandatory, but running a test lets you confirm every Agent node produces the expected output before the workflow runs automatically on real triggers.
-
Can I add more Agent nodes to a workflow after publishing it?
Yes. Toggle Publish off first to make editing available, then click Edit to reopen the canvas. Add or change nodes, and click Save. Toggle Publish back on when you're done to reactivate the workflow.
Need more help?
For more information or further assistance, contact Wingify Support.