Slack Actions integration

Back to list of integrations

Use the Slack integration to let agents send and manage messages, request approvals or actions, manage channels and files, and look up users through Action Tools.

Authentication	Actions	Workflow triggers
OAuth 2.0	26	13

​

Supported actions

Actions are Slack operations that an agent runs as Action Tools during a conversation. You can also run them from an Integration node in a workflow.

Group	Actions
Messaging	Send Message To A Channel, Send Message To A User, Update message, Delete Message, Add Reaction to Message, Markdown to Slack format
Human in the loop	Request Approval in a Channel, Request Approval from A User, Request Action in A Channel, Request Action from A User
Read and search	Get Message by Timestamp, Retrieve Thread Messages, Get channel history, Search messages
Channels	Create Channel, Set Channel Topic, Invite User to Channel
Files	Upload file, Get File
Users	Find User by Email, Find User by Handle, Find User by ID, List users, Update Profile, Set User Status
Advanced	Custom API Call

​

Workflow triggers

Triggers are Slack events that start a workflow automatically. Select them as app triggers when you configure a workflow.

Trigger	Fires when
New Public Message Posted Anywhere	A message is posted to any public channel.
New Message Posted to Channel	A message is posted to a channel you choose.
New Direct Message	A message is posted in a direct message.
New Mention in Channel	A user name is mentioned in a channel.
New Mention in Direct Message	A user name is mentioned in a direct message.
New Reaction	A reaction is added to a message.
Channel created	A channel is created.
New Command in Channel	A command is sent to the bot in a channel, for example @bot command arg1 arg2.
New Command in Direct Message	A command is sent to the bot in a direct message.
New User	A user is created or first joins the workspace.
New Saved Message	You save a message.
New Team Custom Emoji	A custom emoji is added to the workspace.
New Modal Interaction	A user interacts with a modal.

​

Set up the integration

1. Configure the Slack app

   Create a Slack app. On OAuth & Permissions, add the Artemis Callback URL to Redirect URLs and the scopes listed in the next step. Copy the Client ID and Client Secret from Basic Information. Invite the app to every channel the agent uses (/invite @<app name>).

2. Create the auth profile

   In Integrations, select Slack > Connect. On Project Auth Profiles, select New Profile > Integration Profile > Slack > Continue. Enter the Client ID and Client Secret, select Create Profile, and then select Authorize. Artemis pre-fills the Slack endpoints and scopes.

   Usage Mode: Preconfigured shares one authorization across users; JIT and Preflight ask each user to authorize, during or before the session. See Auth profiles.

   Pre-filled scopes

   channels:read, channels:manage, channels:history, channels:write.invites, chat:write, chat:write.customize, groups:read, groups:write, groups:history, groups:write.invites, im:read, im:write, im:history, mpim:read, mpim:write, mpim:history, reactions:read, reactions:write, users:read, users:read.email, users.profile:read, usergroups:read, files:read, files:write, links:read, links:write, emoji:read

3. Create the action tool

   In Tools, select New Tool > Action > Slack > Continue. Select the Action and Auth Profile, set parameter defaults (leave a value empty for the agent to supply at runtime), and select Create Tool. Then assign the tool to an agent.

​

Action reference

Message timestamps (ts, threadTs) identify messages in Slack. Get them from a send action’s output, from Get channel history, or from a message’s Copy link URL.

​

Messaging

Send Message To A Channel

Parameter	Type	Description
channel	enum	Channel.
text	string	Message.
sendAsBot	boolean	Posts as the bot. Default: True.
threadTs	string	Parent message timestamp, to reply in a thread.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
iconEmoji	string	Bot icon emoji.
file	string	File to attach.
replyBroadcast	boolean	Also posts a thread reply to the channel. Default: False.
mentionOriginFlow	boolean	Adds a mention of the originating flow at the end of the message. Default: False.
unfurlLinks	boolean	Expands link previews. Default: True.
blocks	object	Block Kit layout. See Block Kit.

Send Message To A User

Parameter	Type	Description
userId	enum	User.
text	string	Message.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
iconEmoji	string	Bot icon emoji.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.
blocks	object	Block Kit layout.
unfurlLinks	boolean	Expands link previews. Default: True.

Update message

Parameter	Type	Description
channel	enum	Channel.
ts	string	Timestamp of the message to update.
text	string	Updated text.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.
blocks	object	Block Kit layout.

Delete Message

Parameter	Type	Description
channel	enum	Channel.
ts	string	Timestamp of the message to delete.

Add Reaction to Message

