Slackbot
slackbotSlackbot gives agents workspace-wide read access to a Slack workspace on behalf of the installing user - search messages and files, browse channel and thread history, and look up users and channels - while continuing to post and react as the bot. Includes direct messages and user email addresses so agents can search across DMs and resolve users by email.
Acciones disponibles (133)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Set snooze durationSLACKBOT_ACTIVATE_OR_MODIFY_DO_NOT_DISTURB_DURATIONAcciónDeprecated: turns on do not disturb mode for the current user, or changes its duration. use `set dnd duration` instead.
SLACKBOT_ACTIVATE_OR_MODIFY_DO_NOT_DISTURB_DURATIONAcciónDeprecated: turns on do not disturb mode for the current user, or changes its duration. use `set dnd duration` instead.
Parámetros de entrada
num_minutesstringObligatorioNumber of minutes, from now, to snooze until.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add a custom emoji to a Slack teamSLACKBOT_ADD_A_CUSTOM_EMOJI_TO_A_TEAMAcciónDeprecated: adds a custom emoji to a slack workspace given a unique name and an image url. use `add emoji` instead.
SLACKBOT_ADD_A_CUSTOM_EMOJI_TO_A_TEAMAcciónDeprecated: adds a custom emoji to a slack workspace given a unique name and an image url. use `add emoji` instead.
Parámetros de entrada
urlstringObligatorioThe URL of the image file to be used as the custom emoji. The image should be accessible via HTTP/HTTPS and meet Slack's emoji requirements (e.g., size, format). Supported formats typically include PNG, GIF, and JPEG.
namestringObligatorioThe desired name for the new custom emoji. This name will be used to invoke the emoji (e.g., if name is 'partyparrot', it's used as ':partyparrot:'). Colons around the name are not required when providing this field.
tokenstringObligatorioAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
Parámetros de salida
dataobjectObligatorioThe response data confirming the successful addition of the custom emoji.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add an emoji aliasSLACKBOT_ADD_AN_EMOJI_ALIAS_IN_SLACKAcciónAdds an alias for an existing custom emoji in a slack enterprise grid organization.
SLACKBOT_ADD_AN_EMOJI_ALIAS_IN_SLACKAcciónAdds an alias for an existing custom emoji in a slack enterprise grid organization.
Parámetros de entrada
namestringObligatorioThe new alias to be created for the emoji specified in `alias_for` (e.g., `new_emoji_alias`). Colons around the name (e.g., `:my_alias:`) are optional and will be automatically trimmed, along with any leading/trailing whitespace.
tokenstringObligatorioAuthentication token. Requires the `admin.teams:write` scope.
alias_forstringObligatorioThe canonical name of the existing custom emoji (e.g., `original_emoji`).
Parámetros de salida
dataobjectObligatorioThe structured response from the API. It typically contains an `ok` field which is `true` if the alias was added successfully.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add a remote fileSLACKBOT_ADD_A_REMOTE_FILE_FROM_A_SERVICEAcciónAdds a reference to an external file (e.g., google drive, dropbox) to slack for discovery and sharing, requiring a unique `external id` and an `external url` accessible by slack.
SLACKBOT_ADD_A_REMOTE_FILE_FROM_A_SERVICEAcciónAdds a reference to an external file (e.g., google drive, dropbox) to slack for discovery and sharing, requiring a unique `external id` and an `external url` accessible by slack.
Parámetros de entrada
titlestringTitle of the remote file to be displayed in Slack.
tokenstringSlack authentication token, required to authorize adding the remote file.
filetypestringFile type (e.g., 'pdf', 'docx', 'png') to help Slack display appropriate icons or previews.
external_idstringUnique identifier for the file, defined by the calling application, used for future API references (e.g., updating, deleting).
external_urlstringPublicly accessible or permissioned URL of the remote file, used by Slack to access its content or metadata.
preview_imagestringBase64-encoded image (e.g., PNG, JPEG) used as the file's preview in Slack.
indexable_file_contentsstringPlain text content of the file, indexed by Slack for search.
Parámetros de salida
dataobjectObligatorioContains a confirmation object indicating the success of the file addition.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add a star to an itemSLACKBOT_ADD_A_STAR_TO_AN_ITEMAcciónStars a channel, file, file comment, or a specific message in slack.
SLACKBOT_ADD_A_STAR_TO_AN_ITEMAcciónStars a channel, file, file comment, or a specific message in slack.
Parámetros de entrada
filestringID of the file to add a star to.
channelstringID of the channel to star. If starring a specific message, this is the ID of the channel containing the message, and `timestamp` must also be provided.
timestampstringTimestamp of the message to add a star to. This uniquely identifies the message within the specified `channel`. Requires `channel` to also be provided.
file_commentstringID of the file comment to add a star to.
Parámetros de salida
dataobjectObligatorioContains the API call's success status. The `ok` field within this model will be `True` if the star was added.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add call participantsSLACKBOT_ADD_CALL_PARTICIPANTSAcciónRegisters new participants added to a slack call.
SLACKBOT_ADD_CALL_PARTICIPANTSAcciónRegisters new participants added to a slack call.
Parámetros de entrada
idstringObligatorioID of the call returned by the add method.
usersstringObligatorioThe list of users to add as participants in the call. users is a JSON array (formatted as a string) containing information for each user. Each element should include both a `slack_id` and optionally an `external_id`. For example: `[{"slack_id": "U1H77", "external_id": "ext-id"}]`.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add emojiSLACKBOT_ADD_EMOJIAcciónAdds a custom emoji to a slack workspace given a unique name and an image url; subject to workspace emoji limits.
SLACKBOT_ADD_EMOJIAcciónAdds a custom emoji to a slack workspace given a unique name and an image url; subject to workspace emoji limits.
Parámetros de entrada
urlstringObligatorioThe URL of the image file to be used as the custom emoji. The image should be accessible via HTTP/HTTPS and meet Slack's emoji requirements (e.g., size, format). Supported formats typically include PNG, GIF, and JPEG.
namestringObligatorioThe desired name for the new custom emoji. This name will be used to invoke the emoji (e.g., if name is 'partyparrot', it's used as ':partyparrot:'). Colons around the name are not required when providing this field.
tokenstringObligatorioAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
Parámetros de salida
dataobjectObligatorioThe response data confirming the successful addition of the custom emoji.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add reaction to messageSLACKBOT_ADD_REACTION_TO_AN_ITEMAcciónAdds a specified emoji reaction to an existing message in a slack channel, identified by its timestamp; does not remove or retrieve reactions.
SLACKBOT_ADD_REACTION_TO_AN_ITEMAcciónAdds a specified emoji reaction to an existing message in a slack channel, identified by its timestamp; does not remove or retrieve reactions.
Parámetros de entrada
namestringObligatorioName of the emoji to add as a reaction (e.g., 'thumbsup'). This is the emoji name without colons. For emojis with skin tone modifiers, append '::skin-tone-X' where X is a number from 2 to 6 (e.g., 'wave::skin-tone-3').
channelstringObligatorioID of the channel where the message to add the reaction to was posted.
timestampstringObligatorioTimestamp of the message to which the reaction will be added. This is a unique identifier for the message, typically a string representing a float value like '1234567890.123456'.
Parámetros de salida
dataobjectObligatorioWrapper for the response data, indicating the outcome of the add reaction operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Archive a Slack conversationSLACKBOT_ARCHIVE_A_CONVERSATIONAcciónArchives a slack conversation by its id, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain dms) cannot be archived and this may impact connected integrations.
SLACKBOT_ARCHIVE_A_CONVERSATIONAcciónArchives a slack conversation by its id, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain dms) cannot be archived and this may impact connected integrations.
Parámetros de entrada
channelstringID of the Slack conversation to archive. This ID uniquely identifies a channel (e.g., public, private).
Parámetros de salida
dataobjectObligatorioThe response from the Slack API, primarily indicating the success or failure of the archive operation. Includes an 'ok' field.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Archive a public or private channelSLACKBOT_ARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónArchives a slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.
SLACKBOT_ARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónArchives a slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.
Parámetros de entrada
channel_idstringObligatorioID of the public or private Slack channel to archive.
Parámetros de salida
dataobjectObligatorioResult of the archive operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Post message to channelSLACKBOT_CHAT_POST_MESSAGEAcciónDeprecated: posts a message to a slack channel, direct message, or private channel. use `send message` instead.
SLACKBOT_CHAT_POST_MESSAGEAcciónDeprecated: posts a message to a slack channel, direct message, or private channel. use `send message` instead.
Parámetros de entrada
textstringDEPRECATED: This sends raw text only, use markdown_text field. Primary textual content. Recommended fallback if using `blocks` or `attachments`. Supports mrkdwn unless `mrkdwn` is `false`.
parsestringMessage text parsing behavior. Default `none` (no special parsing). `full` parses as user-typed (links @mentions, #channels). See Slack API docs for details.
blocksstringDEPRECATED: Use `markdown_text` field instead. URL-encoded JSON array of layout blocks for rich/interactive messages. See Slack API Block Kit docs for structure.
mrkdwnbooleanDisable Slack's markdown for `text` field if `false`. Default `true` (allows *bold*, _italic_, etc.).
as_userbooleanPost as the authenticated user instead of as a bot. Defaults to `false`. If `true`, `username`, `icon_emoji`, and `icon_url` are ignored. If `false`, the message is posted as a bot, allowing appearance customization.
channelstringObligatorioID or name of the channel, private group, or IM channel to send the message to.
icon_urlstringImage URL for bot's icon (must be HTTPS). Applies if `as_user` is `false`.
usernamestringBot's name in Slack (max 80 chars). Applies if `as_user` is `false`.
thread_tsstringTimestamp (`ts`) of an existing message to make this a threaded reply. Use `ts` of the parent message, not another reply. Example: '1476746824.000004'.
icon_emojistringEmoji for bot's icon (e.g., ':robot_face:'). Overrides `icon_url`. Applies if `as_user` is `false`.
link_namesbooleanAutomatically hyperlink channel names (e.g., #channel) and usernames (e.g., @user) in message text. Defaults to `false` for bot messages.
attachmentsstringURL-encoded JSON array of message attachments, a legacy method for rich content. See Slack API documentation for structure.
unfurl_linksbooleanEnable unfurling of text-based URLs. Defaults `false` for bots, `true` if `as_user` is `true`.
unfurl_mediabooleanDisable unfurling of media content from URLs if `false`. Defaults to `true`.
markdown_textstringPREFERRED: Write your message in markdown for nicely formatted display. Supports: headers (# ## ###), bold (**text** or __text__), italic (*text* or _text_), strikethrough (~~text~~), inline code (`code`), code blocks (```), links ([text](url)), block quotes (>), lists (- item, 1. item), dividers (--- or ***), context blocks (:::context with images), and section buttons (:::section-button). IMPORTANT: Use \n for line breaks (e.g., 'Line 1\nLine 2'), not actual newlines. USER MENTIONS: To tag users, use their user ID with <@USER_ID> format (e.g., <@U1234567890>), not username.
reply_broadcastbooleanIf `true` for a threaded reply, also posts to main channel. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioContains the posted message details including the message object and metadata like channel ID and timestamp.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Close conversation channelSLACKBOT_CLOSE_DM_OR_MULTI_PERSON_DMAcciónCloses a slack direct message (dm) or multi-person direct message (mpdm) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view.
SLACKBOT_CLOSE_DM_OR_MULTI_PERSON_DMAcciónCloses a slack direct message (dm) or multi-person direct message (mpdm) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view.
Parámetros de entrada
channelstringThe ID of the direct message or multi-person direct message channel to close. Example: D1234567890 or G0123456789.
Parámetros de salida
dataobjectObligatorioThe response data containing the status of the close operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a reminderSLACKBOT_CREATE_A_REMINDERAcciónCreates a slack reminder with specified text and time; time accepts unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every thursday at 2pm').
SLACKBOT_CREATE_A_REMINDERAcciónCreates a slack reminder with specified text and time; time accepts unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every thursday at 2pm').
Parámetros de entrada
textstringObligatorioThe textual content of the reminder message.
timestringObligatorioSpecifies when the reminder should occur. This can be a Unix timestamp (integer, up to five years from now), the number of seconds until the reminder (integer, if within 24 hours, e.g., '300' for 5 minutes), or a natural language description (string, e.g., "in 15 minutes," or "every Thursday at 2pm", "daily").
userstringThe ID of the user who will receive the reminder (e.g., 'U012AB3CD4E'). If not specified, the reminder will be sent to the user who created it.
Parámetros de salida
dataobjectObligatorioThe structured response from the API, including the success status and reminder details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a Slack user groupSLACKBOT_CREATE_A_USER_GROUPAcciónCreates a new user group (often referred to as a subteam) in a slack workspace.
SLACKBOT_CREATE_A_USER_GROUPAcciónCreates a new user group (often referred to as a subteam) in a slack workspace.
Parámetros de entrada
namestringObligatorioUnique name for the User Group. Must be unique among all User Groups in the workspace.
handlestringUnique mention handle. Must be unique across channels, users, and other User Groups. Max 21 chars; lowercase letters, numbers, hyphens, underscores only.
channelsstringComma-separated encoded channel IDs for default channels, suggested when mentioning or inviting the group.
descriptionstringShort description for the User Group.
include_countbooleanInclude the User Group's user count in the response. Server defaults to `false` if omitted.
Parámetros de salida
dataobjectObligatorioContains the creation result and details of the new User Group.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create channelSLACKBOT_CREATE_CHANNELAcciónInitiates a public or private channel-based conversation
SLACKBOT_CREATE_CHANNELAcciónInitiates a public or private channel-based conversation
Parámetros de entrada
namestringObligatorioName of the public or private channel to create
team_idstringencoded team id to create the channel in, required if org token is used
is_privatebooleanCreate a private channel instead of a public one
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a channel-based conversationSLACKBOT_CREATE_CHANNEL_BASED_CONVERSATIONAcciónCreates a new public or private slack channel with a unique name; the channel can be org-wide, or team-specific if `team id` is given (required if `org wide` is false or not provided).
SLACKBOT_CREATE_CHANNEL_BASED_CONVERSATIONAcciónCreates a new public or private slack channel with a unique name; the channel can be org-wide, or team-specific if `team id` is given (required if `org wide` is false or not provided).
Parámetros de entrada
namestringObligatorioName for the new channel. Must be unique, 80 characters or fewer, lowercase, without spaces or periods, and may contain letters, numbers, and hyphens.
team_idstringWorkspace (team) ID for channel creation (e.g., T123ABCDEFG). Required if `org_wide` is `false` or not set.
org_widebooleanSet to `true` to make the channel available org-wide. If `false` or not set, `team_id` is required.
is_privatebooleanObligatorioSet to `true` to make the channel private, or `false` for public.
descriptionstringOptional description for the channel (e.g., 'Discussion about Q4 marketing strategies').
Parámetros de salida
dataobjectObligatorioContains the details of the created channel, including its ID and a success status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Customize URL unfurlSLACKBOT_CUSTOMIZE_URL_UNFURLAcciónCustomizes url previews (unfurling) in a specific slack message using a url-encoded json in `unfurls` to define custom content or remove existing previews.
SLACKBOT_CUSTOMIZE_URL_UNFURLAcciónCustomizes url previews (unfurling) in a specific slack message using a url-encoded json in `unfurls` to define custom content or remove existing previews.
Parámetros de entrada
tsstringObligatorioTimestamp of the message to customize URL unfurling for.
channelstringObligatorioChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
unfurlsstringURL-encoded JSON mapping message URLs to custom unfurl content (Slack attachment format or unfurl blocks). To remove an existing unfurl, provide an empty unfurl block for its URL.
user_auth_urlstringURL-encoded custom URL for user authentication with your app to enable unfurling. Used when `user_auth_required` is true.
user_auth_messagestringEphemeral message text prompting user authentication with your app for domain-specific unfurling. Used when `user_auth_required` is true and authorization is pending.
user_auth_requiredbooleanSet to `true` if user authentication is required to unfurl links for a domain, enabling an authentication flow using `user_auth_url` and `user_auth_message`.
Parámetros de salida
dataobjectObligatorioContains an `ok` field which indicates if the request to customize unfurling was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Customize URL unfurling in messagesSLACKBOT_CUSTOMIZE_URL_UNFURLING_IN_MESSAGESAcciónDeprecated: customizes url previews (unfurling) in a specific slack message. use `customize url unfurl` instead.
SLACKBOT_CUSTOMIZE_URL_UNFURLING_IN_MESSAGESAcciónDeprecated: customizes url previews (unfurling) in a specific slack message. use `customize url unfurl` instead.
Parámetros de entrada
tsstringObligatorioTimestamp of the message to customize URL unfurling for.
channelstringObligatorioChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
unfurlsstringURL-encoded JSON mapping message URLs to custom unfurl content (Slack attachment format or unfurl blocks). To remove an existing unfurl, provide an empty unfurl block for its URL.
user_auth_urlstringURL-encoded custom URL for user authentication with your app to enable unfurling. Used when `user_auth_required` is true.
user_auth_messagestringEphemeral message text prompting user authentication with your app for domain-specific unfurling. Used when `user_auth_required` is true and authorization is pending.
user_auth_requiredbooleanSet to `true` if user authentication is required to unfurl links for a domain, enabling an authentication flow using `user_auth_url` and `user_auth_message`.
Parámetros de salida
dataobjectObligatorioContains an `ok` field which indicates if the request to customize unfurling was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete file commentSLACKBOT_DELETE_A_COMMENT_ON_A_FILEAcciónDeletes a specific comment from a file in slack; this action is irreversible.
SLACKBOT_DELETE_A_COMMENT_ON_A_FILEAcciónDeletes a specific comment from a file in slack; this action is irreversible.
Parámetros de entrada
idstringID of the comment to delete. This can be obtained when the comment is created or by listing file comments.
filestringID of the file to delete a comment from. The file ID can be obtained using the `files.info` method or when a file is shared.
Parámetros de salida
dataobjectObligatorioIndicates if the comment was successfully deleted.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a file by IDSLACKBOT_DELETE_A_FILE_BY_IDAcciónPermanently deletes an existing file from a slack workspace using its unique file id; this action is irreversible and also removes any associated comments or shares.
SLACKBOT_DELETE_A_FILE_BY_IDAcciónPermanently deletes an existing file from a slack workspace using its unique file id; this action is irreversible and also removes any associated comments or shares.
Parámetros de entrada
filestringID of the file to delete. Typically obtained when a file is uploaded or listed.
Parámetros de salida
dataobjectObligatorioOutcome of the file deletion request. A successful operation is indicated by an 'ok' field with a true value.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a public or private channelSLACKBOT_DELETE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónPermanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a slack enterprise grid organization.
SLACKBOT_DELETE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónPermanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a slack enterprise grid organization.
Parámetros de entrada
channel_idstringObligatorioID of the channel to be permanently deleted. This channel can be public or private.
Parámetros de salida
dataobjectObligatorioStandard Slack API response object. It includes an `ok` field which is `true` upon successful deletion of the channel.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a Slack reminderSLACKBOT_DELETE_A_REMINDERAcciónDeletes an existing slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.
SLACKBOT_DELETE_A_REMINDERAcciónDeletes an existing slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.
Parámetros de entrada
reminderstringThe unique identifier of the reminder to be deleted. This ID is obtained when a reminder is created or listed.
Parámetros de salida
dataobjectObligatorioContains a boolean field `ok` which is true if the reminder was successfully deleted.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete scheduled chat messageSLACKBOT_DELETE_A_SCHEDULED_MESSAGE_IN_A_CHATAcciónDeletes a pending, unsent scheduled message from the specified slack channel, identified by its `scheduled message id`.
SLACKBOT_DELETE_A_SCHEDULED_MESSAGE_IN_A_CHATAcciónDeletes a pending, unsent scheduled message from the specified slack channel, identified by its `scheduled message id`.
Parámetros de entrada
as_userbooleanPass `true` to delete the message as the authenticated user (bots are considered authed users here, uses `chat:write:user` scope); if `false` or omitted, deletes as a bot (uses `chat:write:bot` scope).
channelstringObligatorioID of the channel, private group, or DM conversation where the message is scheduled.
scheduled_message_idstringObligatorioUnique ID (`scheduled_message_id`) of the message to be deleted; obtained from `chat.scheduleMessage` response.
Parámetros de salida
dataobjectObligatorioStandard API response, includes an `ok` field confirming deletion success.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a message from a chatSLACKBOT_DELETES_A_MESSAGE_FROM_A_CHATAcciónDeletes a message, identified by its channel id and timestamp, from a slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.
SLACKBOT_DELETES_A_MESSAGE_FROM_A_CHATAcciónDeletes a message, identified by its channel id and timestamp, from a slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.
Parámetros de entrada
tsstringTimestamp of the message to be deleted. Must be the exact Slack message timestamp string with fractional precision, e.g., '1234567890.123456'.
as_userbooleanIf `True`, deletes the message as the authenticated user using the `chat:write:user` scope. Bot users are considered authenticated users. If `False` or omitted, the message is deleted using the `chat:write:bot` scope.
channelstringThe ID of the channel, private group, or direct message conversation containing the message to be deleted.
Parámetros de salida
dataobjectObligatorioConfirmation details for the message deletion, including the channel ID and the timestamp of the deleted message.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete user profile photoSLACKBOT_DELETE_USER_PROFILE_PHOTOAcciónDeletes the slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set.
SLACKBOT_DELETE_USER_PROFILE_PHOTOAcciónDeletes the slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set.
Parámetros de entrada
tokenstringObligatorioAuthentication token identifying the user whose profile photo will be deleted.
Parámetros de salida
dataobjectObligatorioIndicates the success of the photo deletion operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Disable a Slack user groupSLACKBOT_DISABLE_AN_EXISTING_USER_GROUPAcciónDisables a specified, currently enabled slack user group by its unique id, effectively archiving it by setting its 'date delete' timestamp; the group is not permanently deleted and can be re-enabled.
SLACKBOT_DISABLE_AN_EXISTING_USER_GROUPAcciónDisables a specified, currently enabled slack user group by its unique id, effectively archiving it by setting its 'date delete' timestamp; the group is not permanently deleted and can be re-enabled.
Parámetros de entrada
usergroupstringObligatorioUnique encoded ID of the User Group to disable.
include_countbooleanIf true, include the number of users in the User Group in the response.
Parámetros de salida
dataobjectObligatorioThe response data from the Slack API, containing the outcome and details of the disabled User Group.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Enable a user groupSLACKBOT_ENABLE_A_SPECIFIED_USER_GROUPAcciónEnables a disabled user group in slack using its id, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.
SLACKBOT_ENABLE_A_SPECIFIED_USER_GROUPAcciónEnables a disabled user group in slack using its id, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.
Parámetros de entrada
usergroupstringObligatorioThe unique encoded ID of the User Group to enable. This ID typically starts with 'S'.
include_countbooleanIf true, includes the count of users in the User Group in the response.
Parámetros de salida
dataobjectObligatorioThe response payload from the API, detailing the outcome of the enable operation and the User Group's current state.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Share file public urlSLACKBOT_ENABLE_PUBLIC_SHARING_OF_A_FILEAcciónEnables public sharing for an existing slack file by generating a publicly accessible url; this action does not create new files.
SLACKBOT_ENABLE_PUBLIC_SHARING_OF_A_FILEAcciónEnables public sharing for an existing slack file by generating a publicly accessible url; this action does not create new files.
Parámetros de entrada
filestringThe ID of the file to be shared publicly.
Parámetros de salida
dataobjectObligatorioThe response data containing the file object and success status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
End a callSLACKBOT_END_A_CALL_WITH_DURATION_AND_IDAcciónEnds an ongoing slack call, identified by its id (obtained from `calls.add`), optionally specifying the call's duration.
SLACKBOT_END_A_CALL_WITH_DURATION_AND_IDAcciónEnds an ongoing slack call, identified by its id (obtained from `calls.add`), optionally specifying the call's duration.
Parámetros de entrada
idstringObligatorioUnique identifier of the call to be ended, obtained from the `calls.add` method.
durationintegerDuration of the call in seconds.
Parámetros de salida
dataobjectObligatorioResponse data from the API call.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
End snoozeSLACKBOT_END_SNOOZEAcciónEnds the current user's snooze mode immediately.
SLACKBOT_END_SNOOZEAcciónEnds the current user's snooze mode immediately.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
End DND sessionSLACKBOT_END_USER_DO_NOT_DISTURB_SESSIONAcciónEnds the authenticated user's current do not disturb (dnd) session in slack, affecting only dnd status and making them available; if dnd is not active, slack acknowledges the request without changing status.
SLACKBOT_END_USER_DO_NOT_DISTURB_SESSIONAcciónEnds the authenticated user's current do not disturb (dnd) session in slack, affecting only dnd status and making them available; if dnd is not active, slack acknowledges the request without changing status.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe response data indicating the outcome of the action.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
End snooze mode immediatelySLACKBOT_END_USER_SNOOZE_MODE_IMMEDIATELYAcciónDeprecated: ends the current user's snooze mode immediately. use `end snooze` instead.
SLACKBOT_END_USER_SNOOZE_MODE_IMMEDIATELYAcciónDeprecated: ends the current user's snooze mode immediately. use `end snooze` instead.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch bot user informationSLACKBOT_FETCH_BOT_USER_INFORMATIONAcciónFetches information for a specified, existing slack bot user; will not work for regular user accounts or other integration types.
SLACKBOT_FETCH_BOT_USER_INFORMATIONAcciónFetches information for a specified, existing slack bot user; will not work for regular user accounts or other integration types.
Parámetros de entrada
botstringThe ID of the bot user to retrieve information for. This typically starts with 'B'.
Parámetros de salida
dataobjectObligatorioThe main data object in the response, containing the bot information and success status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch conversation historySLACKBOT_FETCH_CONVERSATION_HISTORYAcciónFetches a chronological list of messages and events from a specified slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering.
SLACKBOT_FETCH_CONVERSATION_HISTORYAcciónFetches a chronological list of messages and events from a specified slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering.
Parámetros de entrada
limitintegerMaximum number of messages to return per page (1-1000). Fewer may be returned if at the end of history or channel has fewer messages.
cursorstringPagination cursor from `next_cursor` of a previous response to fetch subsequent pages. See Slack's pagination documentation for details.
lateststringEnd of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., '1234567890.000000').
oldeststringStart of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., '1234567890.000000').
channelstringObligatorioThe ID of the public channel, private channel, direct message, or multi-person direct message to fetch history from.
inclusivebooleanInclude messages with `latest` or `oldest` timestamps in the results; applies only when `latest` or `oldest` is specified.
Parámetros de salida
dataobjectObligatorioThe structured response from the API, containing messages and pagination details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch team informationSLACKBOT_FETCH_CURRENT_TEAM_INFO_WITH_OPTIONAL_TEAM_SCOPEAcciónDeprecated: fetches comprehensive metadata about the current slack team. use `fetch team info` instead.
SLACKBOT_FETCH_CURRENT_TEAM_INFO_WITH_OPTIONAL_TEAM_SCOPEAcciónDeprecated: fetches comprehensive metadata about the current slack team. use `fetch team info` instead.
Parámetros de entrada
teamstringThe ID of the team to retrieve information for. If omitted, information for the current team (associated with the authentication token) is returned. The token must have permissions to view the specified team, especially for teams accessible via external shared channels.
Parámetros de salida
dataobjectObligatorioResponse containing team information
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Do Not Disturb status for usersSLACKBOT_FETCH_DND_STATUS_FOR_MULTIPLE_TEAM_MEMBERSAcciónDeprecated: retrieves a user's current do not disturb status. use `get team dnd status` instead.
SLACKBOT_FETCH_DND_STATUS_FOR_MULTIPLE_TEAM_MEMBERSAcciónDeprecated: retrieves a user's current do not disturb status. use `get team dnd status` instead.
Parámetros de entrada
usersstringObligatorioComma-separated list of users to fetch Do Not Disturb status for
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch item reactionsSLACKBOT_FETCH_ITEM_REACTIONSAcciónFetches reactions for a slack message, file, or file comment, requiring one of: channel and timestamp; file id; or file comment id.
SLACKBOT_FETCH_ITEM_REACTIONSAcciónFetches reactions for a slack message, file, or file comment, requiring one of: channel and timestamp; file id; or file comment id.
Parámetros de entrada
filestringFile ID. Use instead of channel/timestamp or file comment ID.
fullbooleanIf true, returns the complete list of users for each reaction.
channelstringChannel ID. Required if `timestamp` is provided and no file or file comment ID is given.
timestampstringMessage timestamp (e.g., '1234567890.123456'). Required if `channel` is provided and no file or file comment ID is given.
file_commentstringFile comment ID. Use instead of channel/timestamp or file ID.
Parámetros de salida
dataarrayObligatorioContains the requested item (message, file, or file comment) and its reactions.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve conversation repliesSLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATIONAcciónRetrieves replies to a specific parent message in a slack conversation, using the channel id and the parent message's timestamp (`ts`).
SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATIONAcciónRetrieves replies to a specific parent message in a slack conversation, using the channel id and the parent message's timestamp (`ts`).
Parámetros de entrada
tsstringTimestamp of the parent message in the thread. Must be an existing message. If no replies, only the parent message itself is returned.
limitintegerMaximum number of messages to return. Fewer may be returned even if more are available.
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response to get subsequent pages. If omitted, fetches the first page.
lateststringLatest message timestamp in the time range to include results.
oldeststringOldest message timestamp in the time range to include results.
channelstringID of the conversation (channel, direct message, etc.) to fetch the thread from.
inclusivebooleanWhether to include messages with `latest` or `oldest` timestamps in results. Effective only if `latest` or `oldest` is specified.
Parámetros de salida
dataobjectObligatorioThe response data containing the message thread and pagination information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch team infoSLACKBOT_FETCH_TEAM_INFOAcciónFetches comprehensive metadata about the current slack team, or a specified team if the provided id is accessible.
SLACKBOT_FETCH_TEAM_INFOAcciónFetches comprehensive metadata about the current slack team, or a specified team if the provided id is accessible.
Parámetros de entrada
teamstringThe ID of the team to retrieve information for. If omitted, information for the current team (associated with the authentication token) is returned. The token must have permissions to view the specified team, especially for teams accessible via external shared channels.
Parámetros de salida
dataobjectObligatorioResponse containing team information
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch workspace settings informationSLACKBOT_FETCH_WORKSPACE_SETTINGS_INFORMATIONAcciónRetrieves detailed settings for a specific slack workspace, primarily for administrators in an enterprise grid organization to view or audit workspace configurations.
SLACKBOT_FETCH_WORKSPACE_SETTINGS_INFORMATIONAcciónRetrieves detailed settings for a specific slack workspace, primarily for administrators in an enterprise grid organization to view or audit workspace configurations.
Parámetros de entrada
team_idstringObligatorioThe unique identifier of the Slack team (workspace) for which to fetch settings. This ID typically starts with 'T'.
Parámetros de salida
dataobjectObligatorioThe response payload containing the workspace settings information. It includes a success status (`ok`) and dynamically populated fields representing the various settings of the team (e.g., team name, domain, icon).
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Find channelsSLACKBOT_FIND_CHANNELSAcciónFind channels in a slack workspace by any criteria - name, topic, purpose, or description.
SLACKBOT_FIND_CHANNELSAcciónFind channels in a slack workspace by any criteria - name, topic, purpose, or description.
Parámetros de entrada
limitintegerMaximum number of channels to return (1 to 200). Defaults to 50.
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). Defaults to public and private channels.
exact_matchbooleanUse exact matching instead of partial matching. Defaults to false.
member_onlybooleanOnly return channels the user is a member of. Defaults to false.
search_querystringObligatorioSearch query to find channels. Searches across channel name, topic, purpose, and description (case-insensitive partial matching).
exclude_archivedbooleanExclude archived channels from search results. Defaults to true.
Parámetros de salida
dataobjectObligatorioResponse containing the list of matching channels and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Lookup users by emailSLACKBOT_FIND_USER_BY_EMAIL_ADDRESSAcciónRetrieves the slack user object for an active user by their registered email address; fails with 'users not found' if the email is unregistered or the user is inactive.
SLACKBOT_FIND_USER_BY_EMAIL_ADDRESSAcciónRetrieves the slack user object for an active user by their registered email address; fails with 'users not found' if the email is unregistered or the user is inactive.
Parámetros de entrada
emailstringObligatorioThe email address of the user to look up.
Parámetros de salida
dataobjectObligatorioThe API response payload. On success, this includes an 'ok' status and the 'user' object containing detailed information about the found user.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Find usersSLACKBOT_FIND_USERSAcciónFind users in a slack workspace by any criteria - email, name, display name, or other text. includes optimized email lookup for exact email matches.
SLACKBOT_FIND_USERSAcciónFind users in a slack workspace by any criteria - email, name, display name, or other text. includes optimized email lookup for exact email matches.
Parámetros de entrada
limitintegerMaximum number of users to return (1 to 200). Defaults to 50.
exact_matchbooleanUse exact matching instead of partial matching. Defaults to false.
include_botsbooleanInclude bot users in search results. Defaults to false.
search_querystringObligatorioSearch query to find users. Searches across name, display name, real name, email address, first name, last name, and status text (case-insensitive partial matching). For exact email matches with exact_match=true, uses Slack's efficient email lookup endpoint.
include_deletedbooleanInclude deleted/deactivated users in search results. Defaults to false.
include_restrictedbooleanInclude restricted (guest) users in search results. Defaults to true.
Parámetros de salida
dataobjectObligatorioResponse containing the list of matching users and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get channel conversation preferencesSLACKBOT_GET_CHANNEL_CONVERSATION_PREFERENCESAcciónRetrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within slack enterprise grid environments.
SLACKBOT_GET_CHANNEL_CONVERSATION_PREFERENCESAcciónRetrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within slack enterprise grid environments.
Parámetros de entrada
channel_idstringObligatorioIdentifier of the channel for which to retrieve conversation preferences.
Parámetros de salida
dataobjectObligatorioResponse data with the channel's conversation preferences.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get reminder informationSLACKBOT_GET_REMINDER_INFORMATIONAcciónRetrieves detailed information for an existing slack reminder specified by its id; this is a read-only operation.
SLACKBOT_GET_REMINDER_INFORMATIONAcciónRetrieves detailed information for an existing slack reminder specified by its id; this is a read-only operation.
Parámetros de entrada
reminderstringThe unique identifier of the reminder to retrieve information for. This ID typically starts with 'Rm'.
Parámetros de salida
dataobjectObligatorioThe response payload containing the status of the request and the detailed reminder information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get remote fileSLACKBOT_GET_REMOTE_FILEAcciónRetrieve information about a remote file added to slack.
SLACKBOT_GET_REMOTE_FILEAcciónRetrieve information about a remote file added to slack.
Parámetros de entrada
filestringSpecify a file by providing its ID.
external_idstringCreator defined GUID for the file.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get team DND statusSLACKBOT_GET_TEAM_DND_STATUSAcciónRetrieves a user's current do not disturb status.
SLACKBOT_GET_TEAM_DND_STATUSAcciónRetrieves a user's current do not disturb status.
Parámetros de entrada
usersstringObligatorioComma-separated list of users to fetch Do Not Disturb status for
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve user presenceSLACKBOT_GET_USER_PRESENCE_INFOAcciónRetrieves a slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons.
SLACKBOT_GET_USER_PRESENCE_INFOAcciónRetrieves a slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons.
Parámetros de entrada
userstringThe ID of the user to query for presence information. This is a string identifier, typically starting with 'U' or 'W' (e.g., 'U123ABC456'). If not provided, presence information for the authenticated user will be returned.
Parámetros de salida
dataobjectObligatorioContains the detailed presence information for the requested user, including their current status, connection details, and activity timestamps.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create conversationSLACKBOT_INITIATES_CHANNEL_BASED_CONVERSATIONSAcciónDeprecated: initiates a public or private channel-based conversation. use `create channel` instead.
SLACKBOT_INITIATES_CHANNEL_BASED_CONVERSATIONSAcciónDeprecated: initiates a public or private channel-based conversation. use `create channel` instead.
Parámetros de entrada
namestringObligatorioName of the public or private channel to create
team_idstringencoded team id to create the channel in, required if org token is used
is_privatebooleanCreate a private channel instead of a public one
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Invite users to a Slack channelSLACKBOT_INVITE_USERS_TO_A_CHANNELAcciónInvites users to an existing slack channel using their valid slack user ids.
SLACKBOT_INVITE_USERS_TO_A_CHANNELAcciónInvites users to an existing slack channel using their valid slack user ids.
Parámetros de entrada
usersstringComma-separated string of valid Slack User IDs to invite. Up to 1000 user IDs can be included.
channelstringID of the public or private Slack channel to invite users to; must be an existing channel. Typically starts with 'C' (public) or 'G' (private/group).
Parámetros de salida
dataobjectObligatorioResponse data detailing the channel after invitations and an 'ok' status for success.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Invite users to channelSLACKBOT_INVITE_USER_TO_CHANNELAcciónInvites users to a specified slack channel; this action is restricted to enterprise grid workspaces and requires the authenticated user to be a member of the target channel.
SLACKBOT_INVITE_USER_TO_CHANNELAcciónInvites users to a specified slack channel; this action is restricted to enterprise grid workspaces and requires the authenticated user to be a member of the target channel.
Parámetros de entrada
user_idsstringObligatorioA comma-separated string of Slack User IDs to invite to the channel. Up to 1000 users can be specified.
channel_idstringObligatorioThe ID of the public or private Slack channel to which users will be invited.
Parámetros de salida
dataobjectObligatorioContains the status of the user invitation operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Invite user to workspaceSLACKBOT_INVITE_USER_TO_WORKSPACEAcciónInvites a user to a slack workspace and specified channels by email; use `resend=true` to re-process an existing invitation for a user not yet signed up.
SLACKBOT_INVITE_USER_TO_WORKSPACEAcciónInvites a user to a slack workspace and specified channels by email; use `resend=true` to re-process an existing invitation for a user not yet signed up.
Parámetros de entrada
emailstringObligatorioThe email address of the person to be invited to the workspace.
resendbooleanIf true, allows this invitation to be resent if the user hasn't signed up. Defaults to false.
team_idstringObligatorioThe ID of the Slack workspace (e.g., T123ABCDEFG) where the user will be invited.
real_namestringThe full name of the user being invited.
channel_idsstringObligatorioA comma-separated list of channel IDs (e.g., C1234567890,C0987654321) for the user to join. At least one channel ID must be provided.
is_restrictedbooleanSpecifies if the invited user should be a multi-channel guest. Defaults to false. Multi-channel guests can access only the channels they are invited to, plus any public channels.
custom_messagestringCustom message to include in the invitation email.
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
is_ultra_restrictedbooleanSpecifies if the invited user should be a single-channel guest (also known as an ultra-restricted guest). Defaults to false. Single-channel guests can only access one channel (plus DMs and Huddles).
Parámetros de salida
dataobjectObligatorioResponse data for the user invitation process
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Invite user to workspace and channelsSLACKBOT_INVITE_USER_TO_WORKSPACE_WITH_OPTIONAL_CHANNEL_INVITESAcciónDeprecated: invites a user to a slack workspace and specified channels by email. use `invite user to workspace` instead.
SLACKBOT_INVITE_USER_TO_WORKSPACE_WITH_OPTIONAL_CHANNEL_INVITESAcciónDeprecated: invites a user to a slack workspace and specified channels by email. use `invite user to workspace` instead.
Parámetros de entrada
emailstringObligatorioThe email address of the person to be invited to the workspace.
resendbooleanIf true, allows this invitation to be resent if the user hasn't signed up. Defaults to false.
team_idstringObligatorioThe ID of the Slack workspace (e.g., T123ABCDEFG) where the user will be invited.
real_namestringThe full name of the user being invited.
channel_idsstringObligatorioA comma-separated list of channel IDs (e.g., C1234567890,C0987654321) for the user to join. At least one channel ID must be provided.
is_restrictedbooleanSpecifies if the invited user should be a multi-channel guest. Defaults to false. Multi-channel guests can access only the channels they are invited to, plus any public channels.
custom_messagestringCustom message to include in the invitation email.
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
is_ultra_restrictedbooleanSpecifies if the invited user should be a single-channel guest (also known as an ultra-restricted guest). Defaults to false. Single-channel guests can only access one channel (plus DMs and Huddles).
Parámetros de salida
dataobjectObligatorioResponse data for the user invitation process
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Join conversation by channel idSLACKBOT_JOIN_AN_EXISTING_CONVERSATIONAcciónJoins an existing slack conversation (public channel, private channel, or multi-person direct message) by its id, if the authenticated user has permission.
SLACKBOT_JOIN_AN_EXISTING_CONVERSATIONAcciónJoins an existing slack conversation (public channel, private channel, or multi-person direct message) by its id, if the authenticated user has permission.
Parámetros de entrada
channelstringID of the Slack conversation (public channel, private channel, or multi-person direct message) to join.
Parámetros de salida
dataobjectObligatorioContains the outcome of the join operation, including details of the channel if the join was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Leave conversation channelSLACKBOT_LEAVE_A_CONVERSATIONAcciónLeaves a slack conversation given its channel id; fails if leaving as the last member of a private channel or if used on a slack connect channel.
SLACKBOT_LEAVE_A_CONVERSATIONAcciónLeaves a slack conversation given its channel id; fails if leaving as the last member of a private channel or if used on a slack connect channel.
Parámetros de entrada
channelstringID of the conversation to leave (e.g., C1234567890). Despite `default=None` in the schema, this ID is functionally required by the Slack API.
Parámetros de salida
dataobjectObligatorioDetailed outcome of the leave attempt, including context on the user's channel membership status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List accessible conversations for a userSLACKBOT_LIST_ACCESSIBLE_CONVERSATIONS_FOR_A_USERAcciónDeprecated: retrieves conversations accessible to a specified user. use `list conversations` instead.
SLACKBOT_LIST_ACCESSIBLE_CONVERSATIONS_FOR_A_USERAcciónDeprecated: retrieves conversations accessible to a specified user. use `list conversations` instead.
Parámetros de entrada
userstringThe ID of the user whose conversations will be listed. If not provided, conversations for the authenticated user are returned. Non-public channels are restricted to those where the calling user (authenticating user) shares membership.
limitintegerThe maximum number of items to return per page. Must be an integer, typically between 1 and 1000 (e.g., 100). If omitted, the API's default limit (often 100) applies. Fewer items than the limit may be returned.
typesstringA comma-separated list of conversation types to include. Valid types are `public_channel`, `private_channel`, `mpim` (multi-person direct message), and `im` (direct message). If omitted, all types are included.
cursorstringPagination cursor for retrieving the next set of results. Obtain this from the `next_cursor` field in a previous response's `response_metadata`. If omitted, the first page is fetched.
exclude_archivedbooleanSet to `true` to exclude archived channels from the list. If `false` or omitted, archived channels are typically included (the API's default behavior for omission will apply, usually including them).
Parámetros de salida
dataobjectObligatorioThe primary response data, including the list of conversations and pagination cursors.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List all channelsSLACKBOT_LIST_ALL_CHANNELSAcciónLists conversations available to the user with various filters and search options.
SLACKBOT_LIST_ALL_CHANNELSAcciónLists conversations available to the user with various filters and search options.
Parámetros de entrada
limitintegerMaximum number of channels to return per page (1 to 1000). Fewer channels may be returned than requested. This schema defaults to 1 if omitted.
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). The API defaults to `public_channel` if this parameter is omitted.
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Parámetros de salida
dataobjectObligatorioResponse containing the list of Slack channels with pagination information and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List conversationsSLACKBOT_LIST_ALL_TEAM_CHANNELS_WITH_VARIOUS_FILTERSAcciónDeprecated: lists conversations available to the user with various filters and search options. use `list channels` instead.
SLACKBOT_LIST_ALL_TEAM_CHANNELS_WITH_VARIOUS_FILTERSAcciónDeprecated: lists conversations available to the user with various filters and search options. use `list channels` instead.
Parámetros de entrada
limitintegerMaximum number of channels to return per page (1 to 1000). Fewer channels may be returned than requested. This schema defaults to 1 if omitted.
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). The API defaults to `public_channel` if this parameter is omitted.
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Parámetros de salida
dataobjectObligatorioResponse containing the list of Slack channels with pagination information and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List all Slack team users with paginationSLACKBOT_LIST_ALL_TEAM_USERS_WITH_PAGINATIONAcciónDeprecated: retrieves a paginated list of all users in a slack workspace. use `list all users` instead.
SLACKBOT_LIST_ALL_TEAM_USERS_WITH_PAGINATIONAcciónDeprecated: retrieves a paginated list of all users in a slack workspace. use `list all users` instead.
Parámetros de entrada
limitintegerMaximum number of items to return per page; fewer may be returned if the end of the list is reached. Recommended to set a value (e.g., 100) as Slack may error for large workspaces if omitted.
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioMain data payload, including users list and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List all usersSLACKBOT_LIST_ALL_USERSAcciónRetrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a slack workspace; data may not be real-time.
SLACKBOT_LIST_ALL_USERSAcciónRetrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a slack workspace; data may not be real-time.
Parámetros de entrada
limitintegerMaximum number of items to return per page; fewer may be returned if the end of the list is reached. Recommended to set a value (e.g., 100) as Slack may error for large workspaces if omitted.
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioMain data payload, including users list and metadata
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List all users in a user groupSLACKBOT_LIST_ALL_USERS_IN_A_USER_GROUPAcciónRetrieves a list of all user ids within a specified slack user group, with an option to include users from disabled groups.
SLACKBOT_LIST_ALL_USERS_IN_A_USER_GROUPAcciónRetrieves a list of all user ids within a specified slack user group, with an option to include users from disabled groups.
Parámetros de entrada
usergroupstringObligatorioThe encoded ID of the User Group to list users from. This ID is an alphanumeric string.
include_disabledbooleanSet to `true` to include users from disabled user groups. If omitted, the default Slack API behavior for handling disabled groups (typically excluding them) will apply.
Parámetros de salida
dataobjectObligatorioThe response data, indicating success and containing the list of user IDs in the specified user group.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List conversationsSLACKBOT_LIST_CONVERSATIONSAcciónRetrieves conversations accessible to a specified user (or the authenticated user if no user id is provided), respecting shared membership for non-public channels.
SLACKBOT_LIST_CONVERSATIONSAcciónRetrieves conversations accessible to a specified user (or the authenticated user if no user id is provided), respecting shared membership for non-public channels.
Parámetros de entrada
userstringThe ID of the user whose conversations will be listed. If not provided, conversations for the authenticated user are returned. Non-public channels are restricted to those where the calling user (authenticating user) shares membership.
limitintegerThe maximum number of items to return per page. Must be an integer, typically between 1 and 1000 (e.g., 100). If omitted, the API's default limit (often 100) applies. Fewer items than the limit may be returned.
typesstringA comma-separated list of conversation types to include. Valid types are `public_channel`, `private_channel`, `mpim` (multi-person direct message), and `im` (direct message). If omitted, all types are included.
cursorstringPagination cursor for retrieving the next set of results. Obtain this from the `next_cursor` field in a previous response's `response_metadata`. If omitted, the first page is fetched.
exclude_archivedbooleanSet to `true` to exclude archived channels from the list. If `false` or omitted, archived channels are typically included (the API's default behavior for omission will apply, usually including them).
Parámetros de salida
dataobjectObligatorioThe primary response data, including the list of conversations and pagination cursors.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Slack filesSLACKBOT_LIST_FILES_WITH_FILTERS_IN_SLACKAcciónLists files and their metadata within a slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.
SLACKBOT_LIST_FILES_WITH_FILTERS_IN_SLACKAcciónLists files and their metadata within a slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.
Parámetros de entrada
pagestringSpecifies the page number of the results to retrieve when paginating. Default is 1.
userstringFilter files created by a single user. Provide the Slack User ID.
countstringSpecifies the number of files to return per page. Default is 100, maximum is 1000.
ts_tointegerFilter files created before this Unix timestamp (inclusive).
typesstringFilter files by types (comma-separated: 'images,pdfs'). Default 'all' for all types. Common: `all`, `spaces` (posts), `snippets`, `images`, `gdocs`, `zips`, `pdfs`.
channelstringFilter files appearing in a specific channel, indicated by its Slack Channel ID.
ts_fromintegerFilter files created after this Unix timestamp (inclusive).
show_files_hidden_by_limitbooleanShow truncated file info for files hidden due to being too old or if the team owning the file is over the storage limit.
Parámetros de salida
dataobjectObligatorioThe response schema containing the list of files and pagination details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List remindersSLACKBOT_LIST_REMINDERSAcciónLists all reminders with their details for the authenticated slack user; returns an empty list if no reminders exist.
SLACKBOT_LIST_REMINDERSAcciónLists all reminders with their details for the authenticated slack user; returns an empty list if no reminders exist.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe primary response data, including the operation's success status and the list of reminders.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List remote filesSLACKBOT_LIST_REMOTE_FILESAcciónRetrieve information about a team's remote files.
SLACKBOT_LIST_REMOTE_FILESAcciónRetrieve information about a team's remote files.
Parámetros de entrada
limitintegerThe maximum number of items to return.
ts_tonumberFilter files created before this timestamp (inclusive).
cursorstringPaginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail.
channelstringFilter files appearing in a specific channel, indicated by its ID.
ts_fromnumberFilter files created after this timestamp (inclusive).
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List scheduled messagesSLACKBOT_LIST_SCHEDULED_MESSAGESAcciónRetrieves a list of pending (not yet delivered) messages scheduled in a specific slack channel, or across all accessible channels if no channel id is provided, optionally filtered by time and paginated.
SLACKBOT_LIST_SCHEDULED_MESSAGESAcciónRetrieves a list of pending (not yet delivered) messages scheduled in a specific slack channel, or across all accessible channels if no channel id is provided, optionally filtered by time and paginated.
Parámetros de entrada
limitintegerMaximum messages per page (1-1000). Defaults to 100.
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response. Omit for the first page.
lateststringLatest UNIX timestamp (exclusive) for messages. Defaults to the current time if omitted.
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
channelstringID or name of the channel (public, private, or DM) to list messages for. If omitted, lists for all accessible channels in the workspace.
Parámetros de salida
dataobjectObligatorioResponse payload with scheduled messages and pagination details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List scheduled messages in a channelSLACKBOT_LIST_SCHEDULED_MESSAGES_IN_A_CHANNELAcciónDeprecated: retrieves a list of pending (not yet delivered) messages scheduled in a specific slack channel. use `list scheduled messages` instead.
SLACKBOT_LIST_SCHEDULED_MESSAGES_IN_A_CHANNELAcciónDeprecated: retrieves a list of pending (not yet delivered) messages scheduled in a specific slack channel. use `list scheduled messages` instead.
Parámetros de entrada
limitintegerMaximum messages per page (1-1000). Defaults to 100.
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response. Omit for the first page.
lateststringLatest UNIX timestamp (exclusive) for messages. Defaults to the current time if omitted.
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
channelstringID or name of the channel (public, private, or DM) to list messages for. If omitted, lists for all accessible channels in the workspace.
Parámetros de salida
dataobjectObligatorioResponse payload with scheduled messages and pagination details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List pinned items in a channelSLACKBOT_LISTS_PINNED_ITEMS_IN_A_CHANNELAcciónRetrieves all messages and files pinned to a specified channel; the caller must have access to this channel.
SLACKBOT_LISTS_PINNED_ITEMS_IN_A_CHANNELAcciónRetrieves all messages and files pinned to a specified channel; the caller must have access to this channel.
Parámetros de entrada
channelstringObligatorioThe ID of the channel to retrieve pinned items from. This can be a public channel ID, private group ID, or direct message channel ID.
Parámetros de salida
dataarrayObligatorioThe structured response from the API. This is a list that usually contains one element: either a collection of pinned items or a count object.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List team remote filesSLACKBOT_LIST_S_REMOTE_FILES_WITH_FILTERSAcciónDeprecated: retrieve information about a team's remote files. use `list remote files` instead.
SLACKBOT_LIST_S_REMOTE_FILES_WITH_FILTERSAcciónDeprecated: retrieve information about a team's remote files. use `list remote files` instead.
Parámetros de entrada
limitintegerThe maximum number of items to return.
ts_tonumberFilter files created before this timestamp (inclusive).
cursorstringPaginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail.
channelstringFilter files appearing in a specific channel, indicated by its ID.
ts_fromnumberFilter files created after this timestamp (inclusive).
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List starred itemsSLACKBOT_LIST_STARRED_ITEMSAcciónLists items starred by a user.
SLACKBOT_LIST_STARRED_ITEMSAcciónLists items starred by a user.
Parámetros de entrada
pageintegerPage number of results to return.
countintegerNumber of items to return per page.
limitintegerThe maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List starred itemsSLACKBOT_LISTS_USER_S_STARRED_ITEMS_WITH_PAGINATIONAcciónDeprecated: lists items starred by a user. use `list starred items` instead.
SLACKBOT_LISTS_USER_S_STARRED_ITEMS_WITH_PAGINATIONAcciónDeprecated: lists items starred by a user. use `list starred items` instead.
Parámetros de entrada
pageintegerPage number of results to return.
countintegerNumber of items to return per page.
limitintegerThe maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List team custom emojisSLACKBOT_LIST_TEAM_CUSTOM_EMOJISAcciónRetrieves all custom emojis for the slack workspace (image urls or aliases), not standard unicode emojis; does not include usage statistics or creation dates.
SLACKBOT_LIST_TEAM_CUSTOM_EMOJISAcciónRetrieves all custom emojis for the slack workspace (image urls or aliases), not standard unicode emojis; does not include usage statistics or creation dates.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe core response data from Slack. If `ok` (within this data structure) is `True`, includes an `emoji` dictionary (custom emoji names to image URLs or aliases) and may contain other fields like `cache_ts`.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List user groupsSLACKBOT_LIST_USER_GROUPS_FOR_TEAM_WITH_OPTIONSAcciónLists user groups in a slack workspace, including user-created and default groups; results for large workspaces may be paginated.
SLACKBOT_LIST_USER_GROUPS_FOR_TEAM_WITH_OPTIONSAcciónLists user groups in a slack workspace, including user-created and default groups; results for large workspaces may be paginated.
Parámetros de entrada
include_countbooleanInclude the number of users in each user group. Defaults to false.
include_usersbooleanInclude the list of user IDs for each user group. Defaults to false.
include_disabledbooleanInclude disabled user groups in the results. Defaults to false.
Parámetros de salida
dataobjectObligatorioContains the API response data, including a list of user groups if the request was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List user reactionsSLACKBOT_LIST_USER_REACTIONSAcciónLists all reactions added by a specific user to messages, files, or file comments in slack, useful for engagement analysis when the item content itself is not required.
SLACKBOT_LIST_USER_REACTIONSAcciónLists all reactions added by a specific user to messages, files, or file comments in slack, useful for engagement analysis when the item content itself is not required.
Parámetros de entrada
fullbooleanIf true, return the complete reaction list, which may include reactions to deleted items.
pageintegerPage number of results to return.
userstringReactions made by this user. Defaults to the authed user.
countintegerNumber of items to return per page.
limitintegerMaximum number of items to return; fewer items may be returned. Use with cursor-based pagination.
cursorstringPagination cursor. Set to `next_cursor` from a previous response's `response_metadata`. See Slack API pagination documentation for details.
Parámetros de salida
dataobjectObligatorioResponse data including the list of reactions and pagination information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List user reminders with detailsSLACKBOT_LIST_USER_REMINDERS_WITH_DETAILSAcciónDeprecated: lists all reminders with their details for the authenticated slack user. use `list reminders` instead.
SLACKBOT_LIST_USER_REMINDERS_WITH_DETAILSAcciónDeprecated: lists all reminders with their details for the authenticated slack user. use `list reminders` instead.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe primary response data, including the operation's success status and the list of reminders.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List admin usersSLACKBOT_LIST_WORKSPACE_USERSAcciónRetrieves a paginated list of admin users for a specified slack workspace.
SLACKBOT_LIST_WORKSPACE_USERSAcciónRetrieves a paginated list of admin users for a specified slack workspace.
Parámetros de entrada
limitintegerThe maximum number of admin users to retrieve per page. Must be a positive integer. If not specified, a default limit set by Slack will apply.
cursorstringPagination cursor for retrieving the next page of results. Pass the `next_cursor` value returned from a previous request to fetch subsequent items. If omitted, the first page is retrieved.
team_idstringObligatorioThe ID of the Slack workspace (e.g., `T123456789`) from which to list admin users.
Parámetros de salida
dataobjectObligatorioIf the request was successful (`ok` is true), contains the list of admin users for the workspace. Each user object typically includes details like user ID, name, and email.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set user presenceSLACKBOT_MANUALLY_SET_USER_PRESENCEAcciónManually sets a user's slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or slack's auto-away (e.g., after 10 mins of inactivity).
SLACKBOT_MANUALLY_SET_USER_PRESENCEAcciónManually sets a user's slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or slack's auto-away (e.g., after 10 mins of inactivity).
Parámetros de entrada
presencestringObligatorioThe presence state to set for the user. Valid values are 'auto' (Slack determines presence based on activity) or 'away' (sets presence to away).
Parámetros de salida
dataobjectObligatorioContains the outcome of the presence update request, typically indicating success with an 'ok: true' field.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Mark reminder as completeSLACKBOT_MARK_REMINDER_AS_COMPLETEAcciónMarks a specific slack reminder as complete using its `reminder` id; **deprecated**: this slack api endpoint ('reminders.complete') was deprecated in march 2023 and is not recommended for new applications.
SLACKBOT_MARK_REMINDER_AS_COMPLETEAcciónMarks a specific slack reminder as complete using its `reminder` id; **deprecated**: this slack api endpoint ('reminders.complete') was deprecated in march 2023 and is not recommended for new applications.
Parámetros de entrada
reminderstringThe unique identifier of the Slack reminder to be marked as complete. This ID is typically obtained when a reminder is created or listed.
Parámetros de salida
dataobjectObligatorioIndicates the outcome of the operation. Contains an 'ok' field which is 'True' if the reminder was successfully marked as complete.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Open DMSLACKBOT_OPEN_DMAcciónOpens or resumes a slack direct message (dm) or multi-person direct message (mpim) by providing either user ids or an existing channel id.
SLACKBOT_OPEN_DMAcciónOpens or resumes a slack direct message (dm) or multi-person direct message (mpim) by providing either user ids or an existing channel id.
Parámetros de entrada
usersstringComma-separated list of user IDs (1 for a DM, or 2-8 for an MPIM) to open/resume a conversation. Order is preserved for MPIMs. Do not use if `channel` is provided.
channelstringID or name of an existing DM or MPIM channel to open/resume. Do not use if `users` is provided.
return_imbooleanIf `true`, returns the full DM channel object. Applies only when opening a DM via a single user ID in `users` (not with `channel`).
Parámetros de salida
dataobjectObligatorioDetails of the opened or resumed conversation, including channel information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Open or resume direct or multi-person messagesSLACKBOT_OPEN_OR_RESUME_DIRECT_OR_MULTI_PERSON_MESSAGESAcciónDeprecated: opens or resumes a slack direct message (dm) or multi-person direct message (mpim). use `open dm` instead.
SLACKBOT_OPEN_OR_RESUME_DIRECT_OR_MULTI_PERSON_MESSAGESAcciónDeprecated: opens or resumes a slack direct message (dm) or multi-person direct message (mpim). use `open dm` instead.
Parámetros de entrada
usersstringComma-separated list of user IDs (1 for a DM, or 2-8 for an MPIM) to open/resume a conversation. Order is preserved for MPIMs. Do not use if `channel` is provided.
channelstringID or name of an existing DM or MPIM channel to open/resume. Do not use if `users` is provided.
return_imbooleanIf `true`, returns the full DM channel object. Applies only when opening a DM via a single user ID in `users` (not with `channel`).
Parámetros de salida
dataobjectObligatorioDetails of the opened or resumed conversation, including channel information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Pin an item to a channelSLACKBOT_PINS_AN_ITEM_TO_A_CHANNELAcciónPins a message to a specified slack channel; the message must not already be pinned.
SLACKBOT_PINS_AN_ITEM_TO_A_CHANNELAcciónPins a message to a specified slack channel; the message must not already be pinned.
Parámetros de entrada
channelstringObligatorioThe ID of the channel where the message will be pinned.
timestampstringTimestamp of the message to pin, in 'epoch_time.microseconds' format (e.g., '1624464000.000200'). If not provided, the most recent message in the channel will be pinned.
Parámetros de salida
dataobjectObligatorioIndicates the outcome of the pin operation, typically confirming success with an 'ok: true' field.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove participants from callSLACKBOT_REGISTER_CALL_PARTICIPANTS_REMOVALAcciónDeprecated: registers participants removed from a slack call. use `remove call participants` instead.
SLACKBOT_REGISTER_CALL_PARTICIPANTS_REMOVALAcciónDeprecated: registers participants removed from a slack call. use `remove call participants` instead.
Parámetros de entrada
idstringObligatorioID of the call returned by the add method.
usersstringObligatorioThe list of users to remove as participants in the call. users is a JSON array with each user having a `slack_id` or `external_id`.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Register a new call with participantsSLACKBOT_REGISTERS_A_NEW_CALL_WITH_PARTICIPANTSAcciónDeprecated: registers a new call in slack using `calls.add` for third-party call integration. use `start call` instead.
SLACKBOT_REGISTERS_A_NEW_CALL_WITH_PARTICIPANTSAcciónDeprecated: registers a new call in slack using `calls.add` for third-party call integration. use `start call` instead.
Parámetros de entrada
titlestringThe name or title for the call. This will be displayed in Slack to identify the call.
usersstringA JSON string representing an array of user objects to be registered as participants in the call. Each user object in the array should define a participant using their `slack_id` (Slack User ID) and/or an `external_id` (an identifier from the third-party application, unique to that user within that application). For instance: `'''[{"slack_id": "U012A3BCD4E"}, {"external_id": "user-xyz@example.com", "slack_id": "U012A3BCD4F"}]'''`.
join_urlstringObligatorioThe URL required for a client to join the call (e.g., a web join link). This field is mandatory.
created_bystringSlack user ID of the creator; optional (defaults to authenticated user) if using a user token, otherwise required.
date_startintegerThe start time of the call, specified as a UTC UNIX timestamp in seconds. For example, `1678886400` corresponds to March 15, 2023, at 12:00 PM UTC.
external_unique_idstringObligatorioA unique identifier for the call, supplied by the third-party call provider. This ID must be unique across all calls from that specific service. This field is required.
external_display_idstringAn optional, human-readable identifier for the call, supplied by the third-party call provider. If provided, this ID will be displayed in the Slack call object interface.
desktop_app_join_urlstringAn optional URL that, when provided, allows Slack clients to attempt to directly launch the third-party call application. This is typically a deep link URI for the specific application.
Parámetros de salida
dataobjectObligatorioWrapper for the API response. The `ok` field confirms successful call registration.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Register new call participantsSLACKBOT_REGISTERS_NEW_CALL_PARTICIPANTSAcciónDeprecated: registers new participants added to a slack call. use `add call participants` instead.
SLACKBOT_REGISTERS_NEW_CALL_PARTICIPANTSAcciónDeprecated: registers new participants added to a slack call. use `add call participants` instead.
Parámetros de entrada
idstringObligatorioID of the call returned by the add method.
usersstringObligatorioThe list of users to add as participants in the call. users is a JSON array (formatted as a string) containing information for each user. Each element should include both a `slack_id` and optionally an `external_id`. For example: `[{"slack_id": "U1H77", "external_id": "ext-id"}]`.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove remote fileSLACKBOT_REMOVE_A_REMOTE_FILEAcciónRemoves the slack reference to an external file (which must have been previously added via the remote files api), specified by either its `external id` or `file` id (one of which is required), without deleting the actual external file.
SLACKBOT_REMOVE_A_REMOTE_FILEAcciónRemoves the slack reference to an external file (which must have been previously added via the remote files api), specified by either its `external id` or `file` id (one of which is required), without deleting the actual external file.
Parámetros de entrada
filestringSlack-specific file ID.
tokenstringAuthentication token.
external_idstringCreator-defined, globally unique ID (GUID) for the file.
Parámetros de salida
dataobjectObligatorioStandard API response; includes `ok: true` on successful removal.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove a star from an itemSLACKBOT_REMOVE_A_STAR_FROM_AN_ITEMAcciónRemoves a star from a previously starred slack item (message, file, file comment, channel, group, or dm), requiring identification via `file`, `file comment`, `channel` (for channel/group/dm), or both `channel` and `timestamp` (for a message).
SLACKBOT_REMOVE_A_STAR_FROM_AN_ITEMAcciónRemoves a star from a previously starred slack item (message, file, file comment, channel, group, or dm), requiring identification via `file`, `file comment`, `channel` (for channel/group/dm), or both `channel` and `timestamp` (for a message).
Parámetros de entrada
filestringID of the file to unstar.
channelstringID of the item (channel, private group, DM) or the message's channel (if `timestamp` is also provided).
timestampstringTimestamp of the message to unstar; requires `channel`.
file_commentstringID of the file comment to unstar.
Parámetros de salida
dataobjectObligatorioIndicates success with an `ok: true` field.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove user from conversationSLACKBOT_REMOVE_A_USER_FROM_A_CONVERSATIONAcciónRemoves a specified user from a slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action.
SLACKBOT_REMOVE_A_USER_FROM_A_CONVERSATIONAcciónRemoves a specified user from a slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action.
Parámetros de entrada
userstringThe ID of the user to be removed from the conversation.
channelstringID of the conversation (channel) to remove the user from.
Parámetros de salida
dataobjectObligatorioWrapper for the response data, which includes an 'ok' field. A value of 'true' for 'ok' indicates the user was successfully removed.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove call participantsSLACKBOT_REMOVE_CALL_PARTICIPANTSAcciónRegisters participants removed from a slack call.
SLACKBOT_REMOVE_CALL_PARTICIPANTSAcciónRegisters participants removed from a slack call.
Parámetros de entrada
idstringObligatorioID of the call returned by the add method.
usersstringObligatorioThe list of users to remove as participants in the call. users is a JSON array with each user having a `slack_id` or `external_id`.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove reaction from itemSLACKBOT_REMOVE_REACTION_FROM_ITEMAcciónRemoves an emoji reaction from a message, file, or file comment in slack.
SLACKBOT_REMOVE_REACTION_FROM_ITEMAcciónRemoves an emoji reaction from a message, file, or file comment in slack.
Parámetros de entrada
filestringID of the file to remove the reaction from.
namestringObligatorioName of the emoji reaction to remove (e.g., 'thumbsup'), without colons.
channelstringChannel ID of the message. Required if `timestamp` is provided.
timestampstringTimestamp of the message. Required if `channel` is provided.
file_commentstringID of the file comment to remove the reaction from.
Parámetros de salida
dataobjectObligatorioAPI response indicating success via an `ok` field.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Rename a Slack channelSLACKBOT_RENAME_A_CHANNELAcciónRenames a public or private slack channel; for enterprise grid workspaces, the user must be a workspace admin or channel manager.
SLACKBOT_RENAME_A_CHANNELAcciónRenames a public or private slack channel; for enterprise grid workspaces, the user must be a workspace admin or channel manager.
Parámetros de entrada
namestringObligatorioThe new name for the channel. Channel names can be up to 80 characters long and may include lowercase letters, numbers, hyphens, and underscores. They cannot contain spaces or periods.
channel_idstringObligatorioThe ID of the channel to rename.
Parámetros de salida
dataobjectObligatorioThe response schema indicating if the operation was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Rename a conversationSLACKBOT_RENAME_A_CONVERSATIONAcciónRenames a slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name.
SLACKBOT_RENAME_A_CONVERSATIONAcciónRenames a slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name.
Parámetros de entrada
namestringNew name for the conversation. Must be 80 characters or less and contain only lowercase letters, numbers, hyphens, and underscores.
channelstringID of the conversation (channel) to rename.
Parámetros de salida
dataobjectObligatorioThe response schema containing the updated channel information and a success status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Rename an emojiSLACKBOT_RENAME_AN_EMOJIAcciónRenames an existing custom emoji in a slack workspace, updating all its instances.
SLACKBOT_RENAME_AN_EMOJIAcciónRenames an existing custom emoji in a slack workspace, updating all its instances.
Parámetros de entrada
namestringObligatorioCurrent name of the custom emoji to be renamed. Colons (e.g., `:current_emoji:`) are optional.
tokenstringObligatorioAuthentication token.
new_namestringObligatorioDesired new name for the custom emoji. Must be unique within the workspace and adhere to Slack's emoji naming conventions.
Parámetros de salida
dataobjectObligatorioIndicates the success of the emoji rename operation with an 'ok' flag.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve a user's identity detailsSLACKBOT_RETRIEVE_A_USER_S_IDENTITY_DETAILSAcciónRetrieves the authenticated user's and their team's identity, with details varying based on oauth scopes (e.g., `identity.basic`, `identity.email`, `identity.avatar`).
SLACKBOT_RETRIEVE_A_USER_S_IDENTITY_DETAILSAcciónRetrieves the authenticated user's and their team's identity, with details varying based on oauth scopes (e.g., `identity.basic`, `identity.email`, `identity.avatar`).
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataarrayObligatorioUser and team identity data; specific fields depend on granted OAuth scopes.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve call informationSLACKBOT_RETRIEVE_CALL_INFORMATIONAcciónRetrieves a point-in-time snapshot of a specific slack call's information.
SLACKBOT_RETRIEVE_CALL_INFORMATIONAcciónRetrieves a point-in-time snapshot of a specific slack call's information.
Parámetros de entrada
idstringObligatorioUnique identifier of the Slack call for which to retrieve information. This ID is typically returned when a call is initiated (e.g., by the `calls.add` method).
Parámetros de salida
dataobjectObligatorioContains the API response. This object includes an `ok` field indicating success, and other dynamic fields representing the detailed information of the retrieved call (e.g., participants, duration, status) due to `extra='allow'` in its schema.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve conversation informationSLACKBOT_RETRIEVE_CONVERSATION_INFORMATIONAcciónRetrieves metadata for a slack conversation by id (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel id.
SLACKBOT_RETRIEVE_CONVERSATION_INFORMATIONAcciónRetrieves metadata for a slack conversation by id (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel id.
Parámetros de entrada
channelstringThe ID of the conversation (channel, direct message, or multi-person direct message) to retrieve information for.
include_localebooleanIf true, the response will include the locale setting for the conversation. Defaults to false.
include_num_membersbooleanIf true, the response will include the number of members in the conversation. Defaults to false.
Parámetros de salida
dataobjectObligatorioContains the detailed information for the requested conversation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get conversation membersSLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LISTAcciónRetrieves a paginated list of active member ids for a specified slack public channel, private channel, direct message (dm), or multi-person direct message (mpim).
SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LISTAcciónRetrieves a paginated list of active member ids for a specified slack public channel, private channel, direct message (dm), or multi-person direct message (mpim).
Parámetros de entrada
limitintegerThe maximum number of members to return per page. Fewer items may be returned than the requested limit, even if more members exist and the end of the list hasn't been reached.
cursorstringPagination cursor value for fetching specific pages of results. To retrieve the next page, provide the `next_cursor` value obtained from the `response_metadata` of the previous API call. If omitted or empty, the first page of members is fetched. For more details on pagination, refer to Slack API documentation.
channelstringID of the conversation (public channel, private channel, direct message, or multi-person direct message) for which to retrieve the member list. Public channel IDs typically start with 'C', private channels or multi-person direct messages (MPIMs) with 'G', and direct messages (DMs) with 'D'.
Parámetros de salida
dataobjectObligatorioThe structured response from the API, containing the list of conversation members and pagination metadata.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve user DND statusSLACKBOT_RETRIEVE_CURRENT_USER_DND_STATUSAcciónRetrieves a slack user's current do not disturb (dnd) status to determine their availability before interaction; any specified user id must be a valid slack user id.
SLACKBOT_RETRIEVE_CURRENT_USER_DND_STATUSAcciónRetrieves a slack user's current do not disturb (dnd) status to determine their availability before interaction; any specified user id must be a valid slack user id.
Parámetros de entrada
userstringUser ID to fetch DND status for. If not provided, fetches the DND status for the authenticated user.
Parámetros de salida
dataobjectObligatorioContains the detailed Do Not Disturb (DND) status information for the user, including DND and snooze states, and relevant timestamps.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve detailed file informationSLACKBOT_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILEAcciónRetrieves detailed metadata and paginated comments for a specific slack file id; does not download file content.
SLACKBOT_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILEAcciónRetrieves detailed metadata and paginated comments for a specific slack file id; does not download file content.
Parámetros de entrada
filestringID of the file to retrieve information for. This is a required field.
pagestringPage number of comment results to retrieve. Expects a string representing an integer (e.g., '2'). Used for comment pagination. Slack's default is 1 if not provided. `cursor`-based pagination is generally preferred.
countstringNumber of comments to retrieve per page. Expects a string representing an integer (e.g., '20'). Used for comment pagination. Slack's default is 100 if not provided.
limitintegerThe maximum number of comments to retrieve. This is an upper limit, not a guarantee of how many will be returned. Primarily used for comment pagination.
cursorstringPagination cursor for retrieving comments. Set to `next_cursor` from a previous response's `response_metadata` to fetch the next page of comments. Essential for navigating through large sets of comments. See [pagination](https://slack.dev) for more details.
Parámetros de salida
dataobjectObligatorioCore response data, including the file object, comments, and related information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve detailed user informationSLACKBOT_RETRIEVE_DETAILED_USER_INFORMATIONAcciónRetrieves comprehensive information for a valid slack user id, excluding message history and channel memberships.
SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATIONAcciónRetrieves comprehensive information for a valid slack user id, excluding message history and channel memberships.
Parámetros de entrada
userstringThe ID of the user to retrieve information for.
include_localebooleanSet to `true` to include the user's locale (e.g., `en-US`) in the response. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioContains the detailed information for the requested user, including profile, status, and team data.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve message permalinkSLACKBOT_RETRIEVE_MESSAGE_PERMALINK_URLAcciónRetrieves a permalink url for a specific message in a slack channel or conversation; the permalink respects slack's privacy settings.
SLACKBOT_RETRIEVE_MESSAGE_PERMALINK_URLAcciónRetrieves a permalink url for a specific message in a slack channel or conversation; the permalink respects slack's privacy settings.
Parámetros de entrada
channelstringObligatorioThe ID of the conversation or channel containing the message. This can be a public channel ID, a private channel ID, a direct message channel ID, or a multi-person direct message channel ID.
message_tsstringObligatorioA message's `ts` value (timestamp), uniquely identifying it within a channel. Example: '1610144875.000600'.
Parámetros de salida
dataobjectObligatorioThe response schema containing the permalink and channel information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve remote file infoSLACKBOT_RETRIEVE_REMOTE_FILE_INFO_IN_SLACKAcciónDeprecated: retrieve information about a remote file added to slack. use `get remote file` instead.
SLACKBOT_RETRIEVE_REMOTE_FILE_INFO_IN_SLACKAcciónDeprecated: retrieve information about a remote file added to slack. use `get remote file` instead.
Parámetros de entrada
filestringSpecify a file by providing its ID.
external_idstringCreator defined GUID for the file.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve team profile detailsSLACKBOT_RETRIEVE_TEAM_PROFILE_DETAILSAcciónRetrieves all profile field definitions for a slack team, optionally filtered by visibility, to understand the team's profile structure.
SLACKBOT_RETRIEVE_TEAM_PROFILE_DETAILSAcciónRetrieves all profile field definitions for a slack team, optionally filtered by visibility, to understand the team's profile structure.
Parámetros de entrada
visibilitystringFilters profile fields by visibility. Use 'all' for all fields (default if unspecified), 'visible' for fields where 'is_hidden' is false/unset, or 'hidden' for fields where 'is_hidden' is true.
Parámetros de salida
dataobjectObligatorioSuccessfully retrieved team profile details, including all field definitions.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve user profile informationSLACKBOT_RETRIEVE_USER_PROFILE_INFORMATIONAcciónRetrieves profile information for a specified slack user (defaults to the authenticated user if `user` id is omitted); a provided `user` id must be valid.
SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATIONAcciónRetrieves profile information for a specified slack user (defaults to the authenticated user if `user` id is omitted); a provided `user` id must be valid.
Parámetros de entrada
userstringUser ID to retrieve profile information for; defaults to the authenticated user.
include_labelsbooleanInclude human-readable labels for custom profile fields. API defaults to false.
Parámetros de salida
dataobjectObligatorioContains the API call's success status and the requested user's profile information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unarchive conversationSLACKBOT_REVERSE_A_CONVERSATION_S_ARCHIVAL_STATUSAcciónDeprecated: reverses conversation archival. use `unarchive channel` instead.
SLACKBOT_REVERSE_A_CONVERSATION_S_ARCHIVAL_STATUSAcciónDeprecated: reverses conversation archival. use `unarchive channel` instead.
Parámetros de entrada
channelstringObligatorioID of conversation to unarchive
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Revoke a file's public urlSLACKBOT_REVOKE_PUBLIC_SHARING_ACCESS_FOR_A_FILEAcciónRevokes a slack file's public url, making it private; this is a no-op if not already public and is irreversible.
SLACKBOT_REVOKE_PUBLIC_SHARING_ACCESS_FOR_A_FILEAcciónRevokes a slack file's public url, making it private; this is a no-op if not already public and is irreversible.
Parámetros de entrada
filestringThe ID of the file for which to revoke the public URL. This unique identifier typically starts with 'F'.
Parámetros de salida
dataobjectObligatorioContains the updated file object reflecting the new sharing status and an 'ok' field indicating the success of the operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Schedule messageSLACKBOT_SCHEDULE_MESSAGEAcciónSchedules a message to a slack channel, dm, or private group for a future time (`post at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance.
SLACKBOT_SCHEDULE_MESSAGEAcciónSchedules a message to a slack channel, dm, or private group for a future time (`post at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance.
Parámetros de entrada
textstringThis sends raw text only, use markdown_text field for formatting. Primary text of the message; formatting with `mrkdwn` applies. Required if `blocks` and `attachments` are not provided.
parsestringMessage text treatment: `full` for special formatting, `none` otherwise (default). See Slack's `chat.postMessage` docs for options.
blocksstring**DEPRECATED**: Use `markdown_text` field instead. JSON array of structured blocks as a URL-encoded string for message layout and design. Required if `text` and `attachments` are not provided.
as_userbooleanPost as the authenticated user, not a bot. Defaults to false. See Slack's `chat.postMessage` docs for authorship.
channelstringChannel, private group, or DM channel ID (e.g., C1234567890) or name (e.g., #general) to send the message to.
post_atstringUnix EPOCH timestamp (integer seconds since 1970-01-01 00:00:00 UTC) for the future message send time.
thread_tsstringTimestamp of the parent message for the scheduled message to be a thread reply. Must be float seconds (e.g., `1234567890.123456`).
link_namesbooleanPass true to automatically link channel names (e.g., #general) and usernames (e.g., @user).
attachmentsstringJSON array of structured attachments as a URL-encoded string for rich content. Required if `text` and `blocks` are not provided.
unfurl_linksbooleanPass false to disable automatic link unfurling. Defaults to true.
unfurl_mediabooleanPass false to disable automatic media unfurling. Defaults to true.
markdown_textstring**PREFERRED**: Write your scheduled message in markdown for nicely formatted display. Supports headers (#), bold (**text**), italic (*text*), strikethrough (~~text~~), code (```), links ([text](url)), quotes (>), and dividers (---). Your message will be posted with beautiful formatting.
reply_broadcastbooleanWith `thread_ts`, makes reply visible to all in channel, not just thread members. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioDetails of the successfully scheduled message
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Schedule message in chatSLACKBOT_SCHEDULES_A_MESSAGE_TO_A_CHANNEL_AT_A_SPECIFIED_TIMEAcciónDeprecated: schedules a message to a slack channel, dm, or private group for a future time. use `schedule message` instead.
SLACKBOT_SCHEDULES_A_MESSAGE_TO_A_CHANNEL_AT_A_SPECIFIED_TIMEAcciónDeprecated: schedules a message to a slack channel, dm, or private group for a future time. use `schedule message` instead.
Parámetros de entrada
textstringThis sends raw text only, use markdown_text field for formatting. Primary text of the message; formatting with `mrkdwn` applies. Required if `blocks` and `attachments` are not provided.
parsestringMessage text treatment: `full` for special formatting, `none` otherwise (default). See Slack's `chat.postMessage` docs for options.
blocksstring**DEPRECATED**: Use `markdown_text` field instead. JSON array of structured blocks as a URL-encoded string for message layout and design. Required if `text` and `attachments` are not provided.
as_userbooleanPost as the authenticated user, not a bot. Defaults to false. See Slack's `chat.postMessage` docs for authorship.
channelstringChannel, private group, or DM channel ID (e.g., C1234567890) or name (e.g., #general) to send the message to.
post_atstringUnix EPOCH timestamp (integer seconds since 1970-01-01 00:00:00 UTC) for the future message send time.
thread_tsstringTimestamp of the parent message for the scheduled message to be a thread reply. Must be float seconds (e.g., `1234567890.123456`).
link_namesbooleanPass true to automatically link channel names (e.g., #general) and usernames (e.g., @user).
attachmentsstringJSON array of structured attachments as a URL-encoded string for rich content. Required if `text` and `blocks` are not provided.
unfurl_linksbooleanPass false to disable automatic link unfurling. Defaults to true.
unfurl_mediabooleanPass false to disable automatic media unfurling. Defaults to true.
markdown_textstring**PREFERRED**: Write your scheduled message in markdown for nicely formatted display. Supports headers (#), bold (**text**), italic (*text*), strikethrough (~~text~~), code (```), links ([text](url)), quotes (>), and dividers (---). Your message will be posted with beautiful formatting.
reply_broadcastbooleanWith `thread_ts`, makes reply visible to all in channel, not just thread members. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioDetails of the successfully scheduled message
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search MessagesSLACKBOT_SEARCH_FOR_MESSAGES_WITH_QUERYAcciónDeprecated: searches messages in a slack workspace using a query with optional modifiers. use `search messages` instead.
SLACKBOT_SEARCH_FOR_MESSAGES_WITH_QUERYAcciónDeprecated: searches messages in a slack workspace using a query with optional modifiers. use `search messages` instead.
Parámetros de entrada
pageintegerPage number of results to return.
sortstringSort results by `score` (relevance) or `timestamp` (chronological).
countintegerNumber of messages to return per page. Maximum value is 100.
querystringObligatorioSearch query, supporting modifiers like `in:#channel-name`, `from:@user-name`, `has::star:`, or `before:YYYY-MM-DD`.
sort_dirstringSort direction: `asc` (ascending) or `desc` (descending).
highlightbooleanEnable highlighting of search terms in results.
Parámetros de salida
dataobjectObligatorioContains search results and related information, such as `messages` and `pagination_info`; its structure may vary.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search messagesSLACKBOT_SEARCH_MESSAGESAcciónWorkspace‑wide slack message search with date ranges and filters. use `query` modifiers (e.g., in:#channel, from:@user, before/after:yyyy-mm-dd), sorting (score/timestamp), and pagination.
SLACKBOT_SEARCH_MESSAGESAcciónWorkspace‑wide slack message search with date ranges and filters. use `query` modifiers (e.g., in:#channel, from:@user, before/after:yyyy-mm-dd), sorting (score/timestamp), and pagination.
Parámetros de entrada
pageintegerPage number of results to return.
sortstringSort results by `score` (relevance) or `timestamp` (chronological).
countintegerNumber of messages to return per page. Maximum value is 100.
querystringObligatorioSearch query, supporting modifiers like `in:#channel-name`, `from:@user-name`, `has::star:`, or `before:YYYY-MM-DD`.
sort_dirstringSort direction: `asc` (ascending) or `desc` (descending).
highlightbooleanEnable highlighting of search terms in results.
Parámetros de salida
dataobjectObligatorioContains search results and related information, such as `messages` and `pagination_info`; its structure may vary.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send ephemeral messageSLACKBOT_SEND_EPHEMERAL_MESSAGEAcciónSends an ephemeral message to a user in a channel.
SLACKBOT_SEND_EPHEMERAL_MESSAGEAcciónSends an ephemeral message to a user in a channel.
Parámetros de entrada
textstringHow this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
userstringObligatorioUser ID of the user to send the ephemeral message to.
parsestringChange how messages are treated. Defaults to none. See below.
blocksstringA JSON-based array of structured blocks, presented as a URL-encoded string.
as_userbooleanPass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
channelstringObligatorioChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
icon_urlstringURL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
usernamestringSet your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
thread_tsstringProvide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
icon_emojistringEmoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
link_namesbooleanFind and link channel names and usernames.
attachmentsstringA JSON-based array of structured attachments, presented as a URL-encoded string.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send messageSLACKBOT_SEND_MESSAGEAcciónPosts a message to a slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`.
SLACKBOT_SEND_MESSAGEAcciónPosts a message to a slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`.
Parámetros de entrada
textstringDEPRECATED: This sends raw text only, use markdown_text field. Primary textual content. Recommended fallback if using `blocks` or `attachments`. Supports mrkdwn unless `mrkdwn` is `false`.
parsestringMessage text parsing behavior. Default `none` (no special parsing). `full` parses as user-typed (links @mentions, #channels). See Slack API docs for details.
blocksstringDEPRECATED: Use `markdown_text` field instead. URL-encoded JSON array of layout blocks for rich/interactive messages. See Slack API Block Kit docs for structure.
mrkdwnbooleanDisable Slack's markdown for `text` field if `false`. Default `true` (allows *bold*, _italic_, etc.).
as_userbooleanPost as the authenticated user instead of as a bot. Defaults to `false`. If `true`, `username`, `icon_emoji`, and `icon_url` are ignored. If `false`, the message is posted as a bot, allowing appearance customization.
channelstringObligatorioID or name of the channel, private group, or IM channel to send the message to.
icon_urlstringImage URL for bot's icon (must be HTTPS). Applies if `as_user` is `false`.
usernamestringBot's name in Slack (max 80 chars). Applies if `as_user` is `false`.
thread_tsstringTimestamp (`ts`) of an existing message to make this a threaded reply. Use `ts` of the parent message, not another reply. Example: '1476746824.000004'.
icon_emojistringEmoji for bot's icon (e.g., ':robot_face:'). Overrides `icon_url`. Applies if `as_user` is `false`.
link_namesbooleanAutomatically hyperlink channel names (e.g., #channel) and usernames (e.g., @user) in message text. Defaults to `false` for bot messages.
attachmentsstringURL-encoded JSON array of message attachments, a legacy method for rich content. See Slack API documentation for structure.
unfurl_linksbooleanEnable unfurling of text-based URLs. Defaults `false` for bots, `true` if `as_user` is `true`.
unfurl_mediabooleanDisable unfurling of media content from URLs if `false`. Defaults to `true`.
markdown_textstringPREFERRED: Write your message in markdown for nicely formatted display. Supports: headers (# ## ###), bold (**text** or __text__), italic (*text* or _text_), strikethrough (~~text~~), inline code (`code`), code blocks (```), links ([text](url)), block quotes (>), lists (- item, 1. item), dividers (--- or ***), context blocks (:::context with images), and section buttons (:::section-button). IMPORTANT: Use \n for line breaks (e.g., 'Line 1\nLine 2'), not actual newlines. USER MENTIONS: To tag users, use their user ID with <@USER_ID> format (e.g., <@U1234567890>), not username.
reply_broadcastbooleanIf `true` for a threaded reply, also posts to main channel. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioContains the posted message details including the message object and metadata like channel ID and timestamp.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send a message to a Slack channelSLACKBOT_SENDS_A_MESSAGE_TO_A_CHANNELAcciónDeprecated: posts a message to a slack channel, direct message, or private group. use `send message` instead.
SLACKBOT_SENDS_A_MESSAGE_TO_A_CHANNELAcciónDeprecated: posts a message to a slack channel, direct message, or private group. use `send message` instead.
Parámetros de entrada
textstringDEPRECATED: This sends raw text only, use markdown_text field. Primary textual content. Recommended fallback if using `blocks` or `attachments`. Supports mrkdwn unless `mrkdwn` is `false`.
parsestringMessage text parsing behavior. Default `none` (no special parsing). `full` parses as user-typed (links @mentions, #channels). See Slack API docs for details.
blocksstringDEPRECATED: Use `markdown_text` field instead. URL-encoded JSON array of layout blocks for rich/interactive messages. See Slack API Block Kit docs for structure.
mrkdwnbooleanDisable Slack's markdown for `text` field if `false`. Default `true` (allows *bold*, _italic_, etc.).
as_userbooleanPost as the authenticated user instead of as a bot. Defaults to `false`. If `true`, `username`, `icon_emoji`, and `icon_url` are ignored. If `false`, the message is posted as a bot, allowing appearance customization.
channelstringObligatorioID or name of the channel, private group, or IM channel to send the message to.
icon_urlstringImage URL for bot's icon (must be HTTPS). Applies if `as_user` is `false`.
usernamestringBot's name in Slack (max 80 chars). Applies if `as_user` is `false`.
thread_tsstringTimestamp (`ts`) of an existing message to make this a threaded reply. Use `ts` of the parent message, not another reply. Example: '1476746824.000004'.
icon_emojistringEmoji for bot's icon (e.g., ':robot_face:'). Overrides `icon_url`. Applies if `as_user` is `false`.
link_namesbooleanAutomatically hyperlink channel names (e.g., #channel) and usernames (e.g., @user) in message text. Defaults to `false` for bot messages.
attachmentsstringURL-encoded JSON array of message attachments, a legacy method for rich content. See Slack API documentation for structure.
unfurl_linksbooleanEnable unfurling of text-based URLs. Defaults `false` for bots, `true` if `as_user` is `true`.
unfurl_mediabooleanDisable unfurling of media content from URLs if `false`. Defaults to `true`.
markdown_textstringPREFERRED: Write your message in markdown for nicely formatted display. Supports: headers (# ## ###), bold (**text** or __text__), italic (*text* or _text_), strikethrough (~~text~~), inline code (`code`), code blocks (```), links ([text](url)), block quotes (>), lists (- item, 1. item), dividers (--- or ***), context blocks (:::context with images), and section buttons (:::section-button). IMPORTANT: Use \n for line breaks (e.g., 'Line 1\nLine 2'), not actual newlines. USER MENTIONS: To tag users, use their user ID with <@USER_ID> format (e.g., <@U1234567890>), not username.
reply_broadcastbooleanIf `true` for a threaded reply, also posts to main channel. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioContains the posted message details including the message object and metadata like channel ID and timestamp.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send an ephemeral messageSLACKBOT_SENDS_EPHEMERAL_MESSAGES_TO_CHANNEL_USERSAcciónDeprecated: sends an ephemeral message to a user in a channel. use `send ephemeral message` instead.
SLACKBOT_SENDS_EPHEMERAL_MESSAGES_TO_CHANNEL_USERSAcciónDeprecated: sends an ephemeral message to a user in a channel. use `send ephemeral message` instead.
Parámetros de entrada
textstringHow this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
userstringObligatorioUser ID of the user to send the ephemeral message to.
parsestringChange how messages are treated. Defaults to none. See below.
blocksstringA JSON-based array of structured blocks, presented as a URL-encoded string.
as_userbooleanPass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
channelstringObligatorioChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
icon_urlstringURL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
usernamestringSet your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
thread_tsstringProvide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
icon_emojistringEmoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
link_namesbooleanFind and link channel names and usernames.
attachmentsstringA JSON-based array of structured attachments, presented as a URL-encoded string.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set a conversation's purposeSLACKBOT_SET_A_CONVERSATION_S_PURPOSEAcciónSets the purpose (a short description of its topic/goal, displayed in the header) for a slack conversation; the calling user must be a member.
SLACKBOT_SET_A_CONVERSATION_S_PURPOSEAcciónSets the purpose (a short description of its topic/goal, displayed in the header) for a slack conversation; the calling user must be a member.
Parámetros de entrada
channelstringThe ID of the conversation (channel, direct message, or group message) to set the purpose for.
purposestringThe new purpose for the conversation. This text will be displayed as the channel description. The maximum length is 250 characters.
Parámetros de salida
dataobjectObligatorioThe response data containing the updated conversation information and a success status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set DND durationSLACKBOT_SET_DND_DURATIONAcciónTurns on do not disturb mode for the current user, or changes its duration.
SLACKBOT_SET_DND_DURATIONAcciónTurns on do not disturb mode for the current user, or changes its duration.
Parámetros de entrada
num_minutesstringObligatorioNumber of minutes, from now, to snooze until.
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set profile photoSLACKBOT_SET_PROFILE_PHOTOAcciónThis method allows the user to set their profile image.
SLACKBOT_SET_PROFILE_PHOTOAcciónThis method allows the user to set their profile image.
Parámetros de entrada
imagestringObligatorioFile contents via a POST var called image.
crop_wintegerWidth/height of crop box (always square)
crop_xintegerX coordinate of top-left corner of crop box
crop_yintegerY coordinate of top-left corner of crop box
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set conversation read cursorSLACKBOT_SET_READ_CURSOR_IN_A_CONVERSATIONAcciónMarks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it.
SLACKBOT_SET_READ_CURSOR_IN_A_CONVERSATIONAcciónMarks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it.
Parámetros de entrada
tsintegerThe timestamp of the message to mark as the most recently read. This is typically a Unix timestamp with microsecond precision (e.g., '1625800000.000200').
channelstringThe ID of the public channel, private channel, or direct message to set the read cursor for.
Parámetros de salida
dataobjectObligatorioContains a boolean field `ok` which is `true` if the read cursor was successfully set.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set conversation topicSLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATIONAcciónSets or updates the topic for a specified slack conversation.
SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATIONAcciónSets or updates the topic for a specified slack conversation.
Parámetros de entrada
topicstringThe new topic for the conversation. It must be a string up to 250 characters long. Text formatting and linkification are not supported.
channelstringThe ID of the public channel, private channel, direct message, or multi-person direct message conversation for which the topic will be set.
Parámetros de salida
dataobjectObligatorioContains the status of the operation and details of the conversation with the updated topic.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set Slack user profile informationSLACKBOT_SET_USER_PROFILE_INFORMATIONAcciónUpdates a slack user's profile, setting either individual fields or multiple fields via a json object.
SLACKBOT_SET_USER_PROFILE_INFORMATIONAcciónUpdates a slack user's profile, setting either individual fields or multiple fields via a json object.
Parámetros de entrada
namestringName of a single profile field to set. Use with `value` if `profile` is not provided.
userstringID of the user whose profile will be updated; defaults to authenticated user. Team admins on paid teams can specify another member's ID.
valuestringValue for the single profile field specified by `name`. Use with `name` if `profile` is not provided.
profilestringURL-encoded JSON string of key-value pairs for profile fields to update (max 50 fields, 255 chars per field name). If provided, `name` and `value` are ignored.
Parámetros de salida
dataobjectObligatorioAPI call success status and updated user profile data.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set the user's profile imageSLACKBOT_SET_USER_PROFILE_PHOTO_WITH_CROPPING_OPTIONSAcciónDeprecated: this method allows the user to set their profile image. use `set profile photo` instead.
SLACKBOT_SET_USER_PROFILE_PHOTO_WITH_CROPPING_OPTIONSAcciónDeprecated: this method allows the user to set their profile image. use `set profile photo` instead.
Parámetros de entrada
imagestringObligatorioFile contents via a POST var called image.
crop_wintegerWidth/height of crop box (always square)
crop_xintegerX coordinate of top-left corner of crop box
crop_yintegerY coordinate of top-left corner of crop box
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Share a me message in a channelSLACKBOT_SHARE_A_ME_MESSAGE_IN_A_CHANNELAcciónSends a 'me message' (e.g., '/me is typing') to a slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible.
SLACKBOT_SHARE_A_ME_MESSAGE_IN_A_CHANNELAcciónSends a 'me message' (e.g., '/me is typing') to a slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible.
Parámetros de entrada
textstringContent of the 'me message', displayed as an action performed by the user (e.g., if text is 'is feeling happy', it appears as '*User is feeling happy*').
channelstringSpecifies the target channel by its public ID (e.g., 'C1234567890'), private group ID, IM channel ID, or name (e.g., '#general', '@username').
Parámetros de salida
dataobjectObligatorioContains the detailed response from the Slack API, including the channel ID and timestamp of the posted 'me message'.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Share a remote file in channelsSLACKBOT_SHARE_REMOTE_FILE_IN_CHANNELSAcciónShares a remote file, which must already be registered with slack, into specified slack channels or direct message conversations.
SLACKBOT_SHARE_REMOTE_FILE_IN_CHANNELSAcciónShares a remote file, which must already be registered with slack, into specified slack channels or direct message conversations.
Parámetros de entrada
filestringThe unique ID of the remote file registered with Slack. Either this `file` field or the `external_id` field (or both) is required to identify the file.
channelsstringA comma-separated list of channel IDs where the remote file will be shared. These can include public channel IDs, private channel IDs, or direct message channel IDs.
external_idstringThe globally unique identifier (GUID) for the remote file, as provided by the app that registered it with Slack. Either this `external_id` field or the `file` field (or both) is required to identify the file.
Parámetros de salida
dataobjectObligatorioContains the standard Slack API response, usually an 'ok' field indicating success.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Start callSLACKBOT_START_CALLAcciónRegisters a new call in slack using `calls.add` for third-party call integration; `created by` is required if not using a user-specific token.
SLACKBOT_START_CALLAcciónRegisters a new call in slack using `calls.add` for third-party call integration; `created by` is required if not using a user-specific token.
Parámetros de entrada
titlestringThe name or title for the call. This will be displayed in Slack to identify the call.
usersstringA JSON string representing an array of user objects to be registered as participants in the call. Each user object in the array should define a participant using their `slack_id` (Slack User ID) and/or an `external_id` (an identifier from the third-party application, unique to that user within that application). For instance: `'''[{"slack_id": "U012A3BCD4E"}, {"external_id": "user-xyz@example.com", "slack_id": "U012A3BCD4F"}]'''`.
join_urlstringObligatorioThe URL required for a client to join the call (e.g., a web join link). This field is mandatory.
created_bystringSlack user ID of the creator; optional (defaults to authenticated user) if using a user token, otherwise required.
date_startintegerThe start time of the call, specified as a UTC UNIX timestamp in seconds. For example, `1678886400` corresponds to March 15, 2023, at 12:00 PM UTC.
external_unique_idstringObligatorioA unique identifier for the call, supplied by the third-party call provider. This ID must be unique across all calls from that specific service. This field is required.
external_display_idstringAn optional, human-readable identifier for the call, supplied by the third-party call provider. If provided, this ID will be displayed in the Slack call object interface.
desktop_app_join_urlstringAn optional URL that, when provided, allows Slack clients to attempt to directly launch the third-party call application. This is typically a deep link URI for the specific application.
Parámetros de salida
dataobjectObligatorioWrapper for the API response. The `ok` field confirms successful call registration.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Start real time messaging sessionSLACKBOT_START_REAL_TIME_MESSAGING_SESSIONAcciónInitiates a slack rtm session providing a single-use websocket url (valid 30s) for event streaming; does not set initial presence status.
SLACKBOT_START_REAL_TIME_MESSAGING_SESSIONAcciónInitiates a slack rtm session providing a single-use websocket url (valid 30s) for event streaming; does not set initial presence status.
Parámetros de entrada
presence_subbooleanDelivers presence events only for explicitly subscribed users if `True`. See Slack's [presence subscriptions](https://slack.dev) documentation.
batch_presence_awarebooleanEnables batching of presence status deliveries for subscribed users if `True`, altering `presence_change` event structure. See Slack's [batch presence](https://slack.dev) documentation.
Parámetros de salida
dataobjectObligatorioThe core response data containing the WebSocket URL, along with user and team information for the RTM session.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unarchive a public or private channelSLACKBOT_UNARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónUnarchives a specified public or private slack channel that is currently archived, using its channel id.
SLACKBOT_UNARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNELAcciónUnarchives a specified public or private slack channel that is currently archived, using its channel id.
Parámetros de entrada
channel_idstringObligatorioThe unique identifier of the public or private channel to be unarchived.
Parámetros de salida
dataobjectObligatorioThe response payload indicating the outcome of the unarchive operation.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unarchive channelSLACKBOT_UNARCHIVE_CHANNELAcciónReverses conversation archival.
SLACKBOT_UNARCHIVE_CHANNELAcciónReverses conversation archival.
Parámetros de entrada
channelstringObligatorioID of conversation to unarchive
Parámetros de salida
dataobjectObligatorioResponse data
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unpin message from channelSLACKBOT_UNPIN_ITEM_FROM_CHANNELAcciónUnpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive.
SLACKBOT_UNPIN_ITEM_FROM_CHANNELAcciónUnpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive.
Parámetros de entrada
channelstringObligatorioThe ID of the channel where the message is pinned (e.g., a public channel, private channel, or direct message).
timestampstringTimestamp of the message to unpin. This is required to identify the specific message to be removed from the channel's pinned items.
Parámetros de salida
dataobjectObligatorioThe response from Slack API, typically indicating if the unpin operation was successful.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update Slack user groupSLACKBOT_UPDATE_AN_EXISTING_USER_GROUPAcciónUpdates an existing slack user group, which must be specified by an existing `usergroup` id, with new optional details such as its name, description, handle, or default channels.
SLACKBOT_UPDATE_AN_EXISTING_USER_GROUPAcciónUpdates an existing slack user group, which must be specified by an existing `usergroup` id, with new optional details such as its name, description, handle, or default channels.
Parámetros de entrada
namestringNew name for the User Group. Must be unique among User Groups.
handlestringNew mention handle. Must be unique among channels, users, and User Groups.
channelsstringComma-separated encoded channel IDs to set as default channels.
usergroupstringObligatorioEncoded ID of the existing User Group to update.
descriptionstringNew short description for the User Group.
include_countbooleanIf true, include the number of users in the User Group in the response.
Parámetros de salida
dataobjectObligatorioThe outcome of the update operation and the updated User Group details.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update call informationSLACKBOT_UPDATE_CALL_INFORMATIONAcciónUpdates the title, join url, or desktop app join url for an existing slack call identified by its id.
SLACKBOT_UPDATE_CALL_INFORMATIONAcciónUpdates the title, join url, or desktop app join url for an existing slack call identified by its id.
Parámetros de entrada
idstringObligatorioUnique identifier of the call to update, obtained when a call is created (e.g., via `calls.add` Slack API method).
titlestringNew title for the call.
join_urlstringNew URL for clients to join the call.
desktop_app_join_urlstringURL to directly launch the third-party call application from Slack clients.
Parámetros de salida
dataobjectObligatorioContains the response from the Slack API, typically indicating the success status of the update operation (e.g., `{'ok': true}`).
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update a Slack messageSLACKBOT_UPDATES_A_MESSAGEAcciónUpdates a slack message, identified by `channel` id and `ts` timestamp, by modifying its `text`, `attachments`, or `blocks`; provide at least one content field, noting `attachments`/`blocks` are replaced if included (`[]` clears them).
SLACKBOT_UPDATES_A_MESSAGEAcciónUpdates a slack message, identified by `channel` id and `ts` timestamp, by modifying its `text`, `attachments`, or `blocks`; provide at least one content field, noting `attachments`/`blocks` are replaced if included (`[]` clears them).
Parámetros de entrada
tsstringObligatorioTimestamp of the message to update (string, Unix time with microseconds, e.g., `'1234567890.123456'`).
textstringThis sends raw text only, use markdown_text field for formatting. New message text (plain or mrkdwn). Not required if `blocks` or `attachments` are provided. See Slack formatting rules.
parsestringParse mode for `text`: `'full'` (mrkdwn) or `'none'` (literal). If not provided, defaults to `'client'` behavior, overriding original message's `parse` setting.
blocksstring**DEPRECATED**: Use `markdown_text` field instead. URL-encoded JSON array of layout blocks. Replaces existing blocks if field is provided; use `[]` (empty array string) to clear. Omit field to leave blocks untouched. Required if `text` and `attachments` are absent. See Slack API for format.
as_userstringSet to `'true'` to update as the authenticated user (bots are considered such). Defaults to app/bot identity.
channelstringObligatorioThe ID of the channel containing the message to be updated.
link_namesstringSet to `'true'` to link channel/user names in `text`. If not provided, Slack's default update behavior may override original message's linking settings.
attachmentsstringURL-encoded JSON array of attachments. Replaces existing attachments if field is provided; use `[]` (empty array string) to clear. Omit field to leave attachments untouched. Required if `text` and `blocks` are absent. See Slack API for format.
markdown_textstring**PREFERRED**: Write your updated message in markdown for nicely formatted display. Supports headers (#), bold (**text**), italic (*text*), strikethrough (~~text~~), code (```), links ([text](url)), quotes (>), and dividers (---). Your message will be posted with beautiful formatting.
Parámetros de salida
dataobjectObligatorioThe response data containing details of the updated message.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update an existing remote fileSLACKBOT_UPDATES_AN_EXISTING_REMOTE_FILEAcciónUpdates metadata or content details for an existing remote file in slack; this action cannot upload new files or change the fundamental file type.
SLACKBOT_UPDATES_AN_EXISTING_REMOTE_FILEAcciónUpdates metadata or content details for an existing remote file in slack; this action cannot upload new files or change the fundamental file type.
Parámetros de entrada
filestringSlack's unique identifier for the remote file (e.g., `F12345678`). Used to identify the file if `external_id` is not provided. One of `file` or `external_id` is required to specify the file to update.
titlestringNew title for the remote file. If omitted, the current title remains unchanged.
tokenstringAuthentication token for authorizing the API request to Slack.
filetypestringNew filetype for the remote file. This typically describes the kind of file, e.g., `pdf`, `gdoc`, `image`, `text`. See Slack API documentation for specific supported `filetype` values. Providing an inaccurate filetype might affect how the file is handled or displayed.
external_idstringCreator-defined Globally Unique Identifier (GUID) for the remote file. Used to identify the file if `file` ID is not provided. One of `file` or `external_id` is required to specify the file to update.
external_urlstringNew publicly accessible URL for the remote file. If provided, this updates the link associated with the file in Slack.
preview_imagestringA string that references the new preview image for the document. The referenced image data will be sent as `multipart/form-data`. This could be a local file path (if supported by the client), a public URL, or base64 encoded image data. Max 1MB. Updates the file's preview in Slack.
indexable_file_contentsstringPlain text content extracted from the remote file, used by Slack to improve searchability. This can be a summary or the full text. Maximum 1MB. If provided, updates the searchable content.
Parámetros de salida
dataobjectObligatorioStandard Slack API response wrapper. The `ok` field within indicates success.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update user group membersSLACKBOT_UPDATE_USER_GROUP_MEMBERSAcciónReplaces all members of an existing slack user group with a new list of valid user ids.
SLACKBOT_UPDATE_USER_GROUP_MEMBERSAcciónReplaces all members of an existing slack user group with a new list of valid user ids.
Parámetros de entrada
usersstringObligatorioComma-separated string of encoded user IDs for the new, complete member list, replacing all existing members. User IDs typically start with 'U' or 'W'.
usergroupstringObligatorioThe encoded ID of the User Group whose members are to be updated. This ID typically starts with 'S'.
include_countbooleanIf true, the response `usergroup` object includes `user_count` and potentially `channel_count` fields, reflecting counts after the update.
Parámetros de salida
dataobjectObligatorioContains the API response data, primarily the updated `usergroup` object detailing the User Group after the member update.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upload or create a file in SlackSLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACKAcciónUploads a file to slack, requiring either `content` (for text) or `file` (for binary data), optionally sharing it in specified `channels` or as a reply via `thread ts`.
SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACKAcciónUploads a file to slack, requiring either `content` (for text) or `file` (for binary data), optionally sharing it in specified `channels` or as a reply via `thread ts`.
Parámetros de entrada
filestringBinary file content as multipart/form-data; use for non-text files. Omit if `content` is used. Provide actual file content, not a path.
titlestringTitle of the file, displayed in Slack.
tokenstringAuthentication token; requires `files:write` scope.
contentstringText content of the file; use for text-based files. Omit if `file` is used.
channelsstringComma-separated channel names or IDs for sharing; if omitted, file is private to the uploader.
filenamestringFilename to be displayed in Slack.
filetypestringSlack file type (e.g., 'text', 'pdf'); Slack auto-detects if omitted. Refer to Slack API for full list.
thread_tsintegerTimestamp of a parent message to upload this file as a reply; use the original message's `ts`.
initial_commentstringOptional message to introduce the file in specified `channels`.
Parámetros de salida
dataobjectObligatorioContains the details of the uploaded file and the request status.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Triggers (9)
Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).
New Channel Created TriggerSLACKBOT_CHANNEL_CREATEDTriggerTriggered when a new channel is created in Slack.
SLACKBOT_CHANNEL_CREATEDTriggerTriggered when a new channel is created in Slack.
Configuración
Sin parámetros.
Payload del evento
createdintegerObligatorioThe timestamp of when the channel was created, formatted as a Unix timestamp
creatorstringObligatorioThe ID of the user who created the channel
idstringObligatorioThe ID of the channel
namestringObligatorioThe name of the channel
Instrucciones
**Instructions for Setting Up the Trigger:** - If you are using your own Slack app: 1. Go to the 'Event Subscriptions' section of your app's settings. 2. Enable events. 3. Input the 'Request URL' field with `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle` 4. Add `channel_created` to the 'Subscribe to bot events' section and `Subscribe to events on behalf of users` section and save. - If you are using the Composio Slack app, you are all set here! - If you are using Slackbot integration, you would need to add the Slack app to the channels you want to monitor. In case using Composio Slack app, you need to do /add and then choose Composio App.
Channel Message ReceivedSLACKBOT_CHANNEL_MESSAGE_RECEIVEDTriggerTriggered when a message is posted in a Slack channel
(public, private, or multi-party IM). Does NOT match direct messages.
SLACKBOT_CHANNEL_MESSAGE_RECEIVEDTriggerTriggered when a message is posted in a Slack channel (public, private, or multi-party IM). Does NOT match direct messages.
Configuración
channel_idstringSpecific channel to watch. Null = all channels.
channel_typestringenumFilter by channel type. channel = public, group = private, mpim = multi-party IM. Null = all types.
channelgroupmpimis_bot_messagebooleanFilter by message source. true = only bot messages, false = only human messages, null = all.
is_thread_replybooleanFilter by thread status. true = only thread replies, false = only top-level, null = all.
Payload del evento
attachmentsobject[]blocksobject[]bot_idstringchannelstringObligatoriochannel_typestringfilesobject[]subtypestringteam_idstringtextstringthread_tsstringtsstringObligatoriouserstring
Instrucciones
To use this trigger, ensure your Slack app has the `channels:history`, `groups:history`, and `mpim:history` OAuth scopes.
Direct Message ReceivedSLACKBOT_DIRECT_MESSAGE_RECEIVEDTriggerTriggered when a new direct message (DM) is sent to a user in Slack.
Catches all DMs across all DM channels.
SLACKBOT_DIRECT_MESSAGE_RECEIVEDTriggerTriggered when a new direct message (DM) is sent to a user in Slack. Catches all DMs across all DM channels.
Configuración
Sin parámetros.
Payload del evento
attachmentsobject[]Attachments included with the direct message, if any. Some Slack apps (like Datadog) send content via attachments rather than the top-level text field.
bot_idanyObligatorioThe ID of the bot that sent the direct message
channelstringObligatorioThe ID of the direct message channel
channel_typeanyObligatorioThe type of the channel (should be 'im' for direct messages)
filesobject[]Files uploaded with the direct message, if any. Present when subtype is 'file_share'. Contains file metadata including name, mimetype, and URLs.
team_idanyObligatorioThe ID of the team where the direct message was sent
textstringObligatorioThe text content of the direct message
tsstringObligatorioThe timestamp of the direct message
useranyObligatorioThe ID of the user who sent the direct message
Instrucciones
To use this trigger, ensure your Slack app has the `im:history` OAuth scope.
Message Reaction AddedSLACKBOT_MESSAGE_REACTION_ADDEDTriggerTriggered when a reaction is added to a message in Slack.
Supports optional filtering by channel and emoji name.
SLACKBOT_MESSAGE_REACTION_ADDEDTriggerTriggered when a reaction is added to a message in Slack. Supports optional filtering by channel and emoji name.
Configuración
channel_idstringSpecific channel to watch. Null = all channels.
emoji_namestringFilter by emoji short name (e.g. 'thumbsup', 'tada'). Null = all reactions.
Payload del evento
event_tsstringObligatorioThe timestamp of the reaction event
message_channelstringObligatorioThe ID of the channel where the reacted-to message is located
message_tsstringObligatorioThe timestamp of the message that was reacted to
message_userstringThe ID of the user who owns the message that was reacted to
reactionstringObligatorioThe emoji short name of the reaction that was added
team_idstringThe ID of the team where the reaction occurred
userstringObligatorioThe ID of the user who added the reaction
Instrucciones
To use this trigger, ensure your Slack app has the `reactions:read` OAuth scope (and the relevant history scopes for the channels you want to monitor).
Message Reaction RemovedSLACKBOT_MESSAGE_REACTION_REMOVEDTriggerTriggered when a reaction is removed from a message in Slack.
Supports optional filtering by channel and emoji name.
SLACKBOT_MESSAGE_REACTION_REMOVEDTriggerTriggered when a reaction is removed from a message in Slack. Supports optional filtering by channel and emoji name.
Configuración
channel_idstringSpecific channel to watch. Null = all channels.
emoji_namestringFilter by emoji short name (e.g. 'thumbsup', 'tada'). Null = all reactions.
Payload del evento
event_tsstringObligatorioThe timestamp of the reaction event
message_channelstringObligatorioThe ID of the channel where the reacted-to message is located
message_tsstringObligatorioThe timestamp of the message that was reacted to
message_userstringThe ID of the user who owns the message that was reacted to
reactionstringObligatorioThe emoji short name of the reaction that was removed
team_idstringThe ID of the team where the reaction occurred
userstringObligatorioThe ID of the user who removed the reaction
Instrucciones
To use this trigger, ensure your Slack app has the `reactions:read` OAuth scope (and the relevant history scopes for the channels you want to monitor).
Reaction Added TriggerSLACKBOT_REACTION_ADDEDTriggerDEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead.
Triggered when a reaction is added to a message in Slack.
SLACKBOT_REACTION_ADDEDTriggerDEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead. Triggered when a reaction is added to a message in Slack.
Configuración
Sin parámetros.
Payload del evento
bot_idanyObligatorioThe ID of the bot that posted the message
channel_typeanyObligatorioThe type of the channel where the message was posted
event_tsstringObligatorioThe timestamp of the reaction event. Formatted as a Unix timestamp
message_channelstringObligatorioThe ID of the channel where the message that was reacted to is located
message_tsstringObligatorioThe timestamp of the message that was reacted to. Formatted as a Unix timestamp
message_userstringThe ID of the user who owns the message that was reacted to. Slack omits this for reactions on items posted without an owning user (e.g. file shares, system messages, or app-posted messages).
reactionstringObligatorioThe type of reaction that was added
team_idanyObligatorioThe ID of the team where the message was posted
useranyObligatorioThe ID of the user who added the reaction
Instrucciones
**Instructions for Setting Up the Trigger:** - If you are using your own Slack app: 1. Go to the 'Event Subscriptions' section of your app's settings. 2. Enable events. 3. Input the 'Request URL' field with `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle` 4. Add `reaction_added` to the 'Subscribe to bot events' section and `Subscribe to events on behalf of users` section and save. - If you are using the Composio Slack app, you are all set here! - If you are using Slackbot integration, you would need to add the Slack app to the channels you want to monitor. In case using Composio Slack app, you need to do /add and then choose Composio App.
Reaction Removed TriggerSLACKBOT_REACTION_REMOVEDTriggerDEPRECATED: use `SLACK_MESSAGE_REACTION_REMOVED` instead.
Triggered when a reaction is removed from a message.
SLACKBOT_REACTION_REMOVEDTriggerDEPRECATED: use `SLACK_MESSAGE_REACTION_REMOVED` instead. Triggered when a reaction is removed from a message.
Configuración
Sin parámetros.
Payload del evento
bot_idanyObligatorioThe ID of the bot that posted the message
channel_typeanyObligatorioThe type of the channel where the message was posted
event_tsstringObligatorioThe timestamp of the reaction event. Formatted as a Unix timestamp
message_channelstringObligatorioThe ID of the channel where the message that was reacted to is located
message_tsstringObligatorioThe timestamp of the message that was reacted to. Formatted as a Unix timestamp
message_userstringThe ID of the user who owns the message that was reacted to. Slack omits this for reactions on items posted without an owning user (e.g. file shares, system messages, or app-posted messages).
reactionstringObligatorioThe type of reaction that was added
team_idanyObligatorioThe ID of the team where the message was posted
useranyObligatorioThe ID of the user who added the reaction
Instrucciones
**Instructions for Setting Up the Trigger:** - If you are using your own Slack app: 1. Go to the 'Event Subscriptions' section of your app's settings. 2. Enable events. 3. Input the 'Request URL' field with `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle` 4. Add `reaction_removed` to the 'Subscribe to bot events' section and `Subscribe to events on behalf of users` section and save. - If you are using the Composio Slack app, you are all set here! - If you are using Slackbot integration, you would need to add the Slack app to the channels you want to monitor. In case using Composio Slack app, you need to do /add and then choose Composio App.
New Bot Message Received TriggerSLACKBOT_RECEIVE_BOT_MESSAGETriggerDEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with
`is_bot_message=true` instead.
Triggered when a new bot message is posted to a Slack channel.
SLACKBOT_RECEIVE_BOT_MESSAGETriggerDEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with `is_bot_message=true` instead. Triggered when a new bot message is posted to a Slack channel.
Configuración
Sin parámetros.
Payload del evento
attachmentsobject[]Attachments included with the bot message, if any. Slack apps (like Datadog) often send their content via attachments rather than the top-level text field.
bot_idstringThe ID of the bot that posted the message
channelstringObligatorioThe ID of the channel where the bot message was posted
channel_typestringThe type of the channel where the bot message was posted
filesobject[]Files uploaded with the bot message, if any. Present when subtype is 'file_share'. Contains file metadata including name, mimetype, and URLs.
subtypestringObligatorioThe subtype of the message (should be 'bot_message')
team_idstringThe ID of the team where the bot message was posted
textstringObligatorioThe text content of the bot message
tsstringObligatorioThe timestamp of the bot message
usernamestringThe username of the bot that posted the message
Instrucciones
**Instructions for Setting Up the Trigger:** - If you are using your own Slack app: 1. Go to the 'Event Subscriptions' section of your app's settings. 2. Enable events. 3. Input the 'Request URL' field with `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle` 4. Add `message.channels` to the 'Subscribe to bot events' section and `Subscribe to events on behalf of users` section and save. - If you are using the Composio Slack app, you are all set here! - If you are using Slackbot integration, you would need to add the Slack app to the channels you want to monitor. In case using Composio Slack app, you need to do /add and then choose Composio App.
New Message Received TriggerSLACKBOT_RECEIVE_MESSAGETriggerDEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead.
Triggered when a new message is posted to a Slack channel.
SLACKBOT_RECEIVE_MESSAGETriggerDEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead. Triggered when a new message is posted to a Slack channel.
Configuración
Sin parámetros.
Payload del evento
attachmentsobject[]Attachments included with the message, if any. Some Slack apps (like Datadog) send content via attachments rather than the top-level text field.
bot_idstringThe ID of the bot that posted the message
channelstringObligatorioThe ID of the channel where the message was posted
channel_typestringThe type of the channel where the message was posted
filesobject[]Files uploaded with the message, if any. Present when subtype is 'file_share'. Contains file metadata including name, mimetype, and URLs.
team_idstringThe ID of the team where the message was posted
textstringObligatorioThe text content of the message
tsstringObligatorioThe timestamp of the message
userstringThe ID of the user who posted the message
Instrucciones
**Instructions for Setting Up the Trigger:** - If you are using your own Slack app: 1. Go to the 'Event Subscriptions' section of your app's settings. 2. Enable events. 3. Input the 'Request URL' field with `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle` 4. Add `message.channels` to the 'Subscribe to bot events' section and `Subscribe to events on behalf of users` section and save. - If you are using the Composio Slack app, you are all set here! - If you are using Slackbot integration, you would need to add the Slack app to the channels you want to monitor. In case using Composio Slack app, you need to do /add and then choose Composio App.