View as Markdown
Bot for Slack icon

Bot for Slack ACTION

Send Message

Send a message to a user, group, private channel or public channel (Bot). See postMessage or scheduleMessage docs here
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Bot for Slack account once, then configure and run Send Message from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "slack_bot-send-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    slack_bot: { authProvisionId: "apn_xxxxxxx" },
    channelType: "Channel Type",
    conversation: "Channel",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Send Message inputs
Property Type Description
channelType Channel Type string
The type of channel to send to. User/Direct Message (im), Group (mpim), Private Channel or Public Channel
Required Dynamic
conversation Channel string
Select a public or private channel, or a user or group. In order to list a Slack channel, your bot must be a member of that channel, and in order to list private channels, your bot must have the groups:read scope in the OAuth & Permissions settings in Slack for this bot.
Required Dynamic
text Text string
Text of the message to send (see Slack's formatting docs). This field is usually necessary, unless you're providing only attachments instead.
Required
mrkdwn Send text as Slack mrkdwn boolean
true by default. Pass false to disable Slack markup parsing. See docs here
Optional
post_at Schedule message string
Messages can only be scheduled up to 120 days in advance, and cannot be scheduled for the past. The datetime should be in ISO 8601 format. (Example: 2014-01-01T00:00:00Z)
Optional
include_sent_via_pipedream_flag Include link to Pipedream boolean
Defaults to true, includes a link to Pipedream at the end of your Slack message.
Optional
customizeBotSettings Customize Bot Settings boolean
Customize the username and/or icon of the Bot
Optional
username Bot Username string
Optionally customize your bot's user name (default is Pipedream). Must be used in conjunction with Send as User set to false, otherwise ignored.
Optional
icon_emoji Icon (emoji) string
Optionally provide an emoji to use as the icon for this message. E.g., :fire: Overrides icon_url. Must be used in conjunction with Send as User set to false, otherwise ignored.
Optional Dynamic
icon_url Icon (image URL) string
Optionally provide an image URL to use as the icon for this message. Must be used in conjunction with Send as User set to false, otherwise ignored.
Optional
replyToThread Reply to Thread boolean
Reply to an existing thread
Optional
thread_ts Message Timestamp string
Provide another message's ts value to make this message a reply (e.g., if triggering on new Slack messages, enter {{event.ts}}). Avoid using a reply's ts value; use its parent instead. e.g. 1403051575.000407.
Optional
thread_broadcast Send Channel Message boolean
If true, posts in the thread and channel. Used in conjunction with Message Timestamp and indicates whether reply should be made visible to everyone in the channel. Defaults to false.
Optional
addMessageMetadata Add Message Metadata boolean
Set the metadata event type and payload
Optional
metadata_event_type Metadata Event Type string
The name of the metadata event. Example: task_created
Optional
metadata_event_payload Metadata Event Payload string
The payload of the metadata event. Must be a JSON string. Example: { "id": "11223", "title": "Redesign Homepage"}
Optional
configureUnfurlSettings Configure Unfurl Settings boolean
Configure settings for unfurling links and media
Optional
unfurl_links Unfurl Links boolean
Default to false. Pass true to enable unfurling of links.
Optional
unfurl_media Unfurl Media boolean
Defaults to false. Pass true to enable unfurling of media content.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
slack_bot-send-message
Version
0.0.5
App
Bot for Slack
Authentication
API key
Behavior
May modify external data