Communications Mining user guide

Last updated Oct 7, 2025

Salesforce integration

Important: You will be charged 1 AI Unit or 0.2 Platform Units per created comment, or per updated comment, based on its unique ID, if its text was modified.

The Communications Mining™ Salesforce Integration provides a convenient and easy-to-setup way to sync your Salesforce communications data into Communications Mining in real time. The integration is capable of syncing emails and other communications data.

Overview

The Salesforce Integration is a managed pipeline running on the Communications Mining™ cloud that can be configured to extract pieces of communications data from Salesforce objects without any development needed.

Once the integration is configured it will continuously poll for the configured objects and fields in Salesforce, clean them, enrich them with object metadata and convert them to Communications Mining comment objects. The Communications Mining comments will be available on the web interface and from the API to any user with the right access.

Access to Salesforce data via the Salesforce Integration is managed through Salesforce Connected Apps and authenticated with OAuth2, giving you full control of when and how much you give Communications Mining access to your data.

Salesforce Integration Architecture

Creating a connected app

In order to provide Communications Mining™ access to your Salesforce instance, a Salesforce administrator will need to create a Connected App.

It's worth familiarizing yourself with the concepts of Connected Apps, but to set up the Communications Mining Salesforce Integration the following steps should be sufficient. These steps should be completed using the same account that the Connected App will be authenticated with.

Note:

INTEGRATION USER

Any Salesforce user with the right access to the data you'd provide to Communications Mining can be used to authenticate the integration. In general, it's recommended to use a dedicated integration user for this so that the Salesforce Integration is not tied to a specific person's account. For more details on the Salesforce recommendations on this topic, check The Value of Having A Dedicated Salesforce Integration User.

In your Salesforce Setup, under Apps, select App Manager and select New Connected App.
Create a new Connected App in Salesforce
Follow the guidance from Salesforce and fill in the required information, such as App Name, API Name and Contact Email. The following is an example:
Example required information
Select the checkbox Enable OAuth2 Settings, this will open up a new section of options.
1. Make sure that the application does not require Proof Key for Code Exchange (PKCE).
Under Callback URL, insert the following line, replacing <mydomain> with your tenant domain: https://<mydomain>.reinfer.io/external/salesforce/oauth2/callback.
The following scopes are required for the Salesforce Integration to work. Add them to Selected OAuth2 Scopes.

OAUTH2 SCOPES
Manage user data via APIs (api)
Perform requests on your behalf at any time (refresh_token, offline_access)

The required OAuth2 settings for the Connected App
You do not need to change any of the other settings. Select Save at the bottom of the page to create the Connected App.
Take note of the Consumer Key and Consumer Secret of the Connected App you just created. You will need to send them to us to set up the integration.
Consumer Key and Consumer Secret

OAUTH2 SCOPES
Manage user data via APIs (api)
Perform requests on your behalf at any time (refresh_token, offline_access)

Salesforce integration

Setup

The Salesforce Integration will be set up by a Communications Mining™ engineer using the information you provide. Contact your account team to connect with an engineer.

Once you created the Connected App, provide your Communications Mining engineer the following details.

Note: You need to contact the UiPath® Professional Services team to help set up the integration.

Connection Details

NAME	DESCRIPTION
Consumer Key	A long string of letters and numbers, found on the page for the Connected App
Consumer Secret	A long string of letters and numbers, found on the page for the Connected App
Instance URL	Your Salesforce instance URL, e.g. `um6.salesforce.com`. For more details on how to find it, check the Salesforce documentation.

Salesforce Objects

The Salesforce Integration can be configured to poll for any of your standard or custom Salesforce objects. For each object you would like to sync into Communications Mining, provide the Salesforce API names of the objects and its fields.

Permissions

Please ensure that the user used to authenticate the integration has "Read" and "View All" access to the objects and "Read" access to the fields you would like to sync into Communications Mining.

OAuth2 Authentication

The integration needs to be authenticated to get access to your Salesforce data. This is done through OAuth2 with an authorized Salesforce account. You should authenticate the integration using the same account that was used to set up the Connected App.

Navigate to the authentication URL that we provided. It will look like this:
```
https://<mydomain>.reinfer.io/integrations/<project-name>/<integration-name>/oauth2/authenticatehttps://<mydomain>.reinfer.io/integrations/<project-name>/<integration-name>/oauth2/authenticate
```
where <mydomain> is your tenant domain, and <project-name>/<integration-name> are the project and name of your Salesforce Integration.
You will be automatically redirected to a Salesforce login page. Log in with the Salesforce account that will provide access to the integration. The browser will redirect to a confirmation page.
Salesforce OAuth2 Login Page
On the confirmation page, approve the requested permissions.
Salesforce OAuth2 Confirmation Page
Once done, you should be redirected back to https://<my_tenant>.reinfer.io with a notification indicating the integration was configured successfully.