SHORTCAT TUTORIAL HOW TO

When a shortcut is invoked, a request will be sent to the app's configured Request URL. Our Bolt framework, available in JavaScript, Python, and Java allows you to rapidly build logic to handle shortcuts. Your app must process that payload and then send a response.įirst, let's learn more about that interaction payload. In short, your app will receive an interaction payload after someone uses one of your shortcuts.

SHORTCAT TUTORIAL HOW TO

We explain the process in-depth in our guide to handling user interactions in apps, including how to prepare your app with a request URL. You've created a shortcut, and at some point it will be used by someone in Slack. Handling the use of shortcuts in your app Now let's make sure you are ready to receive interaction payloads and do something in response. Shortcuts will appear in shortcuts menus in the order in which they were created. That's it-you've created your first shortcut! You can create some more-each app can have up to 5 global shortcuts, and separately, 5 message shortcuts. On that page you'll need to click the Save Changes button.

Callback ID: a string that will be sent to your Request URL in an interaction payload - we'll talk about this more later on.Ĭlick that tempting green Create button, and you'll be sent back to the Interactivity & Shortcuts page.

Short Description: describe what the shortcut does for the benefit of a potential user.

Start the name with a verb, and use sentence case (eg. Select from the Global and On messages options, depending on which type of shortcut you want and click Next Now that your app is ready, it's time to create some potential interaction energy:Ĭlick on Interactivity & Shortcuts in the sidebarĬlick the Create New Shortcut button under Shortcuts If your app is published in the App Directory, the changes will be reflected only after the app is reviewed and approved. If your app isn't already requesting commands at installation, it will need to be reinstalled before shortcuts can be used. Under Scopes, type commands into the text field, select the correct permission to add it, then click Save Changes. You can either request this scope during the OAuth flow or add it to your app OAuth settings:įrom your app's dashboard, click the menu item OAuth & Permissions. To make shortcuts available in Slack, your app must have the commands permission scope. Preparing for payloadsĮnsure your app is ready to receive interaction payloads by providing a Request URL, as described in our guide to handling user interactions. In order to start using shortcuts with your app, there are a few preparation steps you'll need to go through. If you don't have a Slack app yet, what are you waiting for? Follow our quick guide to create one. This makes them ideal when you have a workflow that relies on that context to work.įor example, users might quickly generate tasks from a posted message, or send messages to external services. Message shortcuts will retain the context of the source message from which they were initiated. They are shown in the context menu of any non-ephemeral message. Message shortcuts allow users to invoke your app from the comfort of the humble Slack message.

These type of shortcuts are intended to trigger workflows that can operate without the context of a channel or message.įor example, users might trigger a global shortcut to create a calendar event or view their upcoming on-call shifts. They can be initiated from the shortcuts button in the message composer, or from within search. Global shortcuts are ever-present companions in a user's life in Slack. Let's take a look at them in more detail. There are two different types of shortcut that apps can create. When someone uses one of your shortcuts, your app will receive some context about what happened in an interaction payload. Apps can create their own shortcuts and use them as a trigger for interactive workflows. Shortcuts are a type of element in Slack clients that invoke a helpful action. What's the difference between message and global shortcuts? Sending messages in response to global shortcuts.

What's the difference between message and global shortcuts?.

There are a few short steps to creating shortcuts, letting you focus on perfecting your potential response.ĭon't take any shortcuts here (pun definitely intended). Shortcuts give Slack users clear entry points to access your app.

Shortcat tutorial