***

title: How to Add an Azure AD App Link to the Bot
excerpt: ''
deprecated: false
hidden: false
metadata:
title: ''
description: ''
robots: index
next:
description: ''
---------------

This guide will walk you through adding a direct link to your Moveworks bot in your Azure AD MyApps portal.

* Please note that you must be a AAD Global Administrator to perform these changes in your environment.
* Furthermore, your Moveworks Customer Success team can help with constructing the deep link to the bot, as well as sharing the avatar image file.

References: [https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/add-application-portal](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/add-application-portal)

## How to

1. Login to [https://portal.azure.com](https://portal.azure.com) as an AAD Global Administrator. Navigate to Azure Active Directory using the upper left hamburger menu.

![](https://files.readme.io/41cef85-image4.png)

2. Navigate on the menu to the left to Enterprise applications. (You can also get this view with this direct link: [https://aad.portal.azure.com/#blade/Microsoft\_AAD\_IAM/StartboardApplicationsMenuBlade/AllApps](https://aad.portal.azure.com/#blade/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/AllApps)).

3. Click **+ New application**.\
   ![](https://files.readme.io/177b565-image9.png)

4. Click **+ Create your own application**. Name the bot (this will be the default name for the application that users will see).\
   ![](https://files.readme.io/682f6b5-image3.png)

5. Click **Single sign-on** on the left, and click **Linked**.\
   ![](https://files.readme.io/5f75256-image1.png)

6. Enter the deep link to your bot in the **Sign on URL** box and click **Save**.\
   ![](https://files.readme.io/7b55f77-image7.png)

7. Click **Properties**, note that changing the application’s name does change the name of the app as shown to users, which can take up to 30 minutes to propagate.

8. Change the Logo and enter your bot avatar. Note that it must be 215x215 pixels in size.

9. **User assignment required?** - Can be set to your preference.

10. **Visible to users** - *MUST* be set to “Yes”.\
    ![](https://files.readme.io/d56dd7d-image5.png)

11. Finally assign the app to your company. Here I’ve assigned it to two specific users, but it is recommended that the admin assign it to a group representing **ALL USERS**.\
    ![](https://files.readme.io/4394c5c-image2.png)

12. Give the system a few minutes to propagate the changes and the app should appear in **myapplications.microsoft.com**.\
    ![](https://files.readme.io/f6d1d2e-image8.png)

13. Clicking the icon should lead the user to the bot in chat (it sometimes takes about 30 seconds to process the first launch.