Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can use modified commands in MS Teams to return specific information from the MSPbots apps. This is done by configuring the Message Command bot block to recognize custom commands that will trigger your bot and return needed information. 

What's on this page  

Table of Contents

What is the Message Command bot block? Why should I modify it?

...

The Message Command bot block is where chat commands for the Attendance Manager, NextTicket Manager, and Utilization apps are configured to return specific information. This block recognizes preset commands that, when sent to MS Teams or Slack, return needed information according to the set schedule or on demand. 

The preset commands for the MSPbots template bots are customizable in case none apply to your business requirements. If you have specific business needs that are not currently addressed by our preset commands, you can customize commands in the Message Command bot block. 

For example, if you prefer to use the check in command instead of in for recording attendance in MS Teams, you can create a new bot, set up the check in command in the Message Command block, and then add corresponding Attendance-in and Alert blocks so that entering the command check in in MS Teams will automatically trigger the attendance bot you created. 

Note

Only MS Teams allow the addition of new commands. Right now, Slack recognizes the commands nt and help only, but will soon recognize new commands in the upcoming feature releases.

Relevant applications and permissions 

...

This information applies to MS Teams, Slack, Attendance Manager, NextTicket Manager, and 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.

How to configure the Message Command bot block  

...

The steps below show how you can create custom commands in the Message Command bot block. For this example, we want to set up a bot that will use the command check in instead of the preset in command. Do the following:  

  1. Log in to the MSPbots app

Table of Contents

Background Information

  • Teams Command is a trigger-type bot block that primarily recognizes the commands you send to MSPbots on Teams. For example, by setting Teams Command to "in" and appending the Attendance-in and Alert blocks, MSPbots can identify the "in" command you input, automatically store your check-in record in the database, and respond accordingly.

Main Section

  1. Log in to the MSPbots app using your Office 365 account. 
  2. Navigate to Bots on the left menu then click the New Bot button on the Bots screen.
    Image Removed
    You can also start creating a bot from a widget on your dashboard. Click the ellipsis button and select Create Bot.
    create bot-widgetImage Removed
  3. When the Create a new bot  window appears, click on window opens, select Start From Blank > Teams Message Command. 
    Image Removed

    animated GIF create new botImage Added

  4. When the next Create a new bot window appears, fill Fill in the required fields for creating a bot
    Image Removedimage create new bot fieldsImage Added
    1. Enter a name in the Bot Name field.
    2. Identify the Role that will have access to the bot.
    3. Add a clear Description of the bot. (Recommended) 
    4. Then click Continue to Click More Edit to open the Message Command pop-up window and fill out the required fields. 
      Image RemovedThen click
  5. In the Save button. Clicking Save opens the tab with the details and settings for your new bot. 
    Image RemovedMessage Command pop-up window, click the Message Tool dropdown list and select a tool. To use MS Teams to trigger your bot, select Teams; to use Slack, selectSlack instead. 
    image select message tool for message commandImage Added
  6. Next, go to the command menu, select Click Design to enter the Teams Command pop-up window, then select the command you want MSPbots to recognize. Using the in command as an example, please refer to the other types of teams command bots at: How to Configure the Teams Command Bot Block.
    Image Removed
  7. Click Finish button.
  8. , and click Finish
    image select message commandImage Added
    For more information on the 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 check in command instead of the in command, enter check in
    Tip

    Type commands in lowercase when adding new commands. Example: Type check in instead of CHECK IN.


    animated GIF - add new message commandImage Added 
     
    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.



  9. Click on the Message Command block, then click image plus add new bot blockImage Added under it, and Click on the Teams Command block, then click on the Image Removed under the block, and finally select Add a Block.
    Image Removedanimated GIF - add a new bot blockImage Added

  10. Next, add an Attendance-in block by clicking Click on the generated blank block.
    Image RemovedEnter , typing Attendance-in in into the search bar, and then click onselecting Attendance-in to add the blockin. 
    Image Removedanimated GIF - add Attendance-in blockImage Added

  11. Click on the Attendance-in block block, then click on the  image plus add new bot blockImage Modified under the blockit, and finally select Add a Block.
    Image Removedimage gif add a new blockImage Added
  12. Next, add an Alert block by clicking Click on the generated blank block.
    Image RemovedEnter Alert into , typing Alert in the search bar, and then click on Alert to add the block.
    Image Removedselecting Alert. 
    animated GIF add Alert blockImage Added

  13. Next, start configuring the settings. Go to the Message Command block, click Click the image ellipsis optionsImage Modified in the upper-right corner of the Attendance-in block, and then click Edit to make your settings.
    Image Removedselect Edit
    image gif edit bot blockImage Added
  14. Verify if the selections for Message Tool and command are the same as your selections in Steps 4 and 5. Click Next once confirmed. 
    image selected message commandsImage Added
  15. When the Attendance-in window opens, customize the Please 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
      Image Removedimage attendance-in settingsImage Added
  16. When done, click Click Next to proceed to the Alert configuration pagewindow.
  17. Follow the prompts on the page to Alert window and configure the Alert block according to your preferences.
    Image Removedimage alert settingsImage Added
  18. Click Finish.
  19. Click Savein the on the upper right corner to save your settingsof your bot's window.
    Image RemovedAs shown in the figure below, when "in" is entered in MSPbots, it will be recognized and responded with the corresponding answer.
    Image Removed

    Teams Command Bot Types

    OrderTeams image save bot settingsImage Added
  20. 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. 

