Slack Spoke
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.2 is the latest version.
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 . | |
| 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 . | |
| 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 . |
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 ServiceNow Otto 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 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 for more information about creating a clone.
- See 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 with the Now Assist application 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.