Slack

Slack is a chat-based tool for messages and sharing files with your team. You can create channels, react to important effects, and easily stay in touch with your colleagues. Additionally, your Slack instance can be configured to address your team's specific needs or tech stack using the Slack API.

Slack is an especially powerful integration in Tonkean because Tonkean modules can leverage Slack channels to communicate with your team where they're already working. Users can answer forms directly in Slack or even use Slack to initiate workflows in Tonkean.

Authenticate with Slack

Tonkean integrates with Slack in two different ways, both of which must be connected independently: as a communication source or as a data source.

If you want to connect Slack to send messages and generally communicate with your process contributors, connect Slack as a communication source. Alternatively, if you want to extract and leverage fields from Slack in your module workflow, connect Slack as a data source.

Add Slack as a Communication Source

You can connect Slack as a communication source, a channel by which Tonkean can reach out to and communicate with process contributors (for example, using People Coordination actions).

To add Slack as a communication source, follow the steps below:

  1. Make sure you're logged into the Slack instance you want to connect to Tonkean.

  2. In Tonkean, select the main nav icon, grid.png, in the upper left and select Enterprise Components. The Enterprise Components screen displays.

  3. Select the Communication Sources tab. The Communication Sources screen displays.

    select_comm_sources_tab.png
  4. In the Slack section, select New Instance. A new window displays asking you to allow Tonkean to connect to your Slack workspace.

    comm_sources_new_slack_instance.png
  5. If you are logged into multiple Slack accounts, select the dropdown in the top right and select the Slack workspace you want to connect to Tonkean. When finished, select Allow.

    slack_allow_access_window.png

A success message displays in the upper right if Slack was successfully authenticated and connected to Tonkean. The connected Slack instance appears in the Slack section of the Communication Sources screen.

comm_sources_slack_instance.png

Additionally, Tonkean displays as a connected app in your Slack instance:

slack_tonkean_app.png

Add Slack as a Data Source

Slack can also be connected as a native data source. With this integration, you can monitor certain conversations and take action in response to specified commands.

To add Slack as a data source, you must first connect Slack as a communication source.

To add Slack as a data source, follow the steps below:

  1. Select the main nav icon, grid.png, in the upper left and select Enterprise Components. The Enterprise Components screen displays.

  2. Select + Add Data Source in the upper right.

    connect_data_sources_add_data_source.png
  3. Select Cloud Application. The Add New Data Source window displays.

    add_cloud_application.png

    If you select Chat (Slack/MS Teams), you are redirected to the Communication Sources screen where you can connect a chat application as a communication source.

  4. Enter "Slack" in the search field, then select Slack App. The New Slack Connection window displays.

    add_new_data_source_slack.png
  5. Select Create a new connection. A new window displays asking you to allow Tonkean to connect to your Slack workspace.

    new_slack_connection_create.png
  6. If you are logged into multiple Slack accounts, select the dropdown in the top right and select the Slack workspace you want to connect to Tonkean. When finished, select Allow. The Set Up Data Source window displays.

    slack_allow_access_window.png
  7. Select the channel or channels you want to monitor. Select the dropdown to choose from all available channels, filtering the list displayed in the dropdown by selecting either Public or Private channels.

    Select + Add Channel to monitor additional Slack channels.

    set_up_data_source_slack.png

    When finished, select OK.

Your Slack instance is connected to Tonkean as a data source. Be sure to provide the relevant solutions access to this data source.

Slack Permissions

When you connect a Slack instance to Tonkean, it's important to note that all of the permissions in Slack (that is, create, edit, read-only) are mirrored in Tonkean. A user is able to create or update in Tonkean anything they are able to create or update in Slack.

Considering these equivalent permissions, make sure that the account you connect has the authority to perform all the actions your process requires in Tonkean while also being careful not to give Tonkean more access to Salesforce than is necessary.

Monitor Slack as an Input Source

Like most data sources, you can use Slack as the module input source:

  1. After creating a new module, select the input source tile. The Configure Input Source panel displays.

  2. Select Slack from the available data sources.

    config_input_source_slack.png
  3. Select the Slack App items dropdown and select the entity to monitor. Slack App items include all available objects in Slack (for example, Channels, Messages, and Users). The filter section displays.

    config_input_source_slack_items.png
  4. Select whether to monitor all entities of the selected type or to create a custom filter to monitor only specific entities. Then, if you select to create a custom filter, configure the conditions for the filter.

    config_input_source_custom_filter.png

    When setting up a new input source, we recommend always adding a custom filter instead of monitoring all entities of the selected type. This ensures there's a smaller amount of data to monitor and respond to. For example, configuring the filter to monitor Messages with the Created Date in the past 7 Days is a good place to start.

  5. When finished, select Preview Items & Save.

Your module is monitoring Slack.

Use Slack as an Action

In addition to monitoring a Slack workspace, you can use actions to create a channel, invite users to a channel, and perform other actions in Slack based on triggers you create. To add a Slack action block, perform the following steps:

  1. On the module builder screen, add an action by selecting the plus icon, add_block.png, to the right of the Do arrow in your work flow. A new action block is created and the Action Block panel displays.

    add_action_block_select_plus_icon.png
  2. Scroll down to the Data Actions section and select the Slack App action. The Slack action panel displays.

    action_block_slack_app.png
  3. Configure the fields to perform any action relevant to your workflow.

    action_panel_slack_app.png

You're leveraging Slack as an integrated part of your module workflow.