A Webhook Zibot let you send data to any external system that accepts HTTP requests. This allows you to integrate Ziflow with tools that don't have prebuilt Zibots or to push proofing data into your internal systems.

In Ziflow, a Webhook Zibot:

• Sends data about that event to another tool or service.

Add a Webhook Zibot when you need to:

• Send proof, comment, or decision data to an external app or system
• Trigger actions in custom tools or APIs
• Log Ziflow activity in external databases or dashboards

Example use cases:

• Log comments to an internal support system
• Send approval data to your company’s CRM
• Trigger a build or deployment pipeline when a proof is approved
   

Select your Ziflow event

Start by selecting which Ziflow event you want to trigger your flow.

1. Select Connect in Ziflow’s main navigation and select Create Flow.
2. Select Ziflow as your flow’s application source.
3. Enter a name for your flow (e.g., "Push Comments to Support System").
4. Select the event that will start the flow. See Ziflow events.
5. Configure the event-specific settings (folder, user, etc.).
6. Select Next.
7. From the list of available Zibots, select Webhook Zibot.
8. Select Next.

Configure a Webhook Zibot

A Webhook Zibot sends specific Ziflow data to another app or service in a format that it can read and use. 

To configure your webhook:

1. In the Create section, select the type of HTTP request:

• GET retrieves information.
• POST is commonly used to send new data.
• PUT and PATCH update existing information.
• DELETE removes data.

2. Enter the endpoint URL for the app or system receiving the information (e.g., your app’s webhook URL). This is where Ziflow will send your data. 

3. [optional] Enter query string parameters. These are extra bits of data added to the URL. Use them if the receiving system requires specific parameters in the URL (e.g., ?project=design123).

4. [POST, PUT, or PATCH] In the Request body section, define what Ziflow should send. Use JSON format, which is a standard way to structure data. 

To include Ziflow-specific data (like proof name or reviewer), use JSONata syntax with tokens inside the body.

Example:

{
 "proof_name": "#{$.proof.name}#",
 "decision": "#{$.decision.type}#",
 "reviewer": "#{$.decision.user}#"
}

Each #{$. ... }# is a placeholder for real data from Ziflow.
 

5. [optional] Enter headers. Headers are key-value pairs often used for authentication or to define the data format. 

6. Click Next, review your configuration, and select Save and Turn on to activate the flow.

JSONata examples and usage

All open text fields in Webhook settings support JSONata syntax, allowing you to insert data from:

• Proof name: #{$.proof.name}#
• Stage name: #{$.stage.name}#
• Reviewer email: #{$.reviewer.email}#
• Comment text: #{$.comment.text}#
• Intake form data: #{$.form.field_name}#
• Previous Zibots data: #{$.zibot[0].data.key}# (replace 0 with Zibot position in flow)

For more information, see Use JSONata to insert values.

More examples:

• Folder name: #{$.proof.folder.name}#
• Proof creator full name: #{$.proof.created_by.first_name}# #{$.proof.created_by.last_name}#
• First stage name: #{$.proof.stages[0].name}#

Tips for using Webhook Zibots

• Use a tool like Postman to test your webhook.
• Use Tokens and JSONata to dynamically insert Ziflow data.
• Refer to https://docs.jsonata.org/overview.html for more information on JSONata expressions.