To access Conga Copilot

To access Conga Copilot for Contracts for Salesforce, the administrator must configure Conga Platform and the enable the feature in Contracts for Salesforce. 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 with support from the Conga CloudOps team.

Order TaskOwner
1

Tenant Onboarding  

This task is the responsibility of the administrator and the Cloud Ops team.

  • The administrator contacts the Conga service team to log a service ticket for tenant onboarding.
  • CloudOps team initiates the tenant onboarding process based on the service ticket.
2

Configuring Conga Platform

Administrator
3

Enabling Conga Copilot

Administrator

Tenant Onboarding

Follow these steps to onboard a Salesforce tenant onto the Conga Platform. This process involves collaboration between the Conga CloudOps team and the administrator.

Prerequisites

You have provided the following information to your Conga support representative.

  • Your 18-digit Salesforce org ID
  • Administrator's first name and last name
  • Administrator email ID
  • Your Salesforce org domain name. To view the domain details of your Salesforce org, go to Setup > enter my domain in the Quick Find box and click My Domain. 

To onboard a tenant

Conga support representative logs a tenant onboarding request with the following details.

  • Salesforce org ID
  • Admin user's first name and last name
  • Admin user's email ID

On successful onboarding, the admin user receives a confirmation email containing Conga Org details, Conga Identity Provider (IdP) login credentials, and a one-time password.

To change the password

  1. Click the login URL in the welcome email. 
  2. Enter the username and password. 
  3. Click Sign-in and follow the on-screen instructions to change the password.

To view the onboarded tenant

  1. Login 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. You can see that the tenant has been added successfully.

Configuring the Conga Platform

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

Prerequisites

  • Permission Group CoPilotPermissiongroup is created on the Conga Platform. 
     
  • The following object permissions are added to the CoPilotPermissiongroup permission group. 
    • AiPlatformImportedDocument
    • AiPlatformRawFile
    • AiPlatformJobTracker

To configure Conga Platform

Follow these steps to successfully configure Conga Platform.

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

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. Login 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.
  3. Open the External Integrations tab and 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. Login with your onboarded Salesforce org credentials.
    If you get any access-related prompts during this process, please 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.

     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 the new users will be created with Salesforce IdP.

  9. Click Save. An external integration is added

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.
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 a New User.

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

  • Manual onboarding: 
    After onboarding the tenant, perform these steps to manually onboard users.
    1. Add external integration and enable default IdP for that Salesforce org.
    2. Add a new user and enter the ExternalId field, which is the unique 18-digit Salesforce ID for the provider user.
      After the admin user has successfully 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, perform these steps to automatically onboard users.
    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 to access Co-pilot, the admin user must manually change the user's role to admin.


Configuring UI to API connection

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

To configure 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 IdentifierSelect your 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 NameEnter the client's name.
    DescriptionEnter an appropriate description.
    Redirect URI

    Enter the UI Callback Endpoint. It is the site to which identification and access tokens are sent.

    Cors Origins

    Enter the domain name present in the callback endpoint. It is the base URL of the origin server 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.

Enabling Conga Copilot in Contracts for Salesforce

To enable Conga Copilot in Contracts for Salesforce, see Enabling Conga Copilot.

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