# Microsoft Office365 AAD
iX Hello supports Integration with Microsoft Office Azure Active Directory and also supports few AAD Managed APIs.
1. Microsoft Office365 Configuration in iX Hello
Make sure that you follow [this](https://docs.ixhello.com/ixhc/connections/microsoft-office365-integration-guide) document to configure Office365 configuration in iX Hello.
At this point, you should have successfully connected integration with Microsoft Office365 AAD. To confirm, you can navigate to Integration > Connect System. You shall have a connection of type Office365 AAD there as shown below:
If not, you shall go through Step 1 again and confirm that all the steps have been followed thoroughly.
### Create Custom App:
1. Go to Custom Apps > Manage Apps in left navigation and click on Create New App. Provide the following details to create an app.
| Name: Azure AAD Demo |
| ----------------------- |
| Custom App Type: Search |
| Category: Default |
2. Press Save
3. The next step is to prepare data source for the App. Select the newly created App and go to the Data Source tab. Click on Create New Data Source and fill in the following details:
| Name: Amazon AAD DS |
| ----------------------------------------------------------------------------------------------------------------------------------- |
| Integration Configuration: Microsoft Office365AAD (make sure to select the integration created in at the beginning of the document) |
4. Press Save. The next step is to create methods.
### Create Methods:
At the time of this document, iX Hello supports 3 managed functionalities:
* GetUsersInOrganization
* GetGroupsInOrganization
* GetUsersInADepartment
For this document, we are implementing the GetUsersInOrganization method.
Click on Create New Method and fill in following details:
| Name: GetUsersInOrganization |
| --------------------------------------------------------------------------------------------------- |
| RequestType: GetUsersInOrganization |
| Parameters: No Parameters |
| Result Type: ListOfRecords |
| Record Limit: 10 |
| Record JsonPath: $.value\[\*] |
| Valid Result Template: Here are the users in the organization: {{Records}} How else can I help you? |
| Record Template: {{mail}} |
| Empty Result Template: Sorry, no user found in the organization. How else can I help you? |
After you’ve created the method, you can save and test it. You shall expect the following output..
If you have not received the output as shown above, there is some issue with your app building. You need to revise the steps that you have completed.
1. Go to the Intents tab and click on Create New Intent.
| Name: GetUsersInOrganizationIntent |
| ----------------------------------------- |
| Intent Type: Search |
| Intent Action: Execute Method |
| Data Source: Amazon AAD DS |
| Data Source Method:GetUsersInOrganization |
2. Save.
3. Create Utterances in the Utterance tab. Utterances are short keywords used to invoke the intent.
| Value: list all users |
| ------------------------------ |
| Custom App: Azure AAD Demo |
| Intent: GetUsersInOrganization |
4. Press Save.
5. The next step is to create Input corresponding to the Intent. Go to Input tab, click on Create New Input and provide following details in the resulting screen.
| Name: GetUsersInOrganizationInput |
| ------------------------------------------- |
| Custom App: Azure AAD Demo |
| Custom Intent: GetUsersInOrganizationIntent |
| Data Source: Amazon AAD DS |
| Data Source Method: GetUsersInOrganization |
6. Press Save
## **Publish to Amazon Lex**
1. To publish to Amazon Lex, select “**Publish**” in the top menu tabs then click “**Add App Publishing**”. Then input or select the following:
| External App Name: Azure AD Demo |
| ---------------------------------------------------------------- |
| App Type: Search |
| Channel: Amazon Lex |
| Skill Invocation: active directory Demo |
| Welcome Messages: Welcome to Azure AAD Demo. How can I help you? |
| Auto Publish: Checked |
2. Press Publish
3. Select the Lex account and click on Publish to Amazon Lex
4. On the resulting screen, ensure that a success message shows for the publishing steps before clicking “**Test Lex**”. If a success message not shown, click “**Go Back to App Publishing**” to fix any issue shown in publishing result.
5. Once clicked on "**Test Lex Bot**", you will be redirected to App Publishing screen, and the Test Bot will appear at the right corner showing the App name along with the welcome message:
Congratulation!!! You have successfully completed iX Hello integration with Microsoft Office365 Azure AAD.
