Slack

The Slack component is an application component that allows users to get and send message on Slack. It can carry out the following tasks:

• Read Message
• Send Message

Release Stage

Alpha

Configuration

The component definition and tasks are defined in the definition.yaml and tasks.yaml files respectively.

Setup

In order to communicate with Slack, the following connection details need to be provided. You may specify them directly in a pipeline recipe as key-value pairs within the component's setup block, or you can create a Connection from the Integration Settings page and reference the whole setup as setup: ${connection.<my-connection-id>}.

Connecting through a Slack App

The Slack component connects with your workspace via a Slack App. In order to read / write messages from / to Slack, you'll need to:

• Add the app to your workspace.
• Add the app to the channels you want to interact with.

The Slack integration on Instill Cloud uses OAuth 2.0 to connect with Slack via the instill-ai app. There, creating a connection will simply require authenticating on Slack. Your newly created connection, which you can reference in your pipelines, will allow you to read messages and send them on behalf of your user or the instill-ai bot on the channels where that app is installed.

If you want to connect with Slack via OAuth 2.0 on Instill Core, you will need to provide your app's client ID and client secret as environment variables on Instill Core.

Supported Tasks

Read Message

Get the latest message since specific date

Send Message

send message to a specific channel

Supported Events

New Message Event

A new message event from Slack.

Example Recipes

Send a message to Slack when a new message is posted in a channel

version: v1beta

on:
  slack-0:
    type: slack
    event: EVENT_NEW_MESSAGE
    config:
      channel-names:
        - channel-to-be-listened
    setup: ${connection.my-slack-connection}

variable:
  message:
    title: message
    type: string
    listen:
      - ${on.slack-0.message.text}
  user:
    title: user
    type: string
    listen:
      - ${on.slack-0.message.user.name}
  channel:
    title: channel
    type: string
    listen:
      - ${on.slack-0.message.channel.name}

component:
  slack-0:
    type: slack
    input:
      channel-name: channel-for-notification
      message: Message received in #${variable.channel} from @${variable.user}: ${variable.message}
      as-user: false
    condition:
    setup: ${connection.my-slack-connection}
    task: TASK_WRITE_MESSAGE