Returns true if the conversation already exists

example channel

Delete the content and metadata of an existing message

Delete the content and metadata of a pending scheduled message from a queue

Example User

example

Invite a user to an existing conversation

general

billair.gif

Example

Post an ephemeral message to a user or channel

Post a message to a Slack channel from a webhook URL

Post a block formatted message to a Slack channel from a webhook URL

Searches for messages and files matching a query.

slack workflow diagram.png

slack workflow diagram

uploaded a file: <https://example.slack.com/files/U2U85N1RZ/F7PKF1NR7/slack_workflow_diagram.png|slack workflow diagram> and commented: Sure! Here's the workflow diagram!

computer.gif

The meaning of life the universe and everything is 42.

The meaning of life the universe and everything is 101010

Set the purpose of an existing conversation

Update the contents of an existing message

Upload a new file to a slack conversation

-.txt

Untitled

The vast majority of actions in this component use OAuth 2.0 for authentication.
To create a Slack OAuth 2.0 connection, first create and configure a Slack App by visiting the Slack [Developer App Portal](https://api.slack.com/apps):

1. Click **Create New App**
1. Choose to create the app **From scratch**
1. Give your app a name and select your workspace. We'll configure it to be multi-workspace capable in a moment
1. Select **OAuth & Permissions** from the sidebar
   1. Under **Redirect URLs**, add `https://oauth2.prismatic.io/callback` for US based integrations.
   1. For integrations outside the US refer to this [guide](https://prismatic.io/docs/connections/#creating-an-oauth-20-app-in-a-third-party-service) to find your region’s Callback URL.
   1. At the bottom, add some **User Token Scopes** if you plan for this integration to send messages on behalf of customers, or **Bot Token Scopes** if a Slack "bot" will send the messages.
      What [scopes](https://api.slack.com/scopes/) you need is dependent on what types of things your Slack integration will need to do (create channels, send messages, etc).
      If you just need to send messages to a channel as a bot, add these scopes: `chat:write chat:write.public`. If you want to send messages as a user, see the section [below](#sending-messages-as-a-user).
1. Next, select **Distribute App** under **Manage Distribution**. Confirm that you have "removed hard coded information" and select **Activate Public Distribution**.
   Your app needs to be publicly distributed for your customers to install it in their Slack workspaces.
1. Finally, open **Basic Information**. Take note of the **Client ID**, **Client Secret** and **Signing Secret**.

Now it's time to configure your integration to use your Slack OAuth 2.0 app.
Add a Slack step to your integration - that'll create a connection config variable for you.
Open up that connection config variable.

Enter **Client ID**, **Signing Secret** and **Client Secret** that you noted before.

The **Scopes** that you need to enter depends on what Slack actions your integration includes:

- If you're just sending messages to a channel, you can enter the scopes `chat:write chat:write.public` and that will assign you a bot token that can write messages to public channels. See [below](#sending-messages-to-private-channels) for information on sending messages to private channels.
- Conversation and channel-related actions require `admin.conversations:write`.

Enter scopes with spaces in between them (e.g. `chat:write users:read users:read.email`).

A list of all Slack OAuth scopes and what each does are available in their [docs](https://api.slack.com/scopes/).

#### Sending messages to private channels

The `chat:write.public` scope allows your bot to send messages to public channels.
If you would like to send messages to private channels, or would like to be more selective about what channels your bot can send messages to, your customer will need to invite the bot to specific channels.

If a bot does not have `chat:write.public` or tries to write to a private channel it's not a part of, you'll receive a `not_in_channel` error from Slack when you attempt to send a message to that channel.

#### Sending messages as a user

Slack applications typically send messages as bot users.
If you would instead like to send messages as a user, edit the `Auth URL` add `chat:write` to a user_scope query parameter on the Authorization URL to get a User token. To manage channels, add the `channels:write` scope.

Your `Auth URL`, then, will look something like this: `https://slack.com/oauth/v2/authorize?user_scope=chat:write`

#### Dynamically changing your bot's name

Your bot's username and icon are things you set when you create your Slack app.
If you would like to override your bot's username within your integration, you will need to request the `chat:write.customize` scope in addition to `chat:write`.

#### GovSlack

Slack offrs [GovSlack](https://slack.com/solutions/govslack) for government organizations that require compliance with FIPS 140-2, FedRAMP, ITAR, etc.
To use the Slack component with GovSlack, change the beginning of OAuth auth URL, token URL, and revoke URL from `https://slack.com` to `https://slack-gov.com`.
The component will automatically point API requests towards the Slack Gov API endpoint.


The [Slack Message from Webhook](#slack-message-from-webhook) and the [Slack Block Message from Webhook](#slack-block-message-from-webhook) actions are the only Slack actions that do not authenticate with OAuth.
Instead, it uses Slack [Incoming Webhooks](https://api.slack.com/messaging/webhooks).
For your customers to use this authorization method, they will need to create their own Slack apps and incoming webhooks.

To generate a Slack incoming webhook URL:

1. Navigate to https://api.slack.com/apps
1. Click **Create New App**, adding an app to your workspace.
1. Under **Add features and functionality** select **Incoming Webhooks**
1. **Activate Incoming Webhooks** and then **Add New Webhook to Workspace**
1. Take note of the Webhook URL. It should be of the form `https://hooks.slack.com/services/foo/bar/baz`


Select a Slack channel from a dropdown menu (up to 10,000 channels). To select Private Channels, you must access the API as a User and use the 'user_scope' configuration.

Select a User from a dropdown menu (up to 10,000 users)

Send messages to Slack channels and users

The **Slack** component allows you to post messages to a Slack channel.

#### API Documentation

This component was built using the following API References:

- [Slack Web API Documentation](https://api.slack.com/web)
- [Slack Web API Methods](https://api.slack.com/methods)


Trigger for handling slash command and modal webhooks from Slack

Receive and validate webhook requests from Slack's Events API for webhooks you configure.

You can configure Slack to send [events](https://api.slack.com/apis/connections/events-api#subscriptions) to a Prismatic integration.
This webhook trigger uses your Slack app's **signing secret** to [verify](https://api.slack.com/authentication/verifying-requests-from-slack) that messages come from Slack.
If a [challenge request](https://api.slack.com/apis/connections/events-api#subscriptions) is received, this trigger responds with the proper challenge response and this trigger follows the "URL Verify" branch.
For other notifications, like a "channel create" event occurred, this trigger follows the "Notification" path.

If you would like to invoke a flow that uses a Slack webhook trigger from an app other than Slack, you can send an additional header, `prismatic-bypass-challenge: true` with your request, to bypass Slack message verification.
When that header is present your integration will follow the "Management" branch.


John Doe

3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P

Action Name	Action Description
Post Message	Post a message to a slack channel
Delete message	Delete the content and metadata of an existing message
Delete a pending scheduled message	Delete the content and metadata of a pending scheduled message from a queue
Update Message	Update the contents of an existing message
Post Ephemeral Message	Post an ephemeral message to a user or channel
Close Conversation	Close an existing conversation
Create Conversation	Create a new conversation
Rename Conversation	Rename an existing conversation
Get User By Email	Get a user's information by email
Get User By ID	Get a user's information by ID
Leave Conversations	Leave an existing conversation
List Conversations	List all conversations
List Conversation Members	List all members of a conversation
List Users	List Users
Slack Message From Webhook	Post a message to a Slack channel from a webhook URL
Post Block Message	Post a message to a slack channel
Slack Block Message From Webhook	Post a block formatted message to a Slack channel from a webhook URL
Archive Conversation	Archive an existing conversation
Conversation Exists	Returns true if the conversation already exists
List Scheduled Messages	List all scheduled messages
List Files	List all available files
Invite User To Conversation	Invite a user to an existing conversation
Set Conversation Purpose	Set the purpose of an existing conversation
Set Conversation Topic	Set the purpose of an existing conversation
List Users Conversations	List Users Conversations
Upload File	Upload a new file to a slack conversation
Get Conversation History	Get the history of a conversation
Raw Request	Send raw HTTP request to Slack
Search All	Searches for messages and files matching a query.
Search Files	Searches for files matching a query.
Search Messages	Searches for messages matching a query.

Trigger Name	Trigger Description
Events API Webhook	Receive and validate webhook requests from Slack's Events API for webhooks you configure.
App Webhook	Trigger for handling slash command and modal webhooks from Slack

Slack Connector

Integrate with customers’ other SaaS apps, fast

About the Slack Connector

Actions

Triggers

Ready to get started?