Page History

...

1. Prepare the redirect uniform resource identifier (URI) which is https://app.mspbots.ai/web/um/smtp/redirect. Once the authorization is successful, Microsoft will use this URI to notify MSPbots about the authentication result. 

   You can find this information with the following steps:

   1. Go to Settings > System > Outgoing Mail in MSPbots.
      
      
      

   2.  Click v icon beside the +Add button and select OAuth2.
      
      
      

   3. Anchor
      Redirect URI Redirect URI

      When the Add window opens, go to the Redirect URI field, copy the given URL to Notepad, and save it on your Desktop. You will need this later when adding a New registration. 
      
       

2. Sign in to the Microsoft Azure portal and secure the credentials needed for the OAuth 2.0 authorization. 

3. Create a new app registration. 

   1. On the Microsoft Azure homepage, click App registrations. If you can't find App registrations on the page, search for it in the search bar.
      

   2. When the App registrations page opens, click the +New registration tab. 
      

   3. In the Register an application form:

      1. Name - Enter a unique namefor your application. 

      2. Supported account types -Select Account in this organizational directory only (MSPbots.ai only - Single tenant) from the options.   

      3. Redirect URI (optional) - In the first box, select Web, and in the second box, enter the Redirect URI copied from Step 1.c.

      4. Click Register. 
         

4. Next, go to Certificates & secrets on the sidebar menu, then click +New client secret on the right under the Client secrets tab.
   

   1. Anchor
      idandsecret idandsecret

      In the Add a client secret window: 

      1. Description - Add a description. 

      2. Expires - Select an expiry date from the dropdown menu. 
         

         Note
         Before the secret expires you must create a new secret and apply it to the MSPbots Outgoing Mail settings.

      3. Click Add located at the bottom of the Add a client secret window.
         
         

   2. The addition is successful once the Update application credentials pop-up window appears. 
      
      

   3. Anchor
      Value Value

      Click the copy icon in the Value column to copy the value to Notepad and save it on your Desktop.  You will need this value later when configuring OAuth 2.0 in the mail settings.
      

5. Next, go to API Permissions on the sidebar menu.

   1. Click the +Add a permission button. 
      
   2. In requesting API permissions window, go to the Microsoft APIs tab and select Microsoft Graph.
      
   3. Next, select Delegated permissions.
      
   4. Enter SMTP in the search bar under Select permissions, then click SMTP and select SMTP.Send.
      
   5. Enter IMAP in the search bar under Select permissions, then click IMAP and put a checkmark IMAP.AccessAsUser.All.
      
   6. Click the Add permissions button.
   7. The permissions you added will appear in the Configured permissions list.
      
6. Next, go to the Overview.

   1. Anchor
      Application (client) ID Application (client) ID

      Click the copyicon next to the Application (client) ID to copy the value to Notepad and save it on your Desktop. You will also use this value for creating the OAuth 2.0 credential in the mail settings. 
      
      
   2. Click the Endpoints tab.
      

   3. Anchor
      authandtokenurl authandtokenurl

      Copy the OAuth 2.0 authorization endpoint (v2) and the OAuth 2.0 token endpoint (v2) to Notepad and save it on your Desktop, such as Notepad. You will also use these values for creating the OAuth 2.0 credential in the mail settings.
      
      

...