Shortcuts and Slash Commands

Users can interact with your app through shortcuts and slash commands. To respond when a shortcut or slash command is triggered, or when an event is dispatched:

• Write a class that extends from one of the dispatcher classes
• Register the class in the app's metadata.

A class that extends the dispatcher based on the action or event you’re handling provides dispatching logic that returns a Slack.ActionHandler. The Slack.ActionHandler invoke() method performs processing logic when the handler is invoked.

Shortcuts

Users access shortcuts in Slack by clicking the lightning bolt or typing a slash. They’re ideal for common and repeatable actions within an app. An app can have up to 5 shortcuts, and only up to 10 actions (shortcuts and slash commands) are visible within the menu, and fewer are visible on mobile.

There are two types of shortcuts.

• Global shortcuts: Available to users from the shortcuts button in the composer or when using search.
• Message shortcuts: Available to users in the context menu of a message.

For more information, see What's the difference between message and global shortcuts?

To implement a shortcut handler for a global or message shortcut, extend the Slack.ShortcutDispatcher class.

Write code that performs actions and generates a response when the shortcut is triggered. To map this class as the handler for the corresponding shortcut in the app's metadata, use its callback_id. This value must match the value that you define when you create the shortcut in your Slack app. You can find the callback ID in the Interactivity & Shortcuts page at api.slack.com/apps.

tip: If you've already defined your shortcuts, you can also find the callback_id in the app manifest.

Global Shortcuts

Global shortcut handlers receive these properties from Slack.RequestContext, a class that's passed into the invoke() method.

• appId—The application's unique ID.
• enterpriseId—The organization ID for Enterprise Grid. null values are accepted.
• userId—The Slack user’s user_id associated with this request.
• teamId—The Slack workspace ID.
• triggerId—A temporary ID generated for the interaction in your app. This value can be used to open modals.

Message Shortcuts

Message shortcut handlers receive these properties from Slack.RequestContext, a class that's passed into the invoke() method.

• appId—The application's unique ID.
• channelId—The channel where the source message was located.
• enterpriseId—The organization ID for Enterprise Grid. null values are accepted.
• Message—The message that the user initiated the shortcut from.
• text—The text of the message.
• ts—The timestamp of the message.
• user—The user who initiated the shortcut.
• userId—The Slack user’s user_id associated with this request.
• teamId—The Slack workspace ID.
• triggerId—A temporary ID generated for the interaction in your app. This value can be used to open modals.

Slash Commands

Generally, we recommend creating shortcuts instead of slash commands for key navigation and discoverability.

When a user submits a slash command, Slack sends a payload of data to your app via an HTTP POST request. The slash command can be an entry point to a simple message response or a complex workflow.

tip: Slack comes prebuilt with a list of slash commands. See What are Slash Commands? and Getting Started with Slash Commands.

To perform actions and generate a response when a slash command is sent from the message composer box in Slack, extend the Slack.SlashCommandDispatcher class.

Map this class as the handler for the corresponding slash command in the app's metadata. The command must specify the same value used to create the slash command in your Slack app. See Register an Action.

Slash commands receive these properties from Slack.RequestContext, a class that's passed into the invoke() method.

• appId—The application's unique ID.
• channelId—The channel where the source message was located.
• enterpriseId—The organization ID for Enterprise Grid. null values are accepted.
• userId—The Slack user’s user_id associated with this request.
• teamId—The Slack workspace ID.
• triggerId—A temporary ID generated for the interaction in your app. This value can be used to open windows.

Use Slash Commands and Shortcuts with Flows

Users can use slash commands, global shortcuts, and message shortcuts to trigger flows. Add your action to the app's metadata.

description: App configuration for running flows in slack
commands:
  /SlashCommandName:
    action:
      definition: flow__requestHandler
      properties:
        flowApiName: slashCommandFlow
    title: Launch flow command
    description: Launches a flow in a modal from slack`
globalShortcuts:
  flow-gs:
    action:
      definition: flow__requestHandler
      properties:
        flowApiName: ScreenFlowOnSlackGS
    title: Launches flow with API Name ScreenFlowOnSlackGS
    description: Launches a flow from slack global shortcut.
messageShortcuts:
  flow-ms:
    action:
      definition: flow__requestHandler
      properties:
        flowApiName: ScreenFlowOnSlackMS
    title: Launches flow with API Name ScreenFlowOnSlackMS
    description: Launches a flow from slack message shortcut.

important: Slash commands are global and can’t contain namespaces.

This table outlines the keys required in the app manifest to bind flows to actions.

Keys

Use Slack Buttons with Flows

Trigger flows with Slack buttons by using an on-click event.

description: "Launches a flow from a button"
components:
  definition: message
  components:
    definition: "actions"
    components:
      definition: "button"
      properties:
        name: "flowButton"
        label: "Launch Flow"
        events:
          onclick:
           definition: "flow__requestHandler"
            properties:
              flowApiName: "MyFlow"

Keys

See Also

Entry points for app interactions