Slack Native Connector for Acquia DAM

Slack Native Connector for Acquia DAM

The Slack Native Connector integrates Acquia DAM with Slack. This allows users to search, share, preview, create, and manage assets without the need to leave their Slack workspace. The connector also supports webhook-triggered workflows for automated Slack alerts.

This is a paid add-on. An administrator must request provisioning before users can access the connector.

Prerequisites

Before you can use the Slack Native Connector, the following conditions must be met:

• Your organization has an active Acquia DAM subscription.
• Your organization has purchased the Slack Native Connector add-on.
• The Acquia Native Integrations team has provisioned the connector for your DAM site.
• You have an active user account in Acquia DAM with appropriate permissions.
• Your Slack workspace administrator has authorized the connector.

Request the connector

To request the Slack Native Connector for your organization:

1. Contact your Acquia Account Manager (AM) or Customer Success Manager (CSM) to initiate the request.
2. Complete the customer requirements document provided by your AM or CSM. Include your Slack Enterprise ID (EXXXXXXXX) or your Slack Team/Workspace ID (TXXXXXXXX).
3. Submit the completed requirements document to Acquia.
4. Wait for confirmation from the Acquia Native Integrations team that provisioning is complete. This process may take up to one week.

Note: If you provide an Enterprise ID, you can use the connector across multiple workspaces under that enterprise.

Install the connector in your Slack workspace

After the Acquia Native Integrations team confirms that provisioning is complete, a Slack workspace administrator must authorize the connector.

1. Receive the authorization URL from your AM or CSM.
2. Open the URL in a web browser.
3. Review the requested permissions and select Allow to authorize the connector for your Slack workspace.
4. Depending on your organization's policies, the app may require approval by your Slack administrator before it can be used.

Search for assets

You can search for assets in Acquia DAM directly from the Slack app home screen. The search bar supports Acquia DAM Advanced Search syntax.

From the search results, you can:

• Preview assets.
• View asset metadata.
• Download assets (if you have the Download permission in DAM).
• Share assets to Slack conversations.

Share assets

When you share an Acquia DAM link in a Slack message, the connector generates a rich preview of the asset. This preview displays the asset thumbnail and basic information.

Click the preview to expand it. The expanded view displays metadata and provides the option to edit metadata or open the asset in DAM.

Link unfurling is available only for acquiadam.com and widencollective.com URLs. Vanity URLs do not unfurl.

Create assets

You can upload files from Slack to Acquia DAM. This feature requires that External File Sharing is enabled on your Slack workspace.

To create an asset from a Slack message:

1. Hover over a message that has an attached file.
2. Open the three-dot menu.
3. Select Connect to Apps.
4. Select Create Asset.
5. In the modal window, select the desired attachment, upload profile, and fill out any relevant metadata.
6. Submit the upload to DAM.

Manage webhooks

You can connect Acquia DAM asset events directly to Slack Workflows through webhooks. This feature requires that webhooks be enabled on your DAM and that you have the Administrate Webhooks permission. Contact your DAM administrator for assistance.

To search for the webhook management feature, type a slash command (/) and search for "Manage Webhooks," or use the Slack search bar.

Create a workflow triggered by an Acquia DAM webhook

1. In Slack, create a new workflow triggered by a webhook.
2. Set up your desired variables for your event using the fields listed in the following section.
3. Copy the Web Request URL from Slack.
4. Finish setting up your workflow and publish it.
5. In the Slack search bar, search for "Manage Webhooks." If prompted for a workspace, select the default and click Run Shortcut.
6. Click Add Webhook, paste the Web Request URL from Step 3 into the Delivery URL field, select your event, then click Create.

Your webhook is now active and your workflow receives events from DAM.

Supported webhook events and fields

All fields are type Text.

Asset Created:

• event_context_user_username
• event_context_user_id
• asset_id
• date_created

Asset Deleted:

• event_context_user_username
• event_context_user_id
• asset_id
• date_deleted

Asset Expiration Date Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Release Date Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Tags Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Version Added:

• event_context_user_username
• event_context_user_id
• asset_id
• asset_version_id
• version_number
• date_created

Workflow Deliverable Status Changed:

• deliverable_key
• old_status
• new_status

Workflow Project Created:

• project_id
• title

Permissions and security

• DAM user permissions and access levels govern which assets each Slack user can search for and act on.
• You can only view, download, or share assets that your DAM account has permission to access.
• Upload permissions are governed by your DAM role.

Limitations

