N O T I C E
MSPbots WIKI is moving to a new home at support.mspbots.ai to give you the best experience in browsing our Knowledge Base resources and addressing your concerns. Click here
for more info!
Page History
The Message Command bot block recognizes preset commands that, when sent to MS Teams or Slack, return specific information on demand. If you have specific business needs that are not currently addressed by our preset commands, you can create custom customize commands in this bot block.
This page discusses how to configure the Message Command bot block and modify it to create new, business-specific commands.
What's in on this article page
Table of Contents |
---|
Background Information
...
Message Command is a trigger-type bot block that recognizes the commands you send to MSPbots on Teams or Slack and returns the required information. MSPbots has a template bots with preset list of commands for some bot types, but if you have requirements that are not covered by these, you can set your own commands and customizable in case any of these do not cover your business requirements. You can configure the Message Command bot block to recognize these custom commands any time you want to use them. add new commands for on-demand use instead of relying on scheduled notifications.
For example, if you want to use check in instead of the templated in command and have the bot respond right away, create a new bot, configure For example, by setting the Message Command block to add check-in and appending the Attendance-in and Alert blocks, MSPbots can identify the in command you input, to the commands list, and set it to recognize the new command and automatically store your check-in record in the database , and respond accordingly. Recommended revision–something like: For example, if you want to get the tickets for triage on demand and without having to rely on scheduled notifications, you can add the command triage to the commands list so that every time you type triage, MS Teams will return the tickets for triage at the time you sent the command. Note:
Note |
---|
Only MS Teams can accommodate the addition of new commands. Right now, Slack recognizes the commands nt and help only, but will soon |
...
accommodate new commands in the |
...
upcoming feature releases. |
...
Relevant applications and user types
...
This information applies to MS Teams, Slack, Attendance Manager, NextTicket Manager, and Utilizations Utilization apps. Only users with admin permissions can create bot blocks and configure the Message Command block. If you do not have the required permission, contact your administrator for help.
Recommended revised (main) sections below:
How to configure the Message Command bot
...
block
...
Let's use the example of a client wanting to use the command check in instead of the templated in command. Below are the steps for modifying
...
Steps here
...
the Message Command bot block
...
:
Steps here
Main Section
- Log in to the MSPbots app appusing your Office 365 account.
- Navigate to Bots on the left menu then click the New Bot button on the Bots screen.
You can also start creating a bot from a widget on your dashboard. Click the ellipsis button and select Create Bot. - When the Create a new bot window window appears, click on Start From Blank > Message Command.
Fill fill in the required fields for creating a bot.- Enter a name in the Bot Name field.
- Identify the Role that will have access to the bot.
- Add a clear Description of the bot. (Recommended)
- Then click the Continute button to open the tab with the details and settings for your new bot.
- Continue to open the Message Command pop-up window.
- In theMessage Command pop-up window, select a Message Tool. If you will use MS Teams to trigger your bot, select Teams, or select Slack if you wish to use Slack instead.
- Then go to the Commands menu, select
Info Using the in command as an example, please refer to the other types of message command bots at: How to Configure the Message Command Bot Block.
- Message Tool - If you want to trigger the bot by sending commands in Teams, please select teams. And if you want to use Slack, please select slack.
- Click Finish button.Click on the Message Command block, then click on the under the blockit, and finally select Add a Block.
- Click on Next, add an Attendance-in block by clicking the generated blank block, and enter typing Attendance-in in into the search bar, and then click onselecting Attendance-in to add the blockin.
- Click on the Attendance-in block block, then click on the under the blockit, and finally select Add a Block.
- Click on Next, add an Alert block by clicking the generated blank block and enter , typing Alert into in the search bar, and then click on Alert to add the block.selecting Alert.
- Click the Next, start configuring the settings. Go to the Message Command block, click in the upper-right corner of the Message Command block, and then click Edit to make your settings.select Edit.
Click Next to configure - Verify if the selections for Message Tool and command are the same as your selections in Steps 4 and 5. Click Next once confirmed.
- When the Attendance-in block.
Please window opens, customize MSPbots' responses for each of the following scenarios in the Attendance-in pop-up window.:- Clock in - Success
- Clock in time is outside working hours -or- Clock in time is incorrect
- Clock in update - Success
- Wrong command
- Clock in is done by an invalid account
- When done, click Click Next to proceed to the Alert configuration pagewindow.
- Follow the prompts on the page to Alert window and configure the Alert block according to your preferences.
- Click Finish.
- Click Save in the upper right corner to save your settingsof your bot's window.
As shown in the figure below, when "in" is entered in MSPbots, it will be recognized and responded with the corresponding answer. - Verify your settings. Go to MS Teams and type check in. The command should be recognized and return a response based on the configurations you made.
For more information on the commands available commands for MS Teams, read the section on Teams Command Template Bots.
To use your preferred command, enter your custom command then click Finish. For example, if you want to trigger the attendance bot using the the check - in command command instead of the the in command, you can enter check - in here.
Tip |
---|
When adding new commands, type commands in |
lowe case. |
Note |
---|
The feature to add custom commands is |
only supported in MS Teams for now and is not yet available in Slack. |
Only the nt command and |
help |
commands are currently |
recognized by Slack. |
Anchor | ||||
---|---|---|---|---|
|
...
The table below shows the commands available for MS Teams and their descriptions, including the blocks where to configure them and if they have corresponding alerts. Use this table as a guide when modifying message commands.
...
Template Bots | Message Command | Corresponding Block | Need for Alert Block |
---|
...
Descriptions | ||||
---|---|---|---|---|
TeamsCommand help | hi | Command-Help | Yes | Bot that recognizes |
...
the hi |
...
command to return answers related to help information |
...
...
TeamsCommand help | hello | Command-Help | Yes | Bot that recognizes |
...
the hello |
...
command to return answers related to help information |
...
TeamsCommand help | help | Command-help | Yes | Bot that recognizes |
...
the help |
...
command to return answers related to help information |
...
...
TeamsCommand in | in | Attendance-in | Yes | Bot that recognizes |
...
the in |
...
command for |
...
checking in into the Attendance Manager |
TeamsCommand out | out | Attendance-out | Yes | Bot that recognizes |
...
the out |
...
command |
...
when logging off in the Attendance Manager |
TeamsCommand break | break | Attendance-break | Yes | Bot that recognizes |
...
the break |
...
command for |
...
logging a pause from work in the Attendance Manager | ||||
TeamsCommand lunch | lunch | Attendance-lunch | Yes | Bot that recognizes |
...
the lunch |
...
command for |
...
logging a lunchbreak the Attendance Manager |
TeamsCommand onsite | onsite | Attendance-onsite | Yes | Bot that recognizes |
...
the onsite |
...
command for |
...
the Attendance Manager check-in |
...
TeamsCommand back | back | Attendance-back | Yes | Bot that recognizes |
...
the back |
...
command |
...
when logging back to work |
...
in the Attendance Manager | ||||
TeamsCommand pto | pto | Attendance-pto | Yes | Bot that recognizes |
...
the pto |
...
command to handle related leave |
...
operations | ||||
TeamsCommand_wfh | wfh | Attendance-wfh | Yes | Bot that recognizes |
...
the wfh |
...
command for |
...
the Attendance Manager check-in |
...
Tech Stats Reviewer | stats\qa | Utilization-stats | Yes |
...
This bot reports the total working hours, utilization rate, overlapping time entries, ongoing work orders, and pending tasks |
...
before the end of each user's workday. |
...
TeamsCommand nt | nt | NT command message formatting | Yes | When |
...
used, the |
...
nt |
...
command |
...
the bot returns data in a custom format. |
...
TeamsCommand reject | reject | Teams Command-reject | No | Bot that recognizes |
...
the reject |
...
command to skip the current ticket |
...
. This bot needs to be used |
...
with the |
...
nt |
...
command. |
...
TeamsCommand unknown | unknown | Teams Command-ChatGPT | Yes | Bot that returns answers from |
...
ChatGPT. |
...
You need to set up your OpenAI integration |
...
you can start using this bot. |
...