Versions Compared

Key

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

This is a guide These are the steps for creating a bot in the MSPbots app.   

Table of Contents
stylenone
 

1. Set up a new bot.

...

    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.
      new botImage Modified
    3. When the Create a new bot window appears, select Quality Assurance Bot.
      new QA botImage Modified.
    4. Fill in the required fields for creating a bot. 
      create new botImage Modified
    5. Enter a name in the Bot Name field.
    6. Identify the Role that will have access to the bot.
    7. Add a clear Description of the bot. (Recommended)
    8. Then click the Confirm button. Clicking Confirm opens the tab with the details and settings for your new bot. 
  1. Next, set

2. Set up the bot trigger. 

...

    1. Click the Design button on your bot's tab.  
      bot designImage Modified
      This opens the Trigger window where you
  1. can
    1. configure the trigger script.

    2. Start defining the trigger by selecting Widget or Dataset, and your PSA.
      createbot6Image Modified
    3. Next, go to the meet following criteria section and define the criteria for triggering the bot. Hover over the (plus) icon and click +Add Group or +Add Condition.
      add group conditionImage Modified
      If you want to preview the data, click the  Image Modified Data Inspector icon.

    4. Go to the I want the bot to run based on this schedule section and set the time and frequency for running the bot. 
      createbot8Image Modified

3. Set up Advanced Scheduling (Optional)

...

    1. To set up advanced scheduling, scroll down to the Advanced Scheduler section on the Trigger screen.
    2. Click the Setting link to open the Advanced Scheduler window. 
    3. On the Advanced Scheduler window, configure the bot to alert in Minutes, Hours, Day, Month, or Year, then click Save.
    4. Click the Next button to continue to the steps for defining the bot alert script.
      createbot9Image Modified

4. Define the bot alert script.

...

    1. Start by activating the channel where the bot will send the alert message. Click the slide button for any of the following to switch it ON: 
      • Microsoft
  1. Teams
      • Teams Chat 
      • Microsoft
  2. Team
      • Teams Channel 
      • Email 
      • Web Message
        message channelsImage Added
        You may select multiple channels, depending on your requirement.
  3.  
    createbot10Image Removed


    1. Set up the alert message. 
  4. Example: To
    1. For example, to set an
  5. Email
    1. email alert, fill in the following fields:
      • To - Select a receiver or recipient from the Dataset Field, Drill through, or User List.
        createbot13Image Added
      • Subject - Input a subject manually and/or select one using a Dynamic Token.
        createbot12Image Modified

...

...

      • Message Type - Type a custom message for the alert message.

...


                                                                createbot14Image Removed

...

      • createbot14Image Added
        You can use the Insert a Token button to select data to include in the message. Formatting options are also available to highlight message sections.

...

      •  createbot15Image Modified

...

    1. Click 

...

    1. Next when done. This action takes you to the escalation script setup.

...


5.

...

Set the escalation script.

...

The escalation recipient can be a manager and/or a next-level manager, depending on your requirement. You can also set several escalation steps as needed.          a.

    1. Select a Time Frame for the escalation cycle. Choose from Day, Week, or Month.

...

    1. Define the escalation steps by selecting an Escalation Threshold.

...

    1. Write the Escalation message. Click the + Add Message

...

    1. button to add another message.

...

    1. For example, if you select 

...

    1. Week for Time Frame and 

...

    1. for Escalation Threshold, the escalation message would be sent when the bot is triggered 3 times in a week.

...

...

    1. Click the

...

    1. Finish button when done.

...


...

    1. createbot16Image Modified

...

6.

...

Activate the bot.

...

    To start sending alerts, activate the bot by going to the Detail tab and turning the following switches ON:      

    • Trigger - Switch this ON to make the bot available and running.

...

...

    • Alert - Switch this ON to enable the sending of alerts.

...

...

    • Escalation

...

    • - Switch this ON to activate the escalation setup.

...


...

    • createbot17Image Modified