Slack

Get started with the Slack source!

Create your OAuth app

If you need to figure out how to access the necessary credentials, head here for a detailed walk through.

Enable the Source

Let's first select the source from the list of taps in hotglue for this flow.

Enable the Slack sourceEnable the Slack source

Enable the Slack source

Now that we have selected Slack as a source, we are going to put in the OAuth Client ID and the OAuth Client Secret. If you don't know where to get these credentials, you can learn where to find them here.

Once you've entered your OAuth credentials, click the Save button.

Save Slack OAuth credentialsSave Slack OAuth credentials

Save Slack OAuth credentials

You will then be asked to connect your own testing Slack credentials. Go ahead and fill these in and click Save.

Connect a testing Slack accountConnect a testing Slack account

Connect a testing Slack account

And that's it! You have successfully enabled the Slack integration.

Configure Mapping

You now have added Slack as a data source for your flow. Next, you need to configure the mapping for your Slack data. Click on the field map button to get started.

Edit field map for SlackEdit field map for Slack

Edit field map for Slack

You can now select the data you want to pull from Slack. To edit the fields for an object you want to pull, use the corresponding gear icon.

🚧

Note

If you're using the messages stream, you must make sure that the Slack bot is inside the channels you wish to access! Failure to do so will cause no messages to come through. You can learn how to add your Slack bot to a channel below.

Edit object to pull from SlackEdit object to pull from Slack

Edit object to pull from Slack

You can now select specific fields identified in each object to map in the Field Editor. Once you have selected which fields you want, you click confirm.

Edit fields for object in SlackEdit fields for object in Slack

Edit fields for object in Slack

Once you are done mapping any of the fields you want, you click save, and you have finished configuring your mappings!

Save field mapSave field map

Save field map

Obtain your Slack OAuth credentials

The first thing that you need to do to get your Slack OAuth credentials is to head to the Slack API dashboard. If you do not have a Slack account, you will be prompted to create one.

Once you're on the Slack API dashboard, select create new app

Create a Slack appCreate a Slack app

Create a Slack app

In the popup, select Create from scratch

Choose from scratchChoose from scratch

Choose from scratch

Now give your app a name, and pick a Slack workspace to test with, then click Create App

Fill in App Name and workspace detailsFill in App Name and workspace details

Fill in App Name and workspace details

From the next screen, select OAuth & Permissions

Click OAuth & PermissionsClick OAuth & Permissions

Click OAuth & Permissions

On the OAuth & Permissions page, scroll down to the Redirect URLs section, and add https://hotglue.xyz/callback as a valid URL and click Save URLs

Configure redirect URLsConfigure redirect URLs

Configure redirect URLs

Now scroll down to the Scopes section. For hotglue to work, you must grant the following scopes:

  • channels:history
  • channels:join
  • channels:read
  • files:read
  • groups:read
  • links:read
  • reactions:read
  • remote_files:read
  • remote_files:write
  • team:read
  • usergroups:read
  • users.profile:read
  • users:read
  • users:read.email
Add scopes from list aboveAdd scopes from list above

Add scopes from list above

Finally, click on Basic Information in the top left.

Select Basic InformationSelect Basic Information

Select Basic Information

Now scroll down to the App Credentials section. Here you will be able to access the necessary client id and client secret.

Obtain your client id and client secretObtain your client id and client secret

Obtain your client id and client secret

You can now use these credentials in hotglue to configure your Slack integration!

Add your Slack bot to a channel

Once a user has authenticated via OAuth with your Slack app, your bot will be available in the apps list of their Slack workspace. But before the bot can read any messages, you must first add them in the channels you wish to get messages from.

Go to channel details in Slack and click on Integrations

Select Integrations tabSelect Integrations tab

Select Integrations tab

From here, click on Add an App, and select your app in the list

Add your app to Slack channelAdd your app to Slack channel

Add your app to Slack channel

That's it!


Did this page help you?