After your organization and admin user have been onboarded, you must synchronize data from the source system to the Conga Platform. Before synchronizing data, you must connect the source and target systems. This section provides guidance on how to configure this connection.

Data Sync currently supports only Salesforce as the source system.

You may come across source object fields that use formula expressions, for example, to calculate the net price of a line item using the formula SalesPrice * Quantity. These source formula expressions might be written differently or in a format incompatible with the formula expressions supported by the Conga Platform. To ensure smooth synchronization, it is essential to convert these source formula expressions into a format compatible with the Conga Platform. For more information on transforming formula expressions, see Creating Formula Fields.

To configure data sync infrastructure

  1. Log in to the Conga Platform as an admin user.
  2. Click the App Launcher () icon from the top-left corner > Admin Console > Data Sync.
  3. Click the More () icon on the Data Sync UI, and then click Settings. The Settings page is displayed.
  4. Configure the Salesforce, Platform, Email Notification, and Custom Settings by following the below steps:

    Prerequisite

    You must first enable the OAuth Username-Password Flows configuration in your Salesforce org, as shown below:

    1. Log in to the Salesforce org as an administrator.
    2. Go to Setup > Identity > OAuth and OpenID Connect Settings.
    3. Toggle Allow OAuth Username-Password Flows on.

    Salesforce Settings

Go to the Salesforce Settings tab and enter values in the following fields:

Salesforce settings are mandatory to enable seamless data sync operations. Ensure that the information you enter in Salesforce Settings belongs to the Salesforce Org ID (External ID) that has been authorized for the external integration. For more details, see Managing External Integration.

FieldDescription
UsernameEnter your Salesforce account username.
PasswordEnter your Salesforce account password. When you enter the password, dots replace the characters for security reasons. To see or hide the characters, click the eye icon.
Token URL

Enter the token URL. You may use either a sandbox or production instance URL to access the OAuth2 token service.

Secret

Enter the security token in this field. When you enter the security token, dots replace the characters for security reasons. To see or hide the characters, click the eye icon.

To get the secret, you must begin by resetting the security token associated with the Salesforce account. After the security token is reset, the new security token will be sent to the email address specified in the Salesforce personal settings. For step-by-step instructions on resetting the security token, see Reset Your Security Token.

If you are unable to see the option to reset your security token, see Troubleshooting.

Client ID

Client Secret

Enter the consumer key generated after creating the connected app.

Enter the consumer secret generated after creating the connected app. When you enter the client secret, dots replace the characters for security reasons. To see or hide the characters, click the eye icon.

For more information on creating a connected app and getting the client ID and secret, see Create a Connected App.

Domain URL

Enter the domain URL for the Salesforce portal. We recommend using the classic URL format that ends with ".salesforce.com".

The system does not currently support URLs formatted for Lightning mode, which end with ".lightning.force.com".

For example, use "https://<domainname>.my.salesforce.com/" URL instead of  "https://<domainname>.develop.lightning.force.com/" URL.

Salesforce API Version

Enter the latest version in vVersionNumber (e.g., v61.0) format. For more details on getting the API version information, see Find Salesforce Edition and API version

Platform Settings

Go to the Platform Settings tab and enter values in the following fields.

Platform settings are required for seamless data sync operations.

FieldDescription

Client ID

Client Secret

Enter the client ID generated after creating the API-to-API connection.

Enter the client secret generated after creating the API-to-API connection. When you enter the client secret, dots replace the characters for security reasons. To see or hide the characters, click the eye icon.

For more information on creating the API-to-API connection and getting the client ID and secret, see Conga API Connections.

Token URL

Enter the region-specific Conga Platform token URL.

For example:

Preview Environment:

NA: https://login-rlspreview.congacloud.com/api/v1/auth/connect/token

EU: https://login-preview.congacloud.eu/api/v1/auth/connect/token

AU: https://login-preview.congacloud.au/api/v1/auth/connect/token

Production Environment: 

NA: https://login-rls.congacloud.com/api/v1/auth/connect/token

EU: https://login.congacloud.eu/api/v1/auth/connect/token

AU: https://login.congacloud.au/api/v1/auth/connect/token

Email Notification Settings

You can set email notifications for the following data sync events:

    • Sync Start: when a data sync begins
    • Sync Completion: Once the data sync process is completed
    • Sync Failure: In case of a data sync failure

Go to the Email Notification Settings tab and enter values in the following fields:

FieldDescription
To

Enter the recipient's email address. You can add multiple email addresses using commas. You can also add recipients in the Cc and Bcc fields.

FromEnter the sender's email address. The system uses the default email address if left blank.
Enable Sync Start Notification

Enable this toggle to send a notification when a data sync begins. 

Sync Started TemplateSearch and select the email template for the sync start notification. The default template is filled in automatically.
Enable Sync Failed Notification

Enable this toggle to send a notification when a data sync fails.

Sync Failed TemplateSearch and select the email template for the sync failed notification. The default template is filled in automatically.
Enable Sync Completed Notification

Enable this toggle to send a notification once the data sync process is completed.

Sync Completed TemplateSearch and select the email template for the sync completed notification. The default template is filled in automatically.

If you do not select a specific email template, the system uses the default template to send notifications. You can create a new template or make changes to the default template. For more information, see Managing Email Templates.

Custom Settings

Go to the Custom Settings tab and select the desired option to sync CLM/CPQ product data. A confirmation window appears. Click Yes.

The application allows you to sync the following settings:

App-Specific Sync OptionsDescription
CPQ FlowsFlows are groups of pages that are assigned to each step in the CPQ process.
CPQ DisplaysHolds information about fields displayed in the installed product view.
CPQ ActionsHolds information about custom actions displayed in the installed product view.
CPQ Custom SettingsThis standard Salesforce custom settings page lists all legacy custom settings.
CPQ Cart ViewsThe public cart view created by the user.
CLM Config Settings

The application settings available in Config Settings.

These custom settings are currently applicable to CPQ (Configure, Price, Quote) and CLM (Contract Lifecycle Management) users. Whenever there is an update in the above settings (flows, displays, actions, custom settings, etc.) within the source system, you must perform this activity to ensure synchronization between both systems.