Slack Spoke

concept brazil Updated Mar 12, 2026 10 min read slack-spoke.md
Raw file servicenow.com

Use the Slack spoke to post messages and manage access to channels.

Integration Hub subscription

This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview. To learn more about the subscription, contact your account manager.

Spoke version

The Slack spoke v1.9.3 is the latest version. For version history of the spoke, see Slack spoke release notes.

Slack account requirements

The Slack spoke requires creating a workspace and custom app on your Slack account to generate the OAuth 2.0 tokens for the Slack spoke. See Configure Slack app.

Note: The spoke set up procedure outlined here requires bot user tokens only. You can't use the Create User and Deactivate User actions while using the bot token scopes. To use these actions, you must obtain user token from your Slack account.

Spoke subflows

The Slack spoke provides some sample subflows to demonstrate automating the Slack workspace tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:

Subflow

Description

Insert Slack User Details by Member ID

Inserts details of the required user in the Slack User Cache module, based on the Member ID.

Insert Slack User Details by User ID

Inserts details of the required user in the Slack User Cache module, based on the User ID.

Post Actionable Message

Posts an actionable message to a Slack channel.Note: This subflow requires an outbound configuration as an input. Customize the default outbound configurations or create an outbound configuration as per your requirement. For more information, see Configure outbound configurations in ServiceNow instance.

Post Approval Message

Posts an approval message to a Slack channel.Note: This subflow requires an outbound configuration as an input. Customize the default outbound configurations or create an outbound configuration as per your requirement. For more information, see Configure outbound configurations in ServiceNow instance.

Respond to Slack Approval Message

Posts an acknowledgment message on a Slack channel.

Respond to Slack Command

Posts a response to a command on a Slack channel.

Respond to Slack Message Action

Posts a notification on a Slack channel.

While customizing the subflows, make sure that the subflows are configured to avoid infinite loops.

Spoke actions

The Slack spoke provides actions to automate the Slack workspace tasks when events occur in the ServiceNow instance. Available actions include:

Category

Action

Description

Conversation Management

Add User to Channel

Adds an existing user to the specified channel in the Slack workspace.

Archive Channel

Archives a channel in a Slack workspace.

Rename Conversation

Renames a conversation.

Look up Conversation Info

Retrieves information about a conversation.

Create Channel

Creates a channel in a Slack workspace.

Look Up Attachments Stream By Conversation or Member ID

Retrieves attachments related with the relevant channel, member, or bot user.

Look up Channel History Stream

Retrieves the history of a channel. You must provide the channel ID, and the start and end date as inputs.

Look up Conversation

Retrieves the conversation messages for a thread from the specified channel.

Open Conversation

Opens or resumes a direct message or a multi-person direct message.

Look up Conversation IDs Stream by Member ID

Retrieves details of the Conversation IDs related with the specified member on Slack.

Set Topic for Channel

Sets the topic for a Slack channel.

Remove User from Channel

Removes a user from a channel in the Slack workspace.

Notification Management

Post Actionable Message

Posts an actionable message to a Slack channel.Note: This action requires an outbound configuration as an input. Customize the default outbound configurations or create an outbound configuration as per your requirement. For more information, see Configure outbound configurations in ServiceNow instance.

Post Approval Message

Posts an approval message to a Slack channel.Note: This action requires an outbound configuration as an input. Customize the default outbound configurations or create an outbound configuration as per your requirement. For more information, see Configure outbound configurations in ServiceNow instance.

Post Change Details

Posts Change record details to a channel.

Post Incident Details

Posts Incident record details to a channel.

Post Message

Posts a message to a Slack Channel.

Post Response to Slack

Posts a response to Slack.

Update Approval Record

Updates an approval record.

Post Problem Details

Posts a Problem record detail to a channel.

User Management

Create User

Creates a user in the Slack workspace.Note: This action requires a user token from the Slack account. If you have bot user tokens, you can't use this action.

Deactivate User

Deactivates the specified user from the Slack workspace.Note:

This action requires a user token from the Slack account. If you have bot user tokens, you can't use this action.

Look up User

Returns information about the specified user or bot. The information can be name, time zone, workspace admin rights, and team ownership of a user or bot.

Deactivate Subscription

Deactivates a user subscription in Slack. To use this action, perform the steps outlined in the Create a Slack Enterprise Grid application and Create a Slack Enterprise connection section in Integrating with Slack.

Look up Access Logs Stream

Retrieves the access logs for all users since the provided oldest date. To use this action, perform the steps outlined in the Create a Slack workspace application and Create a Slack workspace connection section in Integrating with Slack.

Look up Users Stream

Retrieves all users in the Slack Enterprise grid. To use this action, perform the steps outlined in the Create a Slack Enterprise Grid application and Create a Slack Enterprise connection section in Integrating with Slack.

