Summary: Having the ability to keep your projects in sync as proofs progress through the review and approval workflow, or being able to create proofing tasks for reviewers in your PM tool is a valuable component that Ziflow offers. We are actively working on extending our Zibots and integrations platform.
Available for: Users with Admin privileges on Business & Enterprise editions.
Our Webhook Zibot allows you to trigger a flow when the following events occur on a proof:
New proof/version: triggers when a new proof is ready for review.
Decision: triggers when a decision is made by a reviewer or when a decision is updated on the stage and/or proof.
New comment/reply: triggers when a reviewer adds a comment/reply to the proof.
Comment resolved: triggers when a comment is marked as resolved.
Comment labeled: triggers when a reviewer labels a comment.
Proof updated: triggers when the proof folder, setting, or custom property changes.
Stage updated: triggers when a stage is started or when a reviewer is added/removed.
Comment reaction: triggers when a comment reaction is added on a comment/reply level.
Follow the instructions on how to:
Create Flow
Click on the Connect tab in the upper left corner of the screen, then click on the + Create flow button. Instead of connecting to cloud storage, select the Ziflow application.
Set up Flow Event settings
The first step is selecting the event that will trigger your Zibot:
Next, you will be presented with the event details page, which will vary depending on which event you select:
New proof/version
Triggered by - select the type of request that will trigger the Zibot.
Created in - select the Ziflow folder that this flow will monitor.
Created by - select the user that will be responsible for this flow activation.
Decision made
Triggered by decision made - select what level decision needs to be made to activate the flow.
Type of decision - choose the type of decision that needs to be made to activate the flow.
Created in - select the Ziflow folder that this flow will monitor.
New comment/reply added
Triggered by new comment / new reply - choose which option should activate the flow.
Made by - choose if a Zibot should be activated by a specific reviewer or by anyone that adds a comment/reply.
Created in - select the Ziflow folder that this flow will monitor.
Comment resolved
Created in - select the Ziflow folder that this flow will monitor.
Comment labeled
Comment is labeled as - select which label(s) should trigger a Zibot.
Created in - select the Ziflow folder that will be monitored by this flow.
Proof updated
Triggered by - select which type of the proof updated event should trigger the Zibot.
Modified in - choose the Ziflow folder that will be monitored by this flow.
Stage updated
Triggered by - select which type of the stage updated event should trigger the Zibot.
Modified in - choose the Ziflow folder that this flow will monitor.
Comment reaction
Triggered by - choose if you want to trigger a flow based on reactions added to comments or replies.
Comment reacted with - select what type of reaction should trigger a flow.
Created in - select the Ziflow folder that is going to be monitored by this flow.
Set up Zibot details
Decide what should be done with information from the selected event:
Webhook Zibot - will pass information from Ziflow to external apps/services.
Ziflow internal Zibots - can be used to perform automated changes on proofs in Ziflow.
Paths - execute different Zibots based on one or more conditions.
Webhook Zibot
Choose a Webhook Zibot if you want to send Ziflow metadata to some external service or app:
Configure Webhook with data that you want to pass over:
Create - select the type of request that you want to send to the 3rd party app. There are five different request types that you can choose from: GET, POST, PUT, PATCH, and DELETE.
URL (required) - enter the application URL where you will send the data.
Query String Parameters - add which parameters you want to send.
Request body - enter a payload of the body using JSON format.
Headers - enter the header values for each request.
Once you hit the Next button, Ziflow will confirm if the flow looks good. If there are no problems, name the flow and turn it on.
Ziflow internal Zibots
If you want to automate some of the actions inside Ziflow, you may find these Zibots very useful. They can help you automatically perform some changes on proofs. To enable these Zibots, you need to connect the Ziflow application to your account.
We have four different internal Zibots that could be used in various scenarios:
Each of them has a unique ability to perform needed changes on proofs.
Update proof custom property
With this Zibot, you can set/change a property that is assigned to a particular project.
Check multiple stages statuses
This Zibot lets you check the status of the proof stage and then perform the required action with that information. Here's an example of how such Zibot can automate work for you.
Start a stage
This Zibot can kick off stages starting with a particular name.
Add reviewer
Allows adding reviewer to the chosen stage. It also lets to select reviewer proof permissions & notification preferences.
Additional information:
Along with sending a simple Webhook call to your 3rd party app, you can also utilize Paths which allows executing different Zibots based on one or more conditions. Read more about paths in this article.
Notice that you can refer to the data from the proof or other Zibots in all input fields of the Webhook using JSONPath syntax. Please see our API reference page for more details and examples of our JSONPath syntax.