Pigment Slack Connector [Coming soon]

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

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.

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.

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.

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

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.