Skip to main content

Slack Integration

Abstract

Get your Paligo notifications in Slack with the Paligo-Slack integration. With this feature, you can set Paligo to send the activity feed notifications to a Slack channel of your choice, as well as direct messages from the Paligo app.

If your team uses Slack for communications, it can be really useful to have Paligo's notifications appear there too. Then all your notifications and messages are in one place. With Paligo's Slack integration, you can set Paligo to:

  • Choose how often you receive Slack notifications.

  • Send activity feed notifications to a channel of your choice in a Slack workspace.

  • Send personal notifications to each user. These appear as messages sent from the Paligo app.

paligo-plus-slack.png

To set up Paligo to send notifications to Slack, you need:

  • A Paligo user account that has Administrator permissions.

  • A Slack user account that uses the same email address as your Paligo user account. The Slack user account needs to have permissions to install applications on the Slack workspace.

  • A Slack workspace with users that also have user accounts in Paligo. Again, the email address of each Slack user should match their email address for their Paligo user account.

When you are sure you have these in place, you can Connect Paligo to Slack. This involves installing the Paligo application in your Slack workspace.

To set up the Paligo to Slack integration, install the Paligo application in Slack.

  1. Preparation for Slack Integration.

  2. Log in to Paligo via a user account that has administrator permissions.

  3. Select the avatar in the top-right corner. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  4. Select Settings from the menu. Cog icon.

  5. Select the Integrations tab. Jigsaw piece icon.

    Paligo settings. The Integrations tab is highlighted.
  6. Find the Slack section and select Add.

    Note

    If Paligo has already been set up to connect to a workspace, you will only see a Change option, see Connect Paligo to a Different Slack Workspace.

  7. Select Add Paligo app to Slack.

    Slack integrations dialog. There is a button for adding the Paligo app to Slack, a checkbox for sending activity feed notifications to a Slack channel, and a field for Channel Name.

    The Paligo to Slack connection page appears.

    Paligo to Slack requesting connection page.

    Note

    Paligo detects the Slack workspaces that are available to you automatically (based on the email address of your Paligo user account). If you are a member of several workspaces, you can use the button in the top-right corner to choose which Slack workspace Paligo will connect to.

    An arrow pointing to a square icon with rounded corners. Next to the icon is the name of a workspace, in this case, Acme products.
  8. Select Allow.

  9. In Slack, select Apps (in the top section).

  10. Select the Paligo app from the Apps list.

    The Paligo app icon has the Paligo logo and the message "Get Paligo notification updates in Slack!"
  11. Paligo is added to the Apps section in the sidebar.

    Slack sidebar shown in close up. Apps is expanded to show a Paligo entry.

    You have now installed the Paligo app on the Slack workspace. Next, you can use Paligo to recieve Slack Activity Feed Notifications and also what Slack Personal Notifications to receive.

    Each different Paligo user will need to set Slack Personal Notifications, and they can do this in My Settings. They do not need to install the Paligo app on the Slack workspace, as you have already done that.

Paligo can send activity feed notifications to Slack. These are the same activity feed notifications you can see on the dashboard in Paligo, and they include many types of "system events", including:

  • Document created

  • Document title changed

  • Assignment started

  • Release status changed

  • Snapshot created.

By default, activity feed notifications are sent to the #general channel in Slack. But you can use the Paligo Slack integration settings to choose a different channel if you prefer. You can also use the integration's filter settings to choose which activity feed notifications Paligo will send to Slack.

Tip

Activity feed notifications are not the only messages Paligo can send to Slack. There are also Slack Personal Notifications, such as messages to tell you that you have been mentioned in a review comment. These personal notifications appear in Apps > Paligo in Slack, and you can set them up in your Paligo profile.

Note

You can only change the Slack activity feed settings if you are logged in to Paligo as an administrator. You should also read the Preparation for Slack Integration.

  1. Log in to Paligo via a user account that has administrator permissions.

  2. Select the avatar in the top-right corner. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  3. Select Settings from the menu. Cog icon.

  4. Select the Integrations tab. Jigsaw piece icon.

    Paligo settings. The Integrations tab is highlighted.
  5. Find the Slack settings and select Change.

    The Slack integration box on the Paligo integrations page. It has a single button labelled Change.
  6. Check the Send Activity Feed notifications to a Slack channel box and enter the Channel name. For example, here we have used a channel called #documentation.

    Paligo's integration settings for Slack. There is a button to reinstall the Slack application. Below that, an Activity Feed section with a Send Activity Feed notifications to Slack channel checkbox. Below that, there is a Channel name field and two filter settings - one for filtering by user name, one for filtering the type of events. There is also a save button, cancel button, a test settings button and a reset settings button.

    Note

    The Channel name has to match the name of a channel in your Slack workspace.

  7. Use the Filters to choose which activity feed notifications Paligo will send. There are two settings - one for choosing the users you are interested in, and one for choosing the types of events. Check the boxes for the users and events that you want to get notifications for in Slack.

    Paligo's Slack integration settings. A callout arrow points to the two combo boxes that you can use to filter the notifications. The left one is for filtering the notifications by user. The right one is for filtering notifications by event. The event options are shown and each option has a checkbox. Paligo will send a notification for those users or events that are checked.

    If you do not want to receive Slack notifications about particular users or events, clear their checkboxes.

  8. Select Save.

  9. In Paligo, do something that will cause an activity feed notification. For example, create a new publication or rename a topic. Then, in Slack, look at the channel that you have set up to receive the Paligo notifications. You should see the notification message appears (there can be a delay, depending on server connections etc., but the notification usually arrives almost instantly).

    Slack showing an activity feed notification from Paligo. It is shown in a #documentation channel.

    Note

    If the notification does not arrive, make sure that:

    • You have entered the channel name correctly

    • The filters actually allow that notification to be sent to Slack

    • You performed an action that will get logged in the activity feed in Paligo.

