ÃÛ¶¹ÊÓƵ

DocumentationWorkfrontWorkfront Guide

Slack modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

In an ÃÛ¶¹ÊÓƵ Workfront Fusion scenario, you can automate workflows that use Slack, as well as connect it to multiple third-party applications and services.

If you need instructions on creating a scenario, see Create a scenario in ÃÛ¶¹ÊÓƵ Workfront Fusion.

For information about modules, see Modules in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Access requirements

You must have the following access to use the functionality in this article:

ÃÛ¶¹ÊÓƵ Workfront plan*
Pro or higher
ÃÛ¶¹ÊÓƵ Workfront license*
Plan, Work
ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime ÃÛ¶¹ÊÓƵ Workfront plan, your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses

Prerequisites

To use Slack modules, you must have a Slack account.

Slack API information

The Slack connector uses the following:

Base URL
{{ifempty(parameters.domain, 'https://slack.com/api/')}}
API tag
v4.0.15

Slack modules and their fields

When you configure Slack modules, Workfront Fusion displays the fields listed below. Along with these, additional Slack fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Messages

Watch Public Channel Messages

This trigger module starts the scenario when a new message is added to a public channel.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel Select the public channel you want to watch for new messages.
Limit Set the maximum number of messages Workfront Fusion will return during one execution cycle.
Watch Private Channel Messages

This trigger module starts the scenario when a new message is added to a private channel (group).

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel Select the private channel you want to watch for new messages.
Limit Set the maximum number of messages Workfront Fusion will return during one execution cycle.
Get a Private Channel Message

This action module retrieves the details of a message from a selected channel.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel ID

Enter (map) the Channel ID.

Note: The Channel ID can be retrieved using the List Channels module.
Message ID (Time stamp)

Enter or map the message time stamp of the message you want to retrieve information about.

Note: The time stamp can be retrieved using another module, such as the Watch Public Channel module.
Get a Public Channel Message

This action module returns a message with a given ID from a specified public channel…

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel ID

Enter or map the Channel ID.

Note: The Channel ID can be retrieved using the List Channels module.
Message ID (Time stamp)

Enter or map the message time stamp of the message you want to retrieve information about.

Note: The time stamp can be retrieved using another module, such as the Watch Public Channel module.
Create a Message

This action module creates a new message.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Enter a channel ID or name

Choose how you want to select the channel where you want to create a message.

  • Enter manually

    In the Channel ID or name field, enter or map the Channel ID or name of the channel where you want to post the message.

    Note: The Channel ID can be retrieved using the List Channels module.

  • Select from the list

    Select the type of channel, then select the channel.
Text

Enter the text content of the message you want to create.

Note: For detailed information about text formatting, see in the Slack documentation.
Blocks Blocks are reusable components that you can use to customize and organize your messages. For more information on blocks, see in the Slack documentation.
Thread message ID (time stamp) If the new message is a reply, enter the time stamp of the message you want to reply to. Do not enter the time stamp of a message that is already a reply.
Reply broadcast

Select Yes if both of the following apply:

  • The new message is a reply to another message

  • You want the new message to be visible to everyone in the channel
Link names

Enable this option to allow names and channels to use @username or #channel format.

For more information, see in the Slack documentation.
Parse message text

Enable this option to allow automatic parsing.

For more information, see in the Slack documentation.

Note: If you used Link names or Parse message text options in the original message, you should specify them when running the Update a Message module as well.
Use markdown Enable this option to allow Slack to use markdown in the text.
Unfurl primarily text-based content

Enable this option to allow unfurling of primarily text-based content.

For more information about unfurling in Slack, see in the Slack documentation.
Unfurl media content

Enable this option to allow unfurling of media content.

For more information about unfurling in Slack, see in the Slack documentation.
Update a Message

This action module allows you to edit an existing message.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Enter a channel ID or name

Choose how you want to select the message you want to .

  • Enter manually

    In the Channel ID or name field, enter or map the Channel ID or of the channel that contains the message, then enter the Time Stamp (Message ID) of the message. .

    Note: The Channel ID can be retrieved using the List Channels module.

  • Select from the list

    Select the type of channel, then select the channel, then select the message.
Text

Enter the new text content of the message you want to update.

For more information, see in the Slack documentation.
Blocks Blocks are reusable components that you can use to customize and organize your messages. For more information on blocks, see in the Slack documentation.
Link names

Enable this option to allow names and channels to use @username or #channel format.

For more information, see in the Slack documentation.
Parse message text

Enable this option to allow automatic parsing.

For more information, see in the Slack documentation.

Note: If you used Link names or Parse message text options in the original message, you should specify them when running the Update a Message module as well.
Delete a Message

This action module deletes a specified message.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel ID

Enter or map the Channel ID.

Note: The Channel ID can be retrieved using the List Channels module.
Message ID

Enter or map the time stamp of the message you want to delete.

Note: The time stamp can be retrieved using another module, such as the Watch Private Channel Module.

Channels

List Channels

This search module returns a list of all channels in a workspace.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Exclude archived Select Yes to exclude archived channels in results.
Type Select the type(s) of channels you want to retrieve.
Limit Set the maximum number of channels Workfront Fusion will return during one execution cycle.
Get a Channel

This action module returns information about a workspace channel.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel ID

Enter or map the ID of the channel that you want to retrieve information about.

Note: The Channel ID can be retrieved using the List Channels module.
List Members in Channel

This search module returns a list of users in the selected channel.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
Channel type Select the type of channel that contains the list of members you want to list.
Public / Private Channel Select the channel that you want to list members of.
Limit Set the maximum number of members Workfront Fusion will return during one execution cycle.

Other

Make an API Call

This action module lets you make a custom authenticated call to the Slack API. This way, you can create a data flow automation that can’t be accomplished by the other Slack modules.

Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in ÃÛ¶¹ÊÓƵ Workfront Fusion.

table 0-row-2 1-row-2 2-row-1 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
Connection For instructions about connecting your Slack account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓƵ Workfront Fusion - Basic instructions.
URL Enter a path relative to https://slack.com/api/. Example: /users/identity.
Method
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds the authorization headers for you.
Query String

Add the query for the API call in the form of a standard JSON object.

For example: {"name":"something-urgent"}
Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.
Base URL Select the base URL that you want to use for the API call.

Terminology

The following terminology may be useful when configuring Slack modules:

  • DM: Direct Message
  • IM: Instant Message
  • Private Channel: formerly Group
  • Direct Message: formerly IM
  • Channel: Conversation in the API documentation, channel in the Slack app.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43