image test message commandImage Added

Anchor
commandslist
commandslist
MS Teams Command Template Bots 

The table below displays the commands available for MS Teams, including their descriptions, configuration blocks, and corresponding need for alerts. Use this table as a guide when modifying message commands. 

Template BotsMessage CommandCorresponding BlockNeed for Alert Block

...

Descriptions
TeamsCommand helphiCommand-Help

...

YesBot that recognizes

...

the hi command to return answers related to help information
TeamsCommand helphelloCommand-Help

...

out

...

YesBot that recognizes

...

the hello command to return answers related to help information
TeamsCommand helphelpCommand-help

...

YesBot that recognizes

...

the help command to return answers related to help information
TeamsCommand inin

...

Attendance-

...

inYesBot that recognizes

...

the in command for checking in into the Attendance Manager

TeamsCommand out

out

...

Attendance-

...

outYesBot that recognizes

...

the out command when logging off in the Attendance Manager 
TeamsCommand breakbreak

...

Attendance-

...

breakYesBot that recognizes

...

the break command for

...

logging a pause from work in the Attendance Manager
TeamsCommand lunchlunch

...

Attendance-

...

lunchYesBot that recognizes

...

the lunch command for logging a lunchbreak the Attendance  Manager
TeamsCommand onsiteonsite

...

Attendance-

...

onsiteYesBot that recognizes

...

the onsite command for the Attendance Manager check-in
TeamsCommand backbackAttendance-back

...

YesBot that recognizes

...

the back command when logging back to work in the Attendance Manager
TeamsCommand ptoptoAttendance-pto

...

YesBot that recognizes

...

the pto command to

...

handle related leave operations 
TeamsCommand_wfhwfhAttendance-wfh

...

YesBot that recognizes

...

the wfh command for the Attendance Manager check-in
Tech Stats Reviewerstats or qa 

...

Utilization-statsYes

...

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 ntntNT command message formattingYesWhen used, the nt command the bot returns data in a custom format.
TeamsCommand reject

...

rejectTeams Command-rejectNoBot that recognizes

...

the reject

...

 command to skip the current ticket

...

. This bot needs to be used

...

with the

...

nt

...

command.

...

TeamsCommand unknownunknownTeams Command-ChatGPTYesBot that returns answers from

...

ChatGPT.

...

You need to set up your OpenAI integration before you can start using this bot.

...


Related topics 

...

Content by Label
showLabelsfalse
max5
showSpacefalse
excludeCurrenttrue
cqllabel = "bot_block"

...

These bots are used by QA personnel to check various business scenarios.

...