Listening & responding to shortcuts | Slack Developer Docs python Skip to main content Guides Reference Samples Tools Changelog Dev Program MANAGE APPS * Overview * Community-developed tools * Slack MCP and Skills Plugin * Sandboxes * Deno Slack SDK * Java libraries * JavaScript libraries * Python libraries * Bolt for Python * Creating an app * AI & Agents * Slack API calls * Events * App UI & Interactivity * Acknowledging requests * Listening & responding to shortcuts * Listening & responding to commands * Listening & responding to actions * Opening modals * Updating & pushing views * Listening to views * Listening & responding to select menu options * Publishing views to App Home * Custom Steps * App Configuration * Middleware & Context * Lazy listeners (FaaS) * Adaptors * Authorization & Security * Experiments * Legacy * Tutorials * Reference * 日本語 (日本) * Python Slack SDK * Slack CLI * Slack GitHub Action * * Python libraries * Bolt for Python * App UI & Interactivity * Listening & responding to shortcuts Copy as markdown On this page Listening & responding to shortcuts The shortcut() method supports both global shortcuts and message shortcuts . Shortcuts are invokable entry points to apps. Global shortcuts are available from within search and text composer area in Slack. Message shortcuts are available in the context menus of messages. Your app can use the shortcut() method to listen to incoming shortcut requests. The method requires a callback_id parameter of type str or re.Pattern . Shortcuts must be acknowledged with ack() to inform Slack that your app has received the request. Shortcuts include a trigger_id which an app can use to open a modal that confirms the action the user is taking. When setting up shortcuts within your app configuration, as with other URLs, you'll append /slack/events to your request URL. ⚠️ Note that global shortcuts do not include a channel ID. If your app needs access to a channel ID, you may use a conversations_select element within a modal. Message shortcuts do include a channel ID. Refer to the module document to learn the available listener arguments. # The open_modal shortcut listens to a shortcut with the callback_id "open_modal" @app . shortcut ( "open_modal" ) def open_modal ( ack , shortcut , client ) : # Acknowledge the shortcut request ack ( ) # Call the views_open method using the built-in WebClient client . views_open ( trigger_id = shortcut [ "trigger_id" ] , # A simple view payload for a modal view = { "type" : "modal" , "title" : { "type" : "plain_text" , "text" : "My App" } , "close" : { "type" : "plain_text" , "text" : "Close" } , "blocks" : [ { "type" : "section" , "text" : { "type" : "mrkdwn" , "text" : "About the simplest modal you could conceive of :smile:\n\nMaybe </block-kit/#making-things-interactive|*make the modal interactive*> or </surfaces/modals|*learn more advanced modal use cases*>." } } , { "type" : "context" , "elements" : [ { "type" : "mrkdwn" , "text" : "Psssst this modal was designed using <https://api.slack.com/tools/block-kit-builder|*Block Kit Builder*>" } ] } ] } ) Listening to shortcuts using a constraint object ​ You can use a constraints object to listen to callback_id s, and type s. Constraints in the object can be of type str or re.Pattern . # Your listener will only be called when the callback_id matches 'open_modal' AND the type matches 'message_action' @app . shortcut ( { "callback_id" : "open_modal" , "type" : "message_action" } ) def open_modal ( ack , shortcut , client ) : # Acknowledge the shortcut request ack ( ) # Call the views_open method using one of the built-in WebClients client . views_open ( trigger_id = shortcut [ "trigger_id" ] , view = { "type" : "modal" , "title" : { "type" : "plain_text" , "text" : "My App" } , "close" : { "type" : "plain_text" , "text" : "Close" } , "blocks" : [ { "type" : "section" , "text" : { "type" : "mrkdwn" , "text" : "About the simplest modal you could conceive of :smile:\n\nMaybe </block-kit/#making-things-interactive|*make the modal interactive*> or </surfaces/modals|*learn more advanced modal use cases*>." } } , { "type" : "context" , "elements" : [ { "type" : "mrkdwn" , "text" : "Psssst this modal was designed using <https://api.slack.com/tools/block-kit-builder|*Block Kit Builder*>" } ] } ] } ) Previous Acknowledging requests Next Listening & responding to commands Copy as markdown * Listening to shortcuts using a constraint object . * Tools * Slack CLI * Bolt frameworks * Slack SDKs * Block Kit Builder * Developer program * Code samples & tutorials * LLM? Read llms.txt * All tools Learn * Learning paths * Workshops * Slack certifications * Trailhead * Resource library * All learning resources Community * Slack community * Slack events Resources * Docs * Blog * Slack marketplace * Developer newsletter Manage Apps * Your apps * Status * Privacy * Terms * Cookie Preferences * Support * Changelog * Your Privacy Choices © 2026 Slack Technologies, LLC, a Salesforce company. All rights reserved. Various trademarks held by their respective owners. * * *