• If you are on a Slack Enterprise plan, only one DAM and one Enterprise Grid may be connected. The connector may be added to or removed from any workspaces under the enterprise.
• If you are not on a Slack Enterprise plan, only one DAM and one workspace may be connected.
• Vanity URLs are not supported. Link unfurls are available only for acquiadam.com and widencollective.com URLs.
• Users must have an Acquia DAM account to use the connector features.
• Only the following webhook events are supported through the connector:
  • Asset Created
  • Asset Deleted
  • Asset Release Date Updated
  • Asset Expiration Date Updated
  • Asset Version Added
• If you need a custom workflow orchestration with Slack, contact your Acquia DAM representative about the Slack Native Integration.

Note: If you provide an Enterprise ID, you can use the connector across multiple workspaces under that enterprise.

Install the connector in your Slack workspace

After the Acquia Native Integrations team confirms that provisioning is complete, a Slack workspace administrator must authorize the connector.

1. Receive the authorization URL from your AM or CSM.
2. Open the URL in a web browser.
3. Review the requested permissions and select Allow to authorize the connector for your Slack workspace.
4. Depending on your organization's policies, the app may require approval by your Slack administrator before it can be used.

Search for assets

You can search for assets in Acquia DAM directly from the Slack app home screen. The search bar supports Acquia DAM Advanced Search syntax.

From the search results, you can:

• Preview assets.
• View asset metadata.
• Download assets (if you have the Download permission in DAM).
• Share assets to Slack conversations.

Share assets

When you share an Acquia DAM link in a Slack message, the connector generates a rich preview of the asset. This preview displays the asset thumbnail and basic information.

Click the preview to expand it. The expanded view displays metadata and provides the option to edit metadata or open the asset in DAM.

Link unfurling is available only for acquiadam.com and widencollective.com URLs. Vanity URLs do not unfurl.

Create assets

You can upload files from Slack to Acquia DAM. This feature requires that External File Sharing is enabled on your Slack workspace.

To create an asset from a Slack message:

1. Hover over a message that has an attached file.
2. Open the three-dot menu.
3. Select Connect to Apps.
4. Select Create Asset.
5. In the modal window, select the desired attachment, upload profile, and fill out any relevant metadata.
6. Submit the upload to DAM.

Manage webhooks

You can connect Acquia DAM asset events directly to Slack Workflows through webhooks. This feature requires that webhooks be enabled on your DAM and that you have the Administrate Webhooks permission. Contact your DAM administrator for assistance.

To search for the webhook management feature, type a slash command (/) and search for "Manage Webhooks," or use the Slack search bar.

Create a workflow triggered by an Acquia DAM webhook

1. In Slack, create a new workflow triggered by a webhook.
2. Set up your desired variables for your event using the fields listed in the following section.
3. Copy the Web Request URL from Slack.
4. Finish setting up your workflow and publish it.
5. In the Slack search bar, search for "Manage Webhooks." If prompted for a workspace, select the default and click Run Shortcut.
6. Click Add Webhook, paste the Web Request URL from Step 3 into the Delivery URL field, select your event, then click Create.

Your webhook is now active and your workflow receives events from DAM.

Supported webhook events and fields

All fields are type Text.

Asset Created:

• event_context_user_username
• event_context_user_id
• asset_id
• date_created

Asset Deleted:

• event_context_user_username
• event_context_user_id
• asset_id
• date_deleted

Asset Expiration Date Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Release Date Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Tags Updated:

• event_context_user_username
• event_context_user_id
• asset_id
• change_old_value
• change_new_value

Asset Version Added:

• event_context_user_username
• event_context_user_id
• asset_id
• asset_version_id
• version_number
• date_created

Workflow Deliverable Status Changed:

• deliverable_key
• old_status
• new_status

Workflow Project Created:

• project_id
• title

Permissions and security

• DAM user permissions and access levels govern which assets each Slack user can search for and act on.
• You can only view, download, or share assets that your DAM account has permission to access.
• Upload permissions are governed by your DAM role.

Limitations

• If you are on a Slack Enterprise plan, only one DAM and one Enterprise Grid may be connected. The connector may be added to or removed from any workspaces under the enterprise.
• If you are not on a Slack Enterprise plan, only one DAM and one workspace may be connected.
• Vanity URLs are not supported. Link unfurls are available only for acquiadam.com and widencollective.com URLs.
• Users must have an Acquia DAM account to use the connector features.
• Only the following webhook events are supported through the connector:
  • Asset Created
  • Asset Deleted
  • Asset Release Date Updated
  • Asset Expiration Date Updated
  • Asset Version Added
• If you need a custom workflow orchestration with Slack, contact your Acquia DAM representative about the Slack Native Integration.