Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

download

Accessing Conga Copilot

Conga Copilot is an AI-powered virtual chat assistant that can both summarize agreements and answer users' questions about them.

Access Conga Copilot

Conga Copilot is an AI-powered virtual chat assistant that can both summarize agreements and answer users' questions about them.

Before you can access Conga Copilot through your Salesforce org, an administrator must manually configure both the Salesforce org and the Conga Platform. An administrator may take on one of several personas, including a customer administrator, partner administrator, or any other administrator tasked with setting up the Salesforce org with the Conga Platform. This individual is responsible for completing the entire setup process.

Order

Task

Owner

1

Tenant Onboarding When you purchase your Conga product, tenant is onboarded automatically. If you do not have access to the Advantage Platform, please reach out to your Conga representative.

For more information on logging in to Conga Advantage Platform, refer to Configuring your Salesforce Org.

2

Configuring Conga Platform

Administrator

3

Configuring Salesforce Org

Administrator

Configuring Conga Platform

Once you have onboarded the tenant, you must configure the Conga Platform.

Prerequisites

  • CoPilotPermissiongroup is created.
  • The following object permissions are added to the CoPilotPermissiongroup permission group.
    • AiPlatformImportedDocument
    • AiPlatformRawFile
    • AiPlatformJobTracker


For more information on creating a permission group and assigning object permissions, see Creating Permission Groups.

Configuring Conga Platform

  • CoPilotPermissiongroup is created.
  • The following object permissions are added to the CoPilotPermissiongroup permission group.
    • AiPlatformImportedDocument
    • AiPlatformRawFile
    • AiPlatformJobTracker


For more information on creating a permission group and assigning object permissions, see Creating Permission Groups.

Once you have onboarded the tenant, you must configure the Conga Platform. Follow these steps to configure Conga Platform.

  1. Add a new external integration
  2. Assign permission group to a role
  3. Add a new user
  4. Configure a UI-to-API connection

Adding a new external integration

This allows administrators to view and manage users authorized through external organizations. You can add one or more external integrations; however, you can make only one as a default IDP.

Adding a New External Integration
This allows administrators to view and manage users authorized through external organizations. You can add one or more external integrations; however, you can make only one as a default IDP.
To add a new external integration
  1. Log in to the Conga Platform as an admin user.
  2. Click the App Launcher () icon from the top-left corner and go to Admin Console > Organization > External Integrations.
  3. Click Add New, raising the Add New External Integration screen.
  4. Choose Salesforce or Salesforce Sandbox from the Identity Provider drop-down list and click Authorize to open the selected IDP's login screen.
  5. Log in with your onboarded Salesforce org credentials.

    If you get any access-related prompts during this process, allow full access.

    When you log in, the selected identity provider's external identifier auto-populates the External ID field.

  6. Enter the type of this integration in the Type field.

    It is a free-form text field. You can add types such as Dev, QA, UAT, Prod, and so on.

  7. Enter the description in the Description field.
  8. Enable the Default IDP toggle to make it a default external integration IdP.
    Note:

    When the admin user creates new users, they are created with the default IdP. For example, if you have set Salesforce as the default IdP, all new users will be created with Salesforce IdP.



  9. Click Save. An external integration is added.

For more information, see Managing External Integrations.

Assigning Permission Group to a Role

Roles determine a given user's access to applications, objects, records, and permissions to perform actions on the Conga Platform. A role is assigned to users performing similar tasks and consists of a set of permissions. As an administrator, you can assign roles to the existing users or create a new user and edit the user details to assign roles.

Assigning Permission Group to a Role

Roles determine a given user's access to applications, objects, records, and permissions to perform actions on the Conga Platform. A role is assigned to users performing similar tasks and consists of a set of permissions. As an administrator, you can assign roles to the existing users or create a new user and edit the user details to assign roles.
To assign permission group to a role
  1. Click the App Launcher () icon from the top-left corner and go to Admin Console > Users > Roles.
  2. Edit the AuthAutoProvisionedUser role and assign the permission group CoPilotPermissiongroup to it.

For more information on assigning the permission group to a role, see Working with Roles.

Adding a new user

You can manage users either manually or automatically through the User Management user interface. The Users tab allows you to:

  • Create, update, and manage users.
  • Import user information.
  • Assign roles to users.
  • Set default options for users. For example, locale, time zone, date and time format, and other preferences.

Adding a New User

You can manage users either manually or automatically through the User Management user interface. The Users tab allows you to:

  • Create, update, and manage users.
  • Import user information.
  • Assign roles to users.
  • Set default options for users. For example, locale, time zone, date and time format, and other preferences.
To add a new user
  1. Click the App Launcher () icon from the top-left corner and go to Admin Console > Users.

    A list of users is displayed.

  2. Click Add to add a new external user.

    The User Details screen appears.

  3. Enter values in the fields and click Save.

