# Using Workbot for Workplace
# Workbot commands
You can perform actions in your apps (e.g. creating new Github issues, listing Salesforce opportunities) by sending Workbot commands from within Workplace.
Sending a 'newissue' command with additional parameters in Workplace, then receiving a post reply
A Workbot command is a trigger that allows you to run a Workbot command recipe.
Example 'newissue' command in a recipe
To learn more about Workbot commands, see Workbot commands.
# Workbot 'help'
If you get stuck, you can always send the help command to Workbot. Workbot will respond with the list of commands available to you.
Asking Workbot for help
# Invoking Workbot commands in Workplace
Workbot commands can be invoked in 2 distinct ways:
- Sending the command in a direct message to Workbot or in a channel (in a channel, this requires tagging Workbot i.e. @workbot your_command)
Invoking a Workbot command in channel - Sending the command when a button is clicked
Clicking a button to invoke a Workbot command
Commands can also prompt users for additional parameters. For example, to create a new Github ticket, the user should provide the title and description of the incident. In this case, you can add 2 parameters; title
& description
. When the command is invoked, Workbot will prompt the user for each parameter.
Workbot can ask users for info if you specify additional parameters in your command
# Event notifications using Post message action
Workbot can also be used to notify you when any events occur in your apps. This can be done via the Post message action.
A Post reply action notifying user about a new incident in ServiceNow
The Post message & Post simple message actions allow you to post a message to a user or in a channel.
A recipe where a Post message action notifies the user when a ServiceNow incident is closed
To learn more about how the Post message action works, see Workbot actions.