Microsoft Office365 AAD

ixHello supports Integration with Microsoft Office Azure Active Directory and also supports few AAD Managed APIs.

1. Microsoft Office365 Configuration in ixHello

Make sure that you follow this document to configure Office365 configuration in ixHello.

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
Save.

1. Next step is to prepare data source for the App. Select the newly created App and go to 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)

Click on Save.

Our next step is to create methods.

Create Methods:

1. ixHello at the time of this document compilation supports 3 Managed functionalities.

2. GetUsersInOrganization

3. GetGroupsInOrganization

4. GetUsersInADepartment

For this document, we are implementing 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 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’ve completed yet.

1. Now, 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
Save

1. Now, 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
Save

1. 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
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
Publish

1. Select the Lex account and click on Publish to Amazon Lex

1. On the resulting screen, ensure that a success message shows for the publishing steps before clicking “Test Lex”. If success message not shown, click “Go Back to App Publishing” to fix any issue shown in publishing result.

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 ixHello integration with Microsoft Office365 Azure AAD.