Integrating Conga CLM with External Systems (2024)

Additional steps are required when you choose to integrate Conga CLMwith external applications, customer portals, or other critical business systems. Because Contract Management Web Services are hosted on Salesforce, you should familiarize yourself with the Salesforce SOAP API and processes surrounding integration and best practices detailed here:https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_quickstart_intro.htm

The following basic steps are required to get started using the Conga CLMWeb Services API.

1. Generate the Enterprise or Partner WSDL – Integration with data stored in Salesforce requires you to first point your browser to the Salesforce Enterprise or Partner WSDL. This WSDL is generally provided by Conga Professional Services. Refer to Salesforce Documentation for complete instructions on generating the Web Service WSDL.
2. Generate the CongaWeb Services WSDL– After you have connected to Conga Web Service, go to your organization and download the WSDL for the appropriate Web Service (Contract Management Web Service, Batch Update, Proposal Web Service, and so on).
3. Import the WSDL Files Into Your Development Platform– After you have generated the WSDL files, you can import them into your development platform. Conga does not provide instructions for the import process. Refer to Salesforce documentation or documentation related to your development platform.
4. Connect to Conga– Before you can begin using Contract Management Web Services, you must first authenticate to Conga using the login() API.

Generating theConga CLM Web Services WSDL

Before you can import Conga CLMSOAP Web Service into your development or testing platform, you must generate and download the Conga CLMWSDL for the appropriate Web Service.

The example provided here uses SoapUI.

To generate the Conga Web Services WSDL

1. Log in to the Salesforce organization that contains your Conga records and data (sandbox or production).
2. Go toSetup > Develop > Apex Classes (on Lightning, go toSetup > Custom Code > Apex Classes.
3. Find the Web Service you want to generate the WSDL for (for example,Contract ManagementWebService).
4. Click theWSDL link to generate the WSDL. The WSDL XML is generated and displayed in a new tab.

   

5. Right-click on the page and selectView Page Source. Copy the XML content to any text editor.
6. Save the file with the extension .wsdl.
7. Open SoapUI (or wherever is required on your development platform).

8. Create a new SOAP project and import the Conga Web Services WSDL. All methods under that Web Service are now available to call.

   See Also

   Update M49 - Patch Notes - Star Trek

   

   Refer to theRequest/Response XMLsection for any API in this reference to get the structure of the request and any prerequisite calls required for any API.

Connecting toConga CLM

After you have downloaded the Enterprise or Partner WSDL, call the login() method to obtain a session ID from your org that you can use when calling Contract Management Web Services. After authenticating, you can use the same session ID until it either expires or your logout or login again.

The example provided here uses SoapUI, an API testing tool which can be downloaded for free here:https://www.soapui.org/.

Prerequisite: To authenticate with Conga, please make sure to have your production or test org credentials on hand (username and password).

To connect to Conga Web Service using SoapUI

1. Open SoapUI. Go toFile > New SOAP Project.
2. Enter a name for the project.
3. ClickBrowse. Navigate to the saved Enterprise or Partner WSDL file that you downloaded and clickOpen.
4. ClickOK to close the project window.
5. From the Navigation panel to the left, highlight the project folder and click to expand. Click to expand theSoapBinding. The list of methods that comprise the Enterprise or Partner services are displayed.

6. Scroll down and right-click onlogin. Double-click on an existingRequest. The request window opens in the SoapUI interface.

   

   If you are doing this for the first time, you need to right-click on thelogin method and selectNew Request.

7. Select and delete all content following the<soapenv:Header> tag and the</soapenv:Header> tag.
8. Enter the username for your org (must have appropriate privileges) between the<urn:username> and</urn:username>tags.

9. Enter the username for your org (must have appropriate privileges) between the<urn:password> and</urn:password>tags.

   The request should look like the following:

   <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:partner.soap.sforce.com"> <soapenv:Header> </soapenv:Header> <soapenv:Body> <urn:login> <urn:username>username@example.com</urn:username> <urn:password>password</urn:password> </urn:login> </soapenv:Body></soapenv:Envelope>

   JS

10. From the upper-left corner of the window, click theRun() icon. The response is generated in the right-hand window.
11. Make note of theserverURL and thesessionId returned by the server. You will use the information to make Conga Web Service calls.