Home‎ > ‎Site Admins‎ > ‎

Third Party Integrations



Purpose: Connect LegalServer to the other tools that you need to enable your staff to work more efficiently, report more effectively, and improve their day.

Cost: Dependent on the Module.



Resources

LegalServer wants you to be able to make the best use of your site. If you have issues enabling any of these integrations or modifying them for your organization, please reach out to LegalServer Support at support@legalserver.org. Some things can be handled quickly by email. Others may require purchasing a block of support hours for 1 on 1 support. If there is something that you want to integrate with that isn’t available, please reach out to let us know. We can look to add it to our feature wishlist or give you a development quote to get it out sooner.

Additionally, there is a separate email list for API Integrations with LegalServer. Email api_integration+subscribe@legalserver.org to get added to the list.

If you are considering a new integration with LegalServer, please reach out to support@legalserver.org. We really want to support you in using purpose built tools to make everything easier. A couple of things to consider in your project:
  1. We don’t want to be the gatekeepers of authentication for your third-party partners. You’ve got control of that for your Demo and Live sites. While we can help get the framework setup, providing access/logins to the third-party vendors is up to you.
  2. Scope creep can be really difficult to manage. If we’re customizing an API endpoint, we need to know all the relevant fields at the onset to avoid double work. If custom fields are involved, they need to be created before work begins.
  3. Aim for a Minimum Viable Product and then build off of it. Start small like with Henrik Kniberg’s example of how to scale a project:

  4. Who will be maintaining and supporting this long term? LegalServer’s support typically stops at your LegalServer site. While we will look at LegalServer logs and troubleshoot a few example API calls, we’re not going to be building the external pieces of the integration or maintain them over time for security upgrades or refinements.

Built-in Integrations

SharePoint

Please see our documentation for the Sharepoint Module. There is more that can be done by leveraging Power Automate and other Microsoft tools. For example, you can enable automatic RTF to DOC/DOCX conversion to allow convenient editing in Word Online from documents generated by LegalServer. Or you can automatically create subfolders in any Sharepoint Case folder. Some examples are included in our Sharepoint documentation.

Dropbox

Please see our documentation for the Dropbox Module

Google Team Drive

Please see our documentation for the Google Team Drive Module

Twilio (SMS)

Please see our documentation for the SMS Module

Calendar Rules

Please see our documentation for the Calendar Rules

Accoounting and Payroll Export Module

Please see our documentation for the Accounting and Payroll Export Module

HotDocs and LawHelp Interactive

Please see our documentation for the Hotdocs and LHI Module

iFrame

Using an iFrame, you can embed any other existing site. This method has become more disfavored by browsers, so it may not work with everything. Some good examples of this can be embedding videos, Google Documents/Sheets/Calendars, Calendly calendars, or key resources like JustFix.NYC’s Who Owns It.

Integrations Community Call on iFrames


Instructions with HTML

Instruction elements on a page can also contain HTML and are another way to utilize iFrames or links.

Pro Bono Opportunities API/Pro Bono Matters API

Please see our documentation about Pro Bono Opportunities API.

Custom Integrations

Getting Data Out of LegalServer

To get data out of LegalServer, consider where the request is coming from. If it is coming from an external site to pull data from LegalServer, look at the Reports API which turns any report into an API endpoint, complete with potential filters. Or you can look at our existing suite of APIs which include a wide number that can return information about cases or clients.

If the request to get data out of LegalServer should initiate from within LegalServer on an as needed basis, look at the Generic Outgoing API or the Guided Navigation API options.

Getting Data Into LegalServer

Here’s where our APIs really help. Please explore them at https://apidocs.legalserver.org. We’ve got APIs that let you create an Online Intake from another platform or create case notes on existing cases. There are a myriad of possibilities and we’re interested in supporting you further.

Examples

ClicData

Using the Reports API, ClicData can consume the information for Dashboard and visualizations.

Integrations Community Call on ClicData


Create a Case Note from any Process

If you want to log case notes automatically when a user does something specific, (e.g., “Documents Reviewed” or “Services Requested”) you can put the Generic Outgoing API block on the process using the Create Case Note API


The API authenticates with the API user and so you can easily add a case note in the background to any process or form being completed. The GOAPI block isn't visible on the front end, so you can put it wherever you like. You can pass a data structure for the note instead, but then the note text is a JSON string instead of something more legible. On the other hand, if you use a data structure, you can put various variables into the notes.

Docassemble

Using Docassemble’s New Interview Session API and Set Variables in an Interview API, you can start an interaction with Docassemble to process an interview from Guided Navigation. These two API calls would need to be on successive segments of a Guided Navigation Dialogue, but from the first API call, you can capture the Secret and Session parameters to then pass on for the second API call. Depending on your Docassemble Interview, you could then have it process in the background, send a completed document to LegalServer, or do something else. Utilizing jq to parse the API responses, you can set various fields within LegalServer as a result.

Alternatively, there are a number of Github repositories that can also extend Docassemble to LegalServer. Consider Docassemble-GBLS which transforms an instruction into a list of Docassemble Interviews or Docassemble-LSLettersEmails, which offers a different method of form letter generation. These repositories are offered as examples and will require individuals with experience in configuring Docassemble.

Frontline SMS

Frontline SMS is designed for Text Message Surveys. Using a combination of the Guided Navigation with an API call to get information to Frontline SMS, and then APIs to get the information returned, Cleveland Legal Aid has an integration described in the following video:

Integrations Community Call on SMS Surveys


The API used by Frontline SMS to update the case in LegalServer was Create Multiple Case Notes.

Google Data Studio

Using the Reports API as indicated above, you can pull data into the Google Data Studio for dashboard reporting. Here is an example:

Integrations Community Call on Google Data Studio


HelloSign

HelloSign can utilize templates that require certain variables before they can get signed. See https://app.hellosign.com/api/templatesAndApiWalkthrough and https://app.hellosign.com/api/signature_request/send_with_template. For example, a Referral Authorization can have both the Client and the Attorney sign the form. You’ll have to pass both their names and email addresses. You can also pass other custom fields that might be necessary for the document.


In the example above, the following fields are passed:
  • Message: this is the message in the email to the recipients.
  • Test_mode: this is required for API testing. In live situations, you would exclude this parameter.
  • Signing_redirect_url: this redirects you when you finish completing the form.
  • Template_id: this is the UUID from the template itself
  • Subject: this is the subject of the email.
  • signers[Attorney][email_address]
  • signers[Attorney][name]
  • signers[Client][email_address]
  • signers[Client][name]
  • custom_fields[Forum]: sample custom field on the form. Please note that this is the deprecated version on the HelloSign endpoint since we can’t pass a list within an array.
  • custom_fields[Problem]
  • ccs[CaseFile][email_address]: the case email to receive a copy once it has been completely signed
The template had three roles created -- Client, Attorney, and CaseFile. CaseFile is just for a copy of the completed document, while the other two are required signatures.

You’ll also need to include the Authorization token or header in the HTTP headers section.

Microsoft Power BI

Using the Reports API as indicated above, you can pull data into Microsoft Power BI for dashboard reporting. Using the Reports API

Salesforce

Salesforce can be configured to utilize the Online Intake Import to then create a new Electronic Case Transfer pending case.

Through a combination of Reports using the Reports API to update Salesforce, and a variety of our user APIs to update users, organizations can use Salesforce to update and interact with their volunteers. There are quite a number of potential APIs to use with this:

The key endpoints are:
These combined with the Reports API (which can now filter reports based on the UUID, name, or email address) should allow you to integrate with any other volunteer/attorney management platforms.