Microsoft Office365 AAD
VoiceWorx supports Integration with Microsoft Office Azure Active Directory and also supports few AAD Managed APIs.
Microsoft Office365 Configuration in VoiceWorx
Make sure that you follow this document to configure Office365 configuration in VoiceWorx.
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:
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. |
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:
VoiceWorx at the time of this document compilation supports 3 Managed functionalities;
GetUsersInOrganization
GetGroupsInOrganization
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.
Now, Go to the Intents tab and click on Create New Intent.
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 |
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 |
Click on Save.
After the components of the app have been build, let’s publish the app to any of the VoiceWorx supported channels. In the Publish tab, click on Add App Publishing.
External App Name: Azure AD Demo |
App Type: Search |
Channel: Alexa |
Skill Invocation: active directory Demo |
Messages: All messages shall auto-populate. If not, you can edit and customize them to favor your business requirements. |
Auto Publish: Checked |
Publish |
Select the LWA account and click on Publish to Alexa
On Success, you shall observe following screen. This means that the custom app has been published to the Alexa developer console. Now, Click on Go to Alexa Skill and test the skill if it is working as per the required functionality.
Congratulation!!! You have successfully completed VoiceWorx integration with Microsoft Office365 Azure AAD.
Last updated