# Integrations

## What do integrations offer?

Throughout the app, ClauseBuddy offers possibilities to use external documents — e.g. to compare documents, summarise documents or extract clauses from contracts. Those documents can either be uploaded by the user (e.g., by dragging documents from the filesystem), or can be retrieved from an external system that gets integrated into ClauseBuddy. 

ClauseBuddy currently supports three such integrations: document solution iManage, legal workflow solution LawVu and Office 365/OneDrive. In the future, we expect additional integrations to be added.

In the screenshot below, you can see all options presented, with the manual upload at the left, and the various integrations at the right.

<div data-full-width="false"><figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2F6Ow3VIxQngrIFxgnGgV5%2Fimage.png?alt=media&#x26;token=9767dd86-59fe-4393-a9b2-2f1587e425ff" alt="" width="563"><figcaption></figcaption></figure></div>

## Configuring the integrations

{% hint style="info" %}
Conceptually, all three integrations are set up in the same way, so we handle them jointly, only noting the small differences.
{% endhint %}

### First step: enabling integrations at the customer-level

Ask your ClauseBuddy customer support representative to enable your selected integration(s) at the customer level. This is not a step that customer administrators can do themselves, because there may be additional licensing costs involved.&#x20;

When an integration is disabled at the customer-level (which is the default), no user will see the integration in modules such as those depicted in the screenshot above.

{% hint style="info" %}
It is not currently possible to selectively enable/disable the integrations for some users or profiles. The integrations are either enabled at the customer-level (i.e., made available to all users), or disabled altogether.

However, as is explained below, each user must make their *own* integration connection, using their *own* external credentials.
{% endhint %}

### Second step: configuring the integration as an administrator

When logged in as an administrator, go to *Administration* in the dropdown menu in the upper-right corner of ClauseBuddy. In the screen that appears, choose the tile *Integrations*.

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FJmfnUoVL9RooIkj0HtA7%2Fimage.png?alt=media&#x26;token=4c2e5742-99dc-4420-99d2-f8d59c9878e6" alt="" width="563"><figcaption></figcaption></figure>

In the screen that appears, click on to the *Admin* tabsheet. You will then see the already configured integrations at the customer-level. For example, in the screenshot below, the integration for LawVu is already configured.&#x20;

Click on the green *Add integration* button to add a new integration.

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FFchuyyl6SYxeEgzHfaFX%2Fimage.png?alt=media&#x26;token=288c54e3-11ac-473d-843a-c502ecc50dcd" alt="" width="563"><figcaption></figcaption></figure>

Next, you may optionally want to change the default settings of the integration by clicking on the cog icon to the right of the integration (not relevant for Microsoft 365). These settings will apply to all subsequent ["Integration connections" by individual users](#third-step-have-each-user-log-into-the-external-system).

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FebmY4j5pSC2gFgAEnME0%2Fimage.png?alt=media&#x26;token=2ae55db5-5f73-40c7-bfac-2c3cc3012e78" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2Fv5obAN3YGT3gjbqrnNcw%2Fimage.png?alt=media&#x26;token=63cdbbe0-5603-4d75-8bc4-cf8bcfda5fd8" alt="" width="563"><figcaption></figcaption></figure>

### Third step: have each user log into the external system

The final step is to have each user create an "Integration connection" to the external system, using their own external credentials (via an [industry-standard OAuth2 flow](https://oauth.net/2/)). This can be done adhoc, when the user actually wants to retrieve a document from the external system — this will be indicated by having the menu being greyed out and saying *click to connect*, as illustrated below. &#x20;

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FN2ENJl4LK2HbY1sR6dnr%2Fimage.png?alt=media&#x26;token=823344d0-fbb5-4f1a-9d5a-4293f9e088da" alt="" width="375"><figcaption></figcaption></figure>

When the user would click on one of the *click to connect* options, a popup window will appear with the login screen for the external system. They should then use their own external credentials to log in, and grant any necessary permissions to ClauseBase.

{% hint style="info" %}
ClauseBase neither receives nor stores users' external login credentials. For more information, see <https://oauth.net/2/>.
{% endhint %}

Once the connection is established, users can disable the connection by going to the *Integrations* option in the dropdown menu in the upper-right corner.&#x20;

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FAvfY3bY44mDrOaCLILuk%2Fimage.png?alt=media&#x26;token=c4b4caad-cfa5-4260-b569-7d0818b11a65" alt="" width="202"><figcaption></figcaption></figure>

They will then arrive at a table that shows all currently established connections.

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FeITkdjWpa1nSuwZMnl3Y%2Fimage.png?alt=media&#x26;token=eaf60635-c77f-4e90-b801-d1e99bc489bd" alt=""><figcaption></figcaption></figure>

### Fourth step: retrieving documents

Assuming the connection with the external system is established, the user will see a dialog box that allows to select & download relevant documents. This dialog box will slightly differ for each external system, as each external system offers different search & organisation possibilities.&#x20;

For example, the dialog box for LawVu would show:&#x20;

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FRiijhAZjjvSS9zfzVp89%2Fimage.png?alt=media&#x26;token=e94d3520-d16d-48da-8d15-49589dab2e53" alt=""><figcaption></figcaption></figure>

While Office 365 shows:&#x20;

<figure><img src="https://390020280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGA4f8p0Q1FUdXDqKdM5%2Fuploads%2FkPfKHUe6Q2Cm6Fag5IkI%2Fimage.png?alt=media&#x26;token=08aa39da-8901-4084-bfb5-2c980c8f796c" alt=""><figcaption></figcaption></figure>