Parameter	Type	Description
channel	enum	Channel.
ts	string	Timestamp of the message.
reaction	string	Emoji name without colons, for example thumbsup.

Markdown to Slack format

Converts Markdown to Slack’s mrkdwn syntax. Use it before a send action when the agent produces Markdown.

Parameter	Type	Description
markdown	string	Markdown text.

​

Human in the loop

These actions post a message and pause the tool until a user responds.

Request Approval in a Channel

Parameter	Type	Description
channel	enum	Channel.
text	string	Approval request text.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.

Request Approval from A User

Parameter	Type	Description
userId	enum	Approver.
text	string	Approval request text.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.

Request Action in A Channel

Parameter	Type	Description
channel	enum	Channel.
text	string	Message.
actions	array	Action buttons the user can select.
threadTs	string	Parent message timestamp, to post in a thread.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.

Request Action from A User

Parameter	Type	Description
userId	enum	User.
text	string	Message.
actions	array	Action buttons the user can select.
username	string	Bot display name.
profilePicture	string	Bot profile picture URL.
mentionOriginFlow	boolean	Adds a mention of the originating flow. Default: False.

​

Read and search

Get Message by Timestamp

Parameter	Type	Description
channel	enum	Channel.
ts	string	Timestamp of the message.

Retrieve Thread Messages

Parameter	Type	Description
channel	enum	Channel.
threadTs	string	Timestamp of the parent message.

Get channel history

Parameter	Type	Description
channel	enum	Channel.
oldest	number	Start of the time range, as a Unix timestamp.
latest	number	End of the time range, as a Unix timestamp.
inclusive	boolean	Includes messages at the oldest and latest timestamps. Default: False.
includeAllMetadata	boolean	Returns all message metadata. Default: False.

Search messages

Parameter	Type	Description
query	string	Slack search query, for example invoice in:#finance.

​

Channels

Create Channel

Parameter	Type	Description
channelName	string	Channel name.
isPrivate	boolean	Creates a private channel. Default: False.

Set Channel Topic

Parameter	Type	Description
channel	enum	Channel.
topic	string	Topic text.

Invite User to Channel

Parameter	Type	Description
channel	enum	Channel.
userId	enum	User to invite.

​

Files

Upload file

Uploads a file without sharing it, unless you set channel.

Parameter	Type	Description
file	string	File to upload.
title	string	File title.
filename	string	File name.
channel	enum	Optional. Channel to share the file in.

Get File

Parameter	Type	Description
fileId	string	File ID.

​

Users

Find User by Email

Parameter	Type	Description
email	string	Email address.

Find User by Handle

Parameter	Type	Description
handle	string	Slack handle.

Find User by ID

Parameter	Type	Description
id	string	Slack user ID.

List users

Parameter	Type	Description
includeBots	boolean	Includes bot users. Default: False.
includeDisabled	boolean	Includes deactivated users. Default: False.

Update Profile

Parameter	Type	Description
firstName	string	First name.
lastName	string	Last name.
email	string	Email address.
userId	string	User to update.

Set User Status

Parameter	Type	Description
text	string	Status text.
emoji	string	Status emoji, for example :palm_tree:.
expiration	number	Expiry time, as a Unix timestamp.

​

Advanced

Custom API Call

Sends a request to any Slack Web API method. Artemis injects the authorization header from the auth profile.

Parameter	Type	Description
url	object	Endpoint URL.
method	enum	HTTP method.
headers	object	Additional request headers.
queryParams	object	Query parameters.
body_type	enum	Body type. Default: None.
body	object	Request body.
response_is_binary	boolean	Turn on for binary responses, such as PDFs or images. Default: False.
failsafe	boolean	Returns no error when the call fails.
timeout	number	Timeout, in seconds.
followRedirects	boolean	Follows HTTP redirects. Default: False.

​

Troubleshoot common issues

Issue	Resolution
bad_redirect_uri during authorization	Add the exact Callback URL to Redirect URLs in the Slack app.
not_in_channel or channel_not_found	Invite the app to the channel with /invite @<app name>.
missing_scope	Add the scope to the Slack app, reinstall the app, and then authorize the profile again.
message_not_found	Confirm the ts value and the channel. Timestamps are unique only within a channel.
Messages show raw Markdown	Run the text through Markdown to Slack format before sending.
Channel or user dropdowns are empty	Confirm the profile is Active and includes channels:read, groups:read, and users:read.

Related articles:

• Enterprise systems integrations
• Auth profiles
• Action Tools
• Integration node
• Slack Web API