Search Knowledge Base by Keyword

Salesforce

Summary

Legito add-on for Salesforce is a Salesforce component that pulls data from Salesforce and applies it to document templates automated in the Legito platform to generate Word or PDF documents, upload the documents to Salesforce, and/or add a link to the Legito Document for users to continue creating the documents in Legito.

Legito add-on for Salesforce is not a stand-alone application, but an extension of the Legito Workspace which allows for easy and smooth integration between Legito and Salesforce accounts.

End User Experience

With the Legito Component, Salesforce users can simply click a button to Create a document directly from a Salesforce page (e.g. Opportunities) instantly generating PDF, Word, and/or Legito documents on the same Salesforce page. The whole process is seamless so users do not need to deviate from Salesforce.

Salesforce users do not need to have a Legito Workspace account if they are only generating Word or PDF documents via the add-on.

For more sophisticated use cases, where Salesforce data prefills documents but the documents still require more decision-making and editing, users can open Legito documents directly from Salesforce. In this case, Salesforce users need a Legito Workspace account. We would also recommend implementing Single Sign-on for a more seamless experience.

Adding Legito Component to Salesforce Lightning Page

Add the Legito App to Salesforce using the following link:

https://login.salesforce.com/packaging/installPackage.apexp?p0=04t2o000000OIWJ

Then use the Lightning App Builder (learn more) to add the Legito Component to your Salesforce Lightning Page.

Go to the Lightning App Builder and edit the Lightning page you would like to add the Legito Component to, or you can create a new one. The Legito Component will generate documents using data from the Lightning page. Customers typically add the Legito Component to the Opportunities Page.

Add the Legito Component to the Salesforce Lightning page via drag and drop from the left menu bar.

Initial Component Set-up

Step 1: Set up the Legito Component

To open the Component setting, click on the cogwheel icon in the right upper corner of the Legito Component. This setting is available to administrators only.

The Component setting is in a modal window divided into 4 tabs:

  • Actions
  • Authentication
  • Template Suite
  • Data Mapping

The Actions tab contains customization of the Component title, button name, link label, and actions.

When a user clicks the Create Document button in the Component, the following actions can be triggered:

  • Generated documents in the Word (docx) format will be uploaded to Notes & Attachments of the Related List Component.
  • Generated documents in PDF format will be uploaded to Notes & Attachments.
  • The link to the Legito document will be displayed in the Component.

Step 2: Identify your Legito server

Open the Authentication tab and insert your Legito server location URL, for example, https://us.legito.com/ or https://emea.legito.com/.

Step 3: Add Legito to your Salesforce Remote Sites

Click on the Open Remote Site Settings button (or navigate via Setup → Security → Remote Site Settings), click the New Remote Site button, insert your server location URL again, and confirm.

Step 4: Insert Keys

Go to the API Keys section in your Legito Workspace, generate the API keys (learn more), go back to the Authentication tab of Legito Component in Salesforce, and insert both API Keys.

Optionally, you may verify if you made the three previous steps correctly by clicking on the Test Connection button.

Step 5: Build a Template in the Legito platform

Once your Salesforce settings are complete, open your Legito Workspace and automate your documents (learn more) if you haven’t already done so.

The Template Suite tab is purely informative. You can skip this if you are an experienced Legito user.

Step 6: Download the JSON file

When your Template Suite is ready, open the Data Mapping tab and download the JSON file example which contains the data structure of the Salesforce Lightning Page being used to generate a document from the Template Suite.

Step 7: Set up JSON Integration in the Legito platform

Create a JSON Integration (learn more) in the Legito Workspace using the downloaded JSON file.

All logic regarding documents, e.g., which templates are used, which document clauses are added, removed, or modified, where data from Salesforce is populated in documents, is set in the Legito Workspace, all with no coding required. Logic does not need to be set in Salesforce.

Step 8: Generate your first Document

Close the Legito Component settings and click the Create Document button in the Legito Component on the Lightning Page.

The page is automatically refreshed. You should be able to find one or more documents in Notes & Attachments and/or link to the Legito document in the Legito Component.

Legito Add-on Administration Area

The Legito Add-on for Salesforce contains an Administration Area in addition to the core Legito Component.

There is no need to use the Administration Area to make the Legito Component work.

The purpose of the Administration Area is to provide Salesforce admins with the available data in the Legito Workspace for further usage in more complex integrations between Legito and Salesforce.

The Administration Area is only available to Salesforce admins.