- API docs
- CLI
- Integration guides
- Exchange Integration with Azure service user
- Exchange Integration with Azure Application Authentication
- Fetching data for Tableau with Python
- Elasticsearch integration
- Self-hosted EWS integration
- UiPath Automation Framework
- UiPath Marketplace activities
- UiPath official activities
- Blog
- How machines learn to understand words: a guide to embeddings in NLP
- Prompt-based learning with Transformers
- Efficient Transformers II: knowledge distillation & fine-tuning
- Efficient Transformers I: attention mechanisms
- Deep hierarchical unsupervised intent modelling: getting value without training data
- Fixing annotating bias with Communications Mining
- Active learning: better ML models in less time
- It's all in the numbers - assessing model performance with metrics
- Why model validation is important
- Comparing Communications Mining and Google AutoML for conversational data intelligence
Communications Mining Developer Guide
Exchange Integration with Azure Application Authentication
This step-by-step guide will show you a popular method for creating a Microsoft Exchange application for Communications Mining in your Azure Cloud Platform. You'll learn how to create an Application (client) with an ID and Client Secret, and find your existing Directory (tenant) ID. This will allow users to access Exchange mailbox integrations in Communications Mining.
Failure to create an Exchange-Communications Mining application in Azure can lead to permissions errors that prevent users from accessing their mailbox integrations. To gain the full benefits of Communications Mining, follow these steps and complete the process in its entirety.
- Sign into your Azure portal.
- Go to the App Registrations menu and select New
Registration.
- Fill in and configure the required fields:
- Name: for example,
reinfer-exchange-integration. - Supported account types: select the single tenant option.
- Name: for example,
- Select Register, which redirects you to a page with details of the registered application, such as Application (client) ID, Directory (tenant) ID.
To keep your application secure, create a client secret as follows:
- Select Certificates and secrets under the Manage drop-down list.
- Select New client secret under the Client secrets tab.
- This opens the Add a client secret sidepanel.
- Fill in the required fields:
- Description: enter a description for the client secret.
- Expires: select an expiry date. The recommended option is 12 months.
- Select Add.
- The client secret is displayed under the Value column.
When using the Microsoft Graph API
- Go to API permissions under the Manage drop-down list.
- Select Add a permission.
- Select Microsoft Graph under the Microsoft APIs tab.
Figure 1. The Microsoft APIs tab
- Select Application permissions.
Figure 2. The permission options of Microsoft Graph
- Expland the Mail drop-down list and select the Mail.Read
permission.
Figure 3. Selecting a permission
- Select Add permissions.
- Select the MailboxFolder.Read.All permission.
Figure 4. Selecting a permission
- Select Add permissions.
- Back in the API permissions menu, select Grant admin consent for Communications Mining.
- Select Yes in the Grant
admin consent confirmation pop-up.
When using the EWS API
- Go to the API permissions under the Manage drop-down list.
- Select Add a permission
- Select APIs my organization
uses.
- Search for Office 365 Exchange Online and select it.
- Select Application
permissions.
- Select the full_access_as_app permission.
- Select Add
permissions.
- Back in the API permissions menu, select Grant admin consent for Communications Mining.
- Select Yes in the Grant
admin consent confirmation pop-up.
At this point, you may want to limit the application permissions so that it can only access certain mailboxes within your organization. To learn how to do this, check Limiting application permissions to specific Exchange Online mailboxes in the official Microsoft documentation.
- Go to Communications Mining by accessing IXP in Automation Cloud and selecting Communication Data.
- Select the Integrations tab under the settings option.
- Select New
integration.
- Select an existing project, enter a name for your integration, and, optionally, a title.
- Select Continue.
- Fill in and configure the required fields as follows:
- Oauth Authority: enter the previously generated tenant ID in the
following format:
https://login.microsoftonline.com/{tenant_id}. - Oauth Client Id: enter the previously generated client ID.
- Client Secret: enter the previously generated client secret.
- Oauth Authority: enter the previously generated tenant ID in the
following format:
- Select the option With application access.
- Select Validate and save credentials to check that your credentials are valid.
- Select Continue.
Figure 5. The create a new integration configuration page
- Select Add Mailbox to open the mailbox form.
- Enter the email address for which you want to copy emails into Communications Mining.
- Select Add Mailbox again to save the mailbox.
- Select Create
Integration.
You have now successfully created an integration between Communications Mining and Microsoft Exchange through Azure. You can disable the integration by hitting the switch in the top-right corner of the Integrations page. To delete it, select the trash can icon.
You can also enable attachment syncing at mailbox level on an Exchange integration. The streams API then makes the attachments retrievable via an attachment reference. Check more about syncing attachments in the Attachments and Using Exchange Integrations pages.
If you have any questions or need assistance with the integration process, please contact UiPath support.
- Introduction
- Why is a successful integration important?
- The step-by-step integration process
- 1. Register a new Communications Mining application
- 2. Create a client secret for a Communications Mining application
- 3. Set API permissions
- 4. Restrict mailbox access with a conditional access policy
- 5. Create a new integration in Communications Mining
- Final steps
