Integrate Ziflow online proofing workflows into Slack to include real-time notifications in Slack for new proofs, comments, decisions, and more to keep your team up to date.

Available on: Pro Enterprise

Check out Integrating with Slack and Microsoft Teams for a guided walkthrough including building automated flows.

Slack integration can function effectively on both public and private channels within your Slack workspace.

Before setting up the integration between Ziflow and any third-party tool, you must connect Ziflow with the external application.

Log into Ziflow. From the main navigation pane, select the Connect tab.
Select Applications to open the applications list. Find the Slack application and select Connect.
In the Authorize app dialog box, review the information and actions Ziflow can view and take, and select Allow. Once you authenticate in Slack and authorize Ziflow to connect with Slack, you can set up automated actions between Ziflow and Slack.
Select the Slack tile again, choose the Settings tab, and select Show next to the Application fields on a proof to enable Slack fields at the proof level.

Re-authenticate or remove your app

To re-authenticate or remove your connection:

From the main navigation pane, select the Connect tab.
Select Applications to open the applications list.
Click the Slack application in the list to open the connection details and select the options menu (three dots).
Choose to Re-authenticate or Remove.

Removing the connection will disable any flows you have created with it.

Set up Slack automated flows

Once Ziflow and Slack are connected, you can set up automated flows to send information to Slack.

Before you begin, connect your Ziflow app. See Connect your Ziflow app.

Choose Connect and select Create Flow in the upper-right corner of the window.
Select Ziflow as the Application and choose which Event you want to start the integration. For more information, see Ziflow events.
Add a Slack Zibot action to continue.

Slack Zibot actions

After choosing a Ziflow event, choose a Slack Zibot action that will pass the information from the Ziflow event directly to Slack. Once your actions are set up, Ziflow will send or update data in your designated Slack account.

Search Slack channel

Create Slack channel

Send to Slack channel

Send to Slack user

Invite to Slack channel

Invite Ziflow app to private channel

Obtain Slack user by email

Search Slack channel

Use to search for a specific Slack channel (public or private). Other Zibots use the channel details for actions.

Field	Description
Search Slack channel query	Enter the exact name of the Slack channel. This field is case sensitive.

Create Slack channel

Use to add a new Slack channel.

Field	Description
Channel type	Choose public or private
Name	Enter a name for the channel. Channel names cannot contain spaces and most punctuation. Any unsupported characters are replaced with dashes.

Send to Slack channel

Use to send a message to a specific Slack channel (public or private). Slack Block Kit Builder lets you create rich, interactive UI for your messages.

Field	Description
Channel	Select by name: Enter a channel name Enter ID: Enter an ID, select from a previous Zibot, or enter `APPLICATIONS.[SLACK].[SLACK CHANNEL].[SLACK CHANNEL]` to use the Slack channel chosen during proof creation.
Specify the type of layout you want to use	Choose a simple text message using tokens or use Attachment and Blocks layout using Block Kit Builder.
Text	Enter your message.

Example of the blocks layout body to use for a Slack message:

[
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Hello! New proof #{$.proof.name}# has been published in Ziflow."
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "View the proof by clicking on the Open Proof button down below."
}
},
{
"type": "divider"
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Please be aware that you may be asked to sign in to Ziflow before accessing the proof."
},
"accessory": {
"type": "button",
"text": {
"type": "plain_text",
"text": "Open Proof",
"emoji": true
},
"value": "click_me_123",
"url": "#{$.proof.public_link}#",
"action_id": "button-action"
}
}
]

Send to Slack user

Use to send a message to a specific user. Slack Block Kit Builder lets you create rich, interactive UI for your messages.

Field	Description
User	Select by name: Enter a user name Enter ID: Enter an ID manually.
Specify the type of layout you want to use	Choose a simple text message or use Attachment and Blocks layout using Block Kit Builder.
Text	Enter your message.

Invite to Slack channel

Use to invite a specific user to a Slack channel (public or private).

Field

Description

Channel

Select by name: Enter a channel name

Enter ID: Enter an ID or select from a previous zibot.

Select a user

Select a user by name. Slack users are suggested when you begin typing.

Invite Ziflow app to private channel

Use as a one-time action to invite the Ziflow app to any private channel. This will let you use other Slack actions in a private channel in your Slack workspace.

Field

Description

Specify the channel to invite to

Select by name: Enter a channel name

Enter ID: Enter an ID or select from a previous zibot.

Channel

Enter the channel

Obtain Slack user by email

Use to retrieve a Slack user ID. It's useful for creating flows that can locate and message specific users.

Field	Description
Email	Enter the email address.

Add the Ziflow app to private Slack channels

If the Slack channel you wish to notify is private, you can use the Zibot or configure Slack to allow Ziflow to successfully send notifications.

Select your channel and choose Get channel details.
Select Integration and in Apps select Add an App.
Find Ziflow and select Add.

For additional help, see the Slack Help Center for details (Guide to apps in Slack and Add apps to your Slack workspace).

Connect Ziflow proofs with Slack channel

Once you've connected Slack to Ziflow, you can manually link proofs with the Slack channels from the Integrations tab while creating proofs or editing proof details.