Paligo can send "personal" notifications to you in Slack. These are notifications that are relevant to you, but not all users, and they appear as direct messages from the Paligo app. You can see them in Apps > Paligo in Slack.

Slack sidebar shown in close up. Apps is expanded to show a Paligo entry.

The types of message that are shown as "personal" notifications are:

  • @ mentions of your Paligo user name in reviews

  • Reply comments in topics that you have followed

  • Someone has shared a document with you

  • Production notifications, including when a publication is ready for download or has failed.

  • Assignment status changes, such as assignment started, assignment approved, assignment canceled, and assignment ended.

Tip

Paligo can also send activity feed notifications to Slack. These Slack Activity Feed Notifications are the same as those that appear in the activity feed on the Paligo dashboard, and they are sent to a specific Slack channel.

To use "personal" notifications in Slack:

  1. Connect Paligo to Slack, so that Paligo can connect to your Slack workspace successfully. Also, make sure that the email address you use for the Slack workspace is the same as the email address you use for your Paligo user account.

  2. Select the avatar in the top right corner. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  3. Select My Profile. My_Profile.jpg

    danni-profile-login.jpg
  4. Select the Notifications tab.

    Notifications_My_Profile.png

    Note

    You have to "follow" notifications to receive information when changes are made by other users. There will be no notifications if you make changes yourself.

  5. Use the Notifications tab to choose which "personal" notifications you want to receive on Slack. For more information, see My Profile.

  6. Select Save.

  7. Test the notifications work by doing something that will cause Paligo to create a "personal" notification.

    For example, if you have chosen to receive slack notifications when someone shares a document, ask another Paligo user to share a publication with you.

    When they share the publication, look at Apps > Paligo in Slack. You should see a notification that is personal to you. Other users in your Slack workspace will not see the notification in their Apps > Paligo notifications.

    Slack interface showing a direct message that has been received from Paligo.

You can change the settings in Paligo so that it:

  • Sends activity feed notifications to a different channel

  • Sends activity feed notifications for different users or events

To make these changes:

  1. Preparation for Slack Integration.

  2. Select the avatar in the top-right corner. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  3. Select Settings from the menu. Cog icon.

  4. Select the Integrations tab. Jigsaw piece icon.

    Paligo settings. The Integrations tab is highlighted.
  5. Find the Slack settings and select Change.

    The Slack integration box on the Paligo integrations page. It has a single button labelled Change.
  6. In the Channel name field, change the name of the channel.

  7. Use the Filters to choose which activity feed notifications Paligo will send. There are two settings - one for choosing the users you are interested in, and one for choosing the types of events. Check the boxes for the users and events that you want to get notifications for in Slack.

    Paligo's Slack integration settings. A callout arrow points to the two combo boxes that you can use to filter the notifications. The left one is for filtering the notifications by user. The right one is for filtering notifications by event. The event options are shown and each option has a checkbox. Paligo will send a notification for those users or events that are checked.

    If you do not want to receive Slack notifications about particular users or events, clear their checkboxes.

  8. Select Save.

  9. In Paligo, do something that will cause an activity feed notification. For example, create a new publication or rename a topic. Then, in Slack, look at the channel that you have set up to receive the Paligo notifications. You should see the notification message appears (there can be a delay, depending on server connections etc., but the notification usually arrives almost instantly).

    Slack showing an activity feed notification from Paligo. It is shown in a #documentation channel.

    Note

    If the notification does not arrive, make sure that:

    • You have entered the channel name correctly

    • The filters actually allow that notification to be sent to Slack

    • You performed an action that will get logged in the activity feed in Paligo.

If your Paligo instance is already connected to a Slack workspace and you want to connect it to a different one:

  1. Preparation for Slack Integration.

  2. Select your profile in the upper right corner to display a menu, and then select Settings. Then select the Integrations tab, find the Slack settings and select Change.

    The Slack integration box on the Paligo integrations page. It has a single button labelled Change.
  3. Select Reinstall application.

    The Paligo to Slack connection page appears.

  4. Use the button in the top-right corner to choose the workspace you want to connect Paligo to.

    An arrow pointing to a square icon with rounded corners. Next to the icon is the name of a workspace, in this case, Acme products.
  5. Select Allow.

  6. In Slack, select Apps (in the top section).

  7. Select the Paligo app from the Apps list.

    The Paligo app icon has the Paligo logo and the message "Get Paligo notification updates in Slack!"
  8. Paligo is added to the Apps section in the sidebar.

    Slack sidebar shown in close up. Apps is expanded to show a Paligo entry.

    You have now installed the Paligo app on the Slack workspace. Next, you can use Paligo to recieve Slack Activity Feed Notifications and also what Slack Personal Notifications to receive.

    Each different Paligo user will need to set Slack Personal Notifications, and they can do this in My Settings. They do not need to install the Paligo app on the Slack workspace, as you have already done that.