Pigment Slack Connector [Coming soon]

  • 28 August 2023
  • 0 replies

Userlevel 6
Badge +7
  • Community Manager
  • 292 replies

The Pigment Slack Connector allows all Members receive Pigment notifications directly within your Slack workspace. This integration enhances your workflow by consolidating notifications from Pigment into your Slack.


Table of Contents


To set up or edit the Slack connection, Members must have an Account type of Security Admin or Primary Owner. 

Depending on your Slack configuration, a Slack admin might need to approve the connection. 




How does the Pigment Slack connector work?


The Pigment Slack connector sends Pigment notifications directly to Members in Slack. After establishing a connection between Pigment and an individual Slack workspace, Members are mapped by their emails and new notifications reach you as direct messages through the Pigment app under the Apps section in Slack.


When a Member receives a notification in Slack, they will see the entire message displayed for them.  When clicking on the link in the notification, it will be the same behavior as if they opened the notification in the Notification center

For example, if the notification is from a conversation, the link will redirect you to the conversation in Pigment.


When a notification is accessed via Slack, that notification will not impact the number of unread notifications they have but will still show as unread.   

For example, if I have 0 notifications listed in the notification center and I receive a new notification. If I open it in Slack, I will not see a 1 next to my name in the notification center but when I open the notification center, it will still show as unread.


Supported Notification Types


The Pigment Slack Connection covers a range of notification types to keep you informed in real-time. These include:

  1. Conversation Notifications: Receive alerts when from comments, replies, and mentions
  2. Automation Notifications: Get notifications related to automated actions or triggers you've set up.
  3. Scheduled Imports: Be notified when scheduled imports are completed, ensuring you're always aware of the latest data updates.
  4. Asynchronous Tasks: Receive updates on tasks like snapshots or duplication of Applications.


Setting Up the Connection


Connecting Pigment to Slack is a straightforward process for Security Admins or workspace Primary Owners.  Depending on your Slack configuration, a Slack admin might need to approve the connection.


When setting up a connection to Slack, you can only select one Slack workspace to connect with Pigment. 


Connecting Pigment to a Slack workspace:

  1. Click on the settings icon located in the sidebar of your Pigment workspace.
  2. Under the Workspace Settings heading, find and click on Messaging Apps.
  3. Select the "Connector" option to start the integration.
  4. Carefully read and acknowledge any legal disclaimers provided.
  5. A Slack pop-up will appear.  If you have multiple workspaces use the dropdown in the top right, select the Slack workspace that you wish to connect to.
  6. Review the permissions required for the integration and select "Allow" to proceed.


If you do not see the slack pop-up page from step 5, please check for blocked pop-ups in your browsers settings. 


After establishing the connection, Pigment Members are automatically mapped in Slack based on their email. The connection will be considered live and all new notifications will appear in Slack.



Mapping Pigment Members to Slack 


When you first set up the integration, Pigment will automatically map Members based on their email addresses. This ensures that your Pigment and Slack profiles are linked accurately. Here's how it works:

  • Existing Members with matching email addresses in both systems will be automatically mapped.
  • New Members with matching email addresses will also be added to the mapping, but this might take up to 24 hours.


Manual Mapping by Security Admin:

  1. Security Admins can manually map Pigment Members who are not automatically connected.
  2. Navigate to the Messaging Apps section and click Review Members to see unmapped Members.
  3. Locate a Pigment member with a Not connected status and click Set up.
  4. Enter the Member’s email address from Slack in the Members email on Slack field.
  5. Click Update to establish the connection.



Editing or Removing Connections


If you need to edit or remove a connection between a Pigment Member and a Slack Member, hover your mouse over the selected Member then choose from these options:

  • To edit: Select "Edit connection" instead of the link icon and update the email address.
  • To remove a connection to an individual: Hover over the member's entry, click the link icon (it says "Remove Connection" when hovered over), and confirm the removal.


Managing Notification Settings


All notification settings are customizable on an individual basis. If a Member wants to adjust their own notification preferences, follow these steps:

  1. In the Pigment sidebar, locate the circle with your initials and click on it.
  2. Navigate to "Account Settings" and select "Notifications" under that section.
  3. Customize your notification options to match your preferences.


Disconnecting Pigment from Slack


Depending on your Slack configuration a Slack admin may be the only one who can perform this action.


This action is performed from within your slack Workspace's App directory. Here is one way to access it:.

  1. In the Slack sidebar in the apps section, locate the Pigment App and click on it.
  2. Navigate to the About tab and click on the “configuration” button. This will redirect you to your company’s app directory on the Pigment App
  3. Select Configure under that section..
  4. In the configuration tab, Scroll down to the Remove App section and click Remove app.


This will remove the connection for the entire workspace. Remember, Members can always turn off their own slack notifications via the notification settings.  




This topic has been closed for comments