If you do not see Slack in the Integrations tab, enable it in the application settings. Go to the Connect tab, select the Slack application, choose the Settings tab, and select Show next to the Application fields on a proof to enable Slack fields at the proof level.

To connect proofs manually with Slack during the proof configuration, open an integrations tab and select the Slack channel details.

To set up a flow to create a Slack channel when you create a new proof, see Slack flow examples.

Ziflow permissions on Slack

On behalf of the app, Ziflow can:

Manage public channels that "Ziflow" has been added to and create new ones
View basic information about public channels in a workspace
Send messages as @ziflow
Upload, edit, and delete files as "Ziflow"
View basic information about private channels that "Ziflow" has been added to
Manage private channels that "Ziflow" has been added to and create new ones
Start direct messages with people
View basic information about group direct messages that "Ziflow" has been added to
Start group direct messages with people
View people in a workspace
View email addresses of people in a workspace
Send messages to channels @ziflow isn't a member of
View basic information about direct messages that "Ziflow" has been added to
View the name, email domain, and icon for workspaces "Ziflow" is connected to

Our Privacy Policy explains how Ziflow gathers, uses, discloses, and manages a customer's data.

Follow the instructions on how to:
Please note that before setting up the integration between Ziflow and any third-party tool, it is necessary to connect Ziflow with the external application first. The process of connecting Ziflow to external applications can be found below.

How to connect with Slack

To integrate Slack with Ziflow, open the Connect tab in the Ziflow account and then click on the Applications tab on the left. Once inside the Applications menu, click the Connect Application button and select Slack from the list.

Once you authenticate in Slack and authorize Ziflow to connect with the Slack account, you can start setting up automated actions between Ziflow and Slack.

Slack integration can function effectively on both public and private channels within your Slack workspace.

In order to integrate Ziflow with Slack's private channels, you need to add the Ziflow app to the channels you want to use.

Set up Ziflow automated flows for Slack integration

Once Ziflow and Slack are connected, you can begin setting up automated flows to send information to Slack. Start by going to the Connect tab and clicking on the Create Flow button in the upper right corner of the screen.

Select Ziflow as the Application and choose which Event (new proof/version, decision made, new comment/reply, comment resolved, comment labeled) you want to trigger the integration.

You will be presented with the event details page, which will vary depending on your selected event. There are nine different types of events:
New proof/version
1. Triggered by - select the type of request that will trigger the Zibot.
2. Created in - select the Ziflow folder that this flow will monitor.
3. Created by - select the user responsible for this flow activation.
Proof updated
1. Triggered by - select the type of request that will trigger the Zibot.
2. Modified in - select the Ziflow folder that this flow will monitor
Decision made
1. Triggered by decision made - select what level decision needs to be made to activate the flow.
2. Type of decision - choose the type of decision that needs to be made to activate the flow.
3. Created in - select the Ziflow folder that this flow will monitor.
New comment/reply
1. Triggered by new comment / new reply - choose which option should activate the flow.
2. Made by - choose if a Zibot should be activated by a specific reviewer or by anyone that adds a comment/reply.
3. Created in - select the Ziflow folder that this flow will monitor.
Comment resolved
1. Created in - select the Ziflow folder that this flow will monitor.
Comment labeled
1. Comment is labelled as - select which label(s) should trigger a Zibot.
2. Created in - select the Ziflow folder that this flow will monitor.
Stage updated
1. Triggered by - select which type of the stage updated event should trigger the Zibot. There are three types of stage update events: reviewer added, reviewer removed, stage locked, and deadline changed.
2. Modified in - choose the Ziflow folder that this flow will monitor.
Stage started
1. Triggered by - select which type of the stage updated event should trigger the Zibot.
2. Modified in - choose the Ziflow folder that this flow will monitor.
Comment reaction
1. Triggered by - choose if you want to trigger a flow based on reactions added to comments or replies.
2. Comment reacted with - select what type of reaction should trigger a flow.
3. Created in - select the Ziflow folder that is going to be monitored by this flow.
Set up Ziflow Zibot for Slack action

After saving the event flow triggers, choose a Slack Zibot action that will pass the information set in the previous step directly to Slack:

Use following Zibots
1. Search Slack channel - with this, Zibot users can search through the Slack channels (public or private) for relevant data:
2. Create Slack channel - adds a new Slack channel (public or private):
3. Send to Slack channel - allows sending a message to a chosen Slack channel (public or private). Start sending messages using various types of layouts. Slack Block Kit Builder lets you create rich, interactive UI for your messages.
  
  Example of the blocks layout body you may use for your Slack message:
```
[
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Hello! New proof #{$.proof.name}# has been published in Ziflow."
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "View the proof by clicking on the Open Proof button down below."
}
},
{
"type": "divider"
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Please be aware that you may be asked to sign in to Ziflow before accessing the proof."
},
"accessory": {
"type": "button",
"text": {
"type": "plain_text",
"text": "Open Proof",
"emoji": true
},
"value": "click_me_123",
"url": "#{$.proof.public_link}#",
"action_id": "button-action"
}
}
]
```
4. Send to Slack user - allows sending a message to the specific Slack user. Start sending messages using various types of layouts. Slack Block Kit Builder lets you create rich, interactive UI for your messages.
5. Invite to Slack channel - with this Zibot, you can automatically invite a specific user to a Slack channel (public or private).
6. Obtain Slack user by email - this Zibot can be used to retrieve a Slack user ID. It's useful for creating flows that can locate and message specific users.
And, you're done! Ziflow will now send or update data in your designated Slack