For more information on entering information in the fields, see Adding and Activating Users.

Tip:

There are two ways to onboard users: manually or automatically.

  • Manual onboarding:

    After onboarding the tenant:

    1. Add external integration and enable default IdP for that Salesforce org.
    2. Add a new user and enter the 18-digit Salesforce ID for the provided user in the ExternalId field.

      After the admin user has added the user, an email is sent to the provider's email ID.

    3. Users can log in to the Conga Platform using their Salesforce credentials.
  • Automatic onboarding:

    After onboarding the tenant:

    1. Enable the Auto Provision User Enabled toggle in your Organization Details tab.
    2. Add external integration and authorize the external integration.
    3. Users from that external integration can log in to the Conga Platform with their credentials, and the user is automatically created on the Conga Platform.

For example, the admin user has integrated Salesforce as an external service and authorized it. In the Salesforce organization, there are 10–15 users. If this toggle is enabled, any of these users can log in to the Conga Platform using their Salesforce credentials. Upon logging in, their account is automatically created on the Conga Platform. However, their role is not set to admin, so they cannot access Conga Co-Pilot. To grant users access to Co-Pilot, the admin user must manually change the user's role to admin.

Configuring a UI-to-API connection

Establish a UI-to-API connection between your Salesforce org and Conga Platform to ensure seamless communication and data exchange between them.

Configuring a UI-to-API Connection

Establish a UI-to-API connection between your Salesforce org and Conga Platform to ensure seamless communication and data exchange between them.
To configure a UI-to-API connection
  1. Click the App Launcher () icon from the top-left corner and go to Admin Console > Organization.
  2. Go to the Conga API Connections tab and click Add UI-To-API Connection .
  3. Enter values in the following fields.

    Field

    Required Action

    External Identifier

    Select the Salesforce org ID for which you want to configure the connection. The external identifier list is populated based on the external integration that you added.

    Client Name

    Enter the client's name.

    Description

    Enter an appropriate description.

    Redirect URI

    Enter the UI callback endpoint, the site to which identification and access tokens are sent.

    • For production instance: https://prod-rls10.congacloud.com/static/clm/congacopilot/?q=param
    • For preview instance: https://preview-rls09.congacloud.com/static/clm/congacopilot/?q=param
    • For staging instance: https://rls-stg.congacloud.io/static/clm/congacopilot/?q=param

    Cors Origins

    Enter the domain name in the callback endpoint. This is the origin server's base URL to enable cross-site requests.

    For example, https://business-agility-9613-dev-ed.scratch.my.salesforce.com

  4. Leave all the other fields blank.
  5. Click Save & Generate Client Secret to generate the Client ID.


  6. Click Copy next to the Client ID. Save it as SPAClientId for future use.

    The UI to API connection is configured and activated.

  7. Click Save.

You can deactivate or reactivate the API Connections by using the respective hyperlink under the Actions column and edit the configuration by clicking the External Identifier hyperlink on the list page.

Configuring Salesforce Org

Prerequisite

Conga CLM version number 15.770 or later is installed.

To know more about upgrading Conga CLM to the latest version, refer to Upgrading Conga CLM.

Configuring your Salesforce Org

Conga CLM version number 15.770 or later is installed.

To know more about upgrading Conga CLM to the latest version, refer to Upgrading Conga CLM.

After you have configured the Conga Platform, log into your Salesforce org. to set up the following configurations.

  1. Activate the Enable Copilot comply user property. For more information, see Comply User Properties.
  2. Create an admin setting APTS_RLPInstanceSettings and enter the following details specific to Conga Co-Pilot. For more information on creating an admin setting, see Creating an Admin Setting.
    Note:

    If the APTS_RLPInstanceSettings admin setting already exists, you only need to modify SPAClientId, InstanceURL, and Authorization URL in the Code field.



    Field

    Description

    SPAClientId

    A single-page application ID. Enter the Client ID that you generated after configuring the UI-to-API configuration in the Conga Platform.

    InstanceURL

    Conga organization instance URL where the application can retrieve user information. Use any of the following URLs per your Conga instance:

    • For production instance: https://prod-rls10.congacloud.com/
    • For preview instance: https://preview-rls09.congacloud.com/
    • For staging instance: https://rls-stg.congacloud.io/

    AuthorizationURL

    URL used for OAuth 2.0 authorization. It directs a user’s browser to the authorization server to grant access to a third-party application.

    • For production instance: https://prod-rls10.congacloud.com/api/v1/auth
    • For preview instance: https://login-rlspreview.congacloud.com/api/v1/auth
    • For staging instance: https://rls-stg.congacloud.io/api/v1/auth/api/v1/auth

After configuring all the above steps, users can access Conga Co-Pilot. For more information, see Working with Conga Co-Pilot.