Use app actions and slash commands

Apps installed in your Roam can add shortcuts for starting workflows from the message composer or acting on an existing message. An action might open a form, create a task, look up information, or send other data to a connected service.

Run a Slash Command

1. Open a direct message or channel.
2. Type / as the first character in an empty message composer.
3. Start typing the command name, then select the command from the list.
4. Complete the form, if one opens, and submit it.

Slash commands do not accept additional text after the command. If only one command exactly matches what you typed, press Enter to run it.

Run an Action on a Message

1. Hover over the message and click the three dots.
2. Select App Actions.
3. Choose an app, then choose the action you want to run.
4. Complete the form, if one opens, and submit it.

The app may display a confirmation when the action finishes, or an error if it cannot complete the request.

If an Action Is Missing

Only actions from apps installed for your organization appear. The app must also be configured for the type of action you are trying to use. Ask a Roam admin or the app developer if you expect an action but do not see it.

Build App Actions

Developers can create slash commands, message actions, or actions that work in both places for an organization-installed app. Configure an Interactivity URL and the Commands permission scope, then define the actions in Settings > Roam Administration > Developer.

See the App Actions developer guide for request payloads, forms, validation, and response requirements.