account.

Set up Ziflow Webhook for Slack connection

After saving the event flow triggers, choose Webhook Zibot action:

Under Create, select POST. Under URL, copy the Webhook URL for your Workspace in Slack (NOTE: if you don't have a Webhook URL for your Workspace in Slack, you may need to create a Slack app and an Incoming Webhook). You can use your request body or copy/paste one of our examples below.
1. Create - select the type of request.
2. URL (required) - enter the application URL where you will send the data.
3. Query String Parameters - add which parameters you want to send.
4. Request body - you can use example requests posted below or create your own using JSON format (you can also use Slack formatting tool for testing how your message will look directly in-app).
5. Headers - enter the header values for each request.
For a New Proof Notification:
```
{
  "attachments": [
    {
      "fallback": "Hi, there is one new proof to review.",
      "color": "#1A18AB",
      "pretext": "Hi, there is one new proof to review.",
      "author_name": "{$.proof.owner.first_name} {$.proof.owner.last_name}",
      "title": "{$.proof.name}",
      "title_link": "{$.proof.public_link}",
      "thumb_url": "{$.proof.thumbnail_link}"
    }
  ]
}
```
For a New Comment or Reply:
```
{
  "attachments": [
    {
      "fallback": "Hi, a new comment has been made.",
      "color": "#dc9d3e",
      "pretext": "Hi, a new comment has been made.",
      "author_name": "{$.comment.reviewer.email}",
      "title": "{$.proof.name}",
      "title_link": "{$.proof.public_link}",
      "thumb_url": "{$.proof.thumbnail_link}",
      "text": "{$.comment.comment}"
    }
  ]
}
```
For a Decision Made Notification:
```
{
  "attachments": [
    {
      "fallback": "Hi, a new decision has been made.",
      "color": "#2092e3",
      "pretext": "Hi, a new decision has been made.",
      "author_name": "{$.reviewer.email}",
      "title": "{$.proof.name}",
      "title_link": "{$.proof.public_link}",
      "thumb_url": "{$.proof.thumbnail_link}",
      "text": "{$.reviewer.decision_status}"
    }
  ]
}
```
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.

And you're done! Ziflow will now send or update data in your designated Slack

account.

Ziflow flow examples for Slack
1. Send information about failed proofs
2. Send Ziflow notifications to Slack whenever someone uses @mention in Ziflow
Send information about failed proofs.

1. Select the needed event trigger. In this case, it will be a New Proof/Version event with Failed status. This event will trigger once the new proof is created, but it has failed for some reason:

2. Choose to Create a Slack channel from the Zibot list:

3. Fill out all necessary data in the Zibot configuration. In my example, I want to create a new Slack channel called failed-proofs.

4. Add another Zibot (Search Slack channel) to obtain a recently created channel ID.

5. Set up a third Zibot to Send a message to Slack Channel about failed proof being uploaded in your Ziflow.

6. Create a proof using a password-protected file and test if you receive a message about failed proof in your Slack.

Send Ziflow notifications to Slack whenever someone uses @mention in Ziflow
1. Select the needed event trigger. In this case, it will be a New Comment/Reply event. This event will trigger once a new comment or reply is added to the review.
2. Click next and select a path action from the Zibot list.
3. For the path details, please fill out the Rules as shown in the screenshot below:
4. Click next and select the Obtain Slack User by email Zibot.
5. Fill out the email field at the Zibot configuration with the following expression:
```
#{$.proof.stages.members[id=$match($$.comment.comment, /\$\{reviewer:([a-f0-9-]+)\}/)[0].groups[0]].email}#
```
6. Add another Zibot to the flow, which will be the Send to Slack user action.
7. Now, enter the user ID collected from the previous action to the User ID field. For the text message, I included some tokens so the user can see some details related to the mention.
8. Test if the flow works by using @mention on someone from your Slack workspace and see if they were notified about that fact in the Slack app.
  
  Here's how the notification will look like inside the Slack application:
Adding Ziflow App to your Slack channels

In order to allow Ziflow to send messages to your private channels, you need to invite the Ziflow app first. To ensure uninterrupted automation between Ziflow and Slack, it is important to make sure that the Ziflow app is added to your private channels.

Adding the Ziflow app to Slack channels is quick and straightforward, but if you need any help with that, please check the Slack Help Center for more details (Guide to apps in Slack & Add apps to your Slack workspace).

Supporting Material:
- API Reference Page
- The Ziflow-Slack Webhook Integration requires you to create an Incoming Webhook and a Slack app.
- When connecting with Webhooks, you can test your request body using the Slack message formatting tool.
- Please also take a look at our Privacy Policy, which discloses how Ziflow gathers, uses, discloses, and manages a customer's data.