**Note:**
  • Create User and Deactivate User actions require the admin scope. The spoke set up procedure outlined here requires bot user tokens only. You can't use the Create User and Deactivate User actions while using the bot token scopes. To use these actions, you must obtain user token from your Slack account.
  • The admin scope is available to Slack workspace owners only.

Available AI agents

Install Now Assist for Integration Hub and start using the available AI agents. For more information, see Now Assist for Integration Hub.

This spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.

  • In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an objective. See Create an agentic workflow for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.

    You can also search for other available AI agents and add them to your agentic workflow. See Find AI agents for more information.

  • You can create a clone of the required spoke AI agent and customize it as per your requirement. See Duplicate an AI agent for more information about creating a clone.

  • See AI Agent Studio (legacy) for information about AI agents.

Available AI agents include:

AI Agent Description
Slack user manager Manages Slack users and integrates Slack actions with the ServiceNow workflows. It looks up users and streamlines user management and communication within the Slack Channels.
Slack notification manager Automates workflows by executing the Slack Spoke actions. It enables the users to send notifications and updates such as details of incidents, problems, changes, and requests to the Slack channels. It streamlines communication and manages notifications better.
Slack conversation manager Performs actions such as setting channel topics, renaming conversations, adding or removing users from channels, creating and archiving channels.

There might be AI agents installed on your instance that are not used in agentic workflows. To learn how to see all agents that are available to you, see Find AI agents.

Note: Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.

Spoke modules

The Slack spoke adds the Slack application to your ServiceNow instance. The Slack application includes these modules:

Module

Description

Slack Modal Configuration

Create modals and specify fields that should be displayed in your Slack modal.

Slack User Cache

Access information about users who have performed actions on the Slack channel that needed updates in the ServiceNow instance or a response from the ServiceNow instance.

Slack Channel Cache

Access information about the channels on which actions are performed that needed updates in the ServiceNow instance or response from ServiceNow instance.

Inbound Decisions

Specify events in Slack application for which actions must be performed in ServiceNow instance.For example, you can specify inbound decisions to update the task details in your ServiceNow instance when an approver approves the task on the relevant Slack channel. Five sample inbound decisions are available for your reference. Customize these decisions or create inbound decisions as per your requirement.

When the conditions mentioned in the inbound decisions are met, the associated subflow is triggered and a record is created in the Slack User Cache module for the Slack user, who initiated the inbound action.

Inbound Decisions for Modals

Specify subflows that must be triggered when the required inbound decisions are met.When the conditions mentioned in the inbound decisions are met, the associated subflow is triggered and a record is created in the Slack User Cache module for the Slack user, who initiated the inbound action.

Slack Outbound Choices

Choices that should be displayed as a list on the Slack channels.

Inbound Slack Message

Access information about the inbound messages to your ServiceNow instance from the Slack application.

Outbound Configurations

Specify events in ServiceNow instance for which actions must be performed on Slack application.For example, you can specify outbound configurations to send a message on Slack channel asking for approval when a task is created in your ServiceNow instance. Three sample outbound configurations are available for your reference. Customize these configurations or create outbound configurations as per your requirement.

The outbound configurations also provide a template to the Post Actionable Message and Post Approval Message actions. For example, you can configure the outbound configurations to display the Approve and Reject buttons in the approval message that is sent on the relevant Slack channel.

When the configurations mentioned in the outbound configurations are met, the relevant subflow is triggered to perform actions in the Slack application.

Slack Configurations

Provide information about the Slack app and Signing Key.

Data in these modules is populated from these spoke tables:

Table

Fields

Slack Channel Cache [sn_slack_ah_v2_slack_channel_cache]

  • Channel ID
  • Channel Link
  • Channel Name
  • Creator
  • Document ID
  • Is Archived
  • Is Private
  • Source table

Slack Configurations [sn_slack_ah_v2_slack_configurations]

  • Client Secret
  • Connection Alias
  • Property Name
  • Slack App

Slack Credential [sn_slack_ah_v2_slack_credential]

  • Authentication Key
  • Active
  • Context Name
  • Domain Name
  • Privacy Key

Slack Outbound Choices [sn_slack_ah_v2_slack_outbound_choices]

  • Name
  • Active
  • Language
  • Sequence
  • Domain
  • Value

Slack User Cache [sn_slack_ah_v2_slack_user_details]

  • Display Name
  • Slack Member ID
  • Team ID
  • User

Slack Workspace Tokens [sn_slack_ah_v2_slack_workspace_tokens]

  • Connection Alias
  • Slack App
  • Workspace Name

Slack Modal Configuration [sn_slack_ah_v2_slack_modal_configuration]

  • Modal Title
  • Name
  • Script Validation
  • Custom Modal
## Connection and credential alias requirements

Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.

For information about setting up the spoke, see Set up Slack spoke.

Search documentation
Search document titles and file paths on the brazil branch