Document Insights

Post Installation Steps - Ocrolus & Ocrolus Instant

This document outlines the necessary steps to successfully configure and integrate Document Insights - Ocrolus with Salesforce. This guide includes remote site settings, site creation, user permissions, and additional configurations required for proper system operation.

Introduction

Please ensure that you have the appropriate Salesforce administrative privileges before proceeding with the installation and configuration process.

Click here to Discover the full range of features offered by the Document Insights.


1. Intended Users

  • Salesforce Admins – Responsible for setup and configuration

  • End Users – Business users who use document insights for parsing and storing the data.

  • Developers – Those integrating with external systems.


2. Prerequisites

2.1 System Requirements

Salesforce Professional, Enterprise, Unlimited, or Developer Edition

Required Salesforce permissions (System Admin access)

2.2 User Roles & Permissions

Admin Access – Required for installation and configuration


3. Installation

3.1 Using Salesforce App Exchange
  1. Go to Salesforce AppExchange

  2. Search for Plaid Bank Connect - Authenticates Banks, ID & Income Verifications.

  3. Click "Get It Now" and select the Salesforce environment (Production or Sandbox)

  4. Follow the on-screen prompts to install the package

  5. Assign user permissions during the installation process

3.2 Using Direct Package Link
  1. Go to Salesforce AppExchange

  2. Follow the on-screen prompts to install the package

  3. Assign user permissions during the installation process


4. Post Installation Steps

Complete the post-installation steps to ensure seamless application functionality.

Step 1 - Remote Site Settings

Create the following remote site in the remote site settings and make it active:

  1. Go to Setup in Salesforce.

  2. In the Quick Find box, search for Remote Site Settings.

  3. Click on New Remote Site.

  4. Fill in the details as shown below.

  5. Make sure to check the Active checkbox.

  6. Click Save.

Remote Sites to Add :

Remote Site Name

Remote Site URL

Active Checkbox

Ocrolus API

https://api.ocrolus.com

Selected

Ocrolus Auth

https://auth.ocrolus.com

Selected


Step 2 - Feature Entitlements

  • Click on the gear icon and go to setup.

  • In the quick find box search for Custom Settings.

  • Go to “Feature Entitlements”.

  • Select the following items as per client’s configuration with Ocrolus:
    1. PDF Insights
    2. Ocrolus Fraud Detect
    3, Ocrolus Instant
    4. Ocrolus Transactions
    5. Ocrolus Cash Flow Features

  • Click on Save.

Screenshot 2025-07-15 at 4.28.14 PM.png

Step 3 - Plaid Common Settings

  • Click on the gear icon and go to setup.

  • In the quick find box search for Custom Settings.

  • Go to Plaid Common Settings.

  • Create the following entries:

Key

Value

1

createOCBookSummaryJSON

true


Step 4 - Sites

  • Click on the gear icon and go to setup.

  • In the quick find box search for sites.

Screenshot 2020-10-15 at 2.28.56 PM.png
  • Click New

Screenshot 2020-10-15 at 2.33.55 PM.png
  • Provide the required information(Label, Name, etc.)

  • In Active Site Home Page Lookup field Add VerifyBankConnect Visual force page.

Screenshot 2020-10-15 at 2.38.27 PM.png
  • Click Save.

 

Apex Class and Object Permission Assignment to Site Guest User.

  • In Global search, Search for Site Guest User.

  • Click on the site name which we have created just now.

Screenshot 2020-10-15 at 2.41.51 PM.png
  • Click on the profile.

  • In Profile Select-Object Settings.

Screenshot 2020-10-15 at 2.44.50 PM.png
  • Provide Access(Read, Create, and Edit) to the below Objects.

    • Bank Transactions

    • Historical Balances

    • Fraud Signals

    • Statement Summary

    • Document Insight Items

    • Income Insights

    • Income Insight Items

    • Identity Verifications

  • Now provide access to Apex classes

  • Go to Site Guest User profile again and click on Apex class Access.

Screenshot 2020-10-15 at 2.50.54 PM.png
  • Provide Access to below classes:

    bankconnect.Webhook_OCRInsights


Step 5 - Permission Sets

  • Click on the gear icon and go to setup.

  • In the quick find box search for Permission Sets.

image-20231226-123436.png
  • Go to Cloud Maven’s PDF Insight Permissions.

image-20231226-123537.png
  • Click on Manage Assignments. Select the Users who’ll be using the Document Insights Application.


Step 6 - Update Page Layout

Source Object -

  • Click on the gear icon and go to Edit Page.

  • Create a new Tab with Label as “Custom”.

  • Put the value “Document Insights” in the Custom Label, and click on Done.

image-20231226-124607.png
  • Click on the newly created tab.

  • From the list of components, Drag and Drop “viewPDFAnalytics” component in this tab.

  • Save the Page.

  • Click on the gear icon and go to Setup

  • Click on the Object Manager.

  • Select the Source Object, and Go to the Page Layouts.

image-20231226-125021.png
  • Open a page layout, and click on Related Lists.

image-20231226-125124.png
  • Drag and Drop Document Insights in the Related Lists Section.

image-20231226-125211.png
  • Click on Save.


Step 7 - Document Types

  • Click on the gear icon and go to setup.

  • In the quick find box search for Custom Metadata Types.

  • Go to Document Type Wrapper and Click on Manage Records.

image-20231226-142053.png

Activate only the following entries and put “Ocrolus” or “Ocrolus Instant” in the Source of those entries:

  • Bank Statements

  • Credit Card Statements

  • Plaid JSON

image-20231226-160124.png
Example Entry

For the following documents, please make the entries as follows:

  • Document Type -> Identity , Document Sub-Type → Driving License,Passport,Passport Card,SSN, Source → Ocrolus.

  • Document Type -> Income, Document Sub-Type → PayStubs,SSA-1099, Source → Ocrolus.

  • Document Type -> Tax Forms, Document Sub-Type → IRS Form 1040 (2022),IRS Form W-2, Source → Ocrolus.


Step 8 - Update Credentials

Follow this link to get information about updating credentials.


Step 9 - Webhook configuration

We’d need to reach out to Ocrolus to get a new Org created for the client.

Once the Org is created, please follow the following steps -

  1. Login to https://app.ocrolus.com/login using the client’s credentials.

  2. Click on the Person Icon on the top right corner after logging in.

image-20250716-134154.png
  1. Click on Webhooks.

image-20250716-134229.png
  1. Click on Add Webhook.

image-20250716-134357.png
  1. Fill in the Description and the Outbound URL. Your outbound URL should be in the format - {your salesforce site} + ‘/services/apexrest/bankconnect/getOCRInsights’.

//Example Outbound URL
https://lendingmanagerlos.my.salesforce-sites.com/landingPage/services/apexrest/bankconnect/getOCRInsights
  1. Select the two checkboxes from the Trigger Event - book.analytics_v2.generated, document.verification_succeeded and Click on Add Webhook button.

image-20250716-134705.png

If the above doesn’t work, alternatively you can try using the below steps.

  1. Go to Postman.

  2. Use the URL https://auth.ocrolus.com/oauth/token to get the access token. The Request type is POST. In the body of the request, set the following parameters in the x-www-form-urlencoded type

Key

Value

grant_type

client_credentials

audience

https://api.ocrolus.com/

client_id

client Id retrieved from Ocrolus dashboard

client_secret

client secret retrieved from Ocrolus dashboard

image-20231226-161238.png
  1. Click on Send. You’ll get a new access token in the response. Copy the access token.

image-20231226-161307.png
  1. To configure webhook, use https://api.ocrolus.com/v1/account/settings/update/webhook_endpoint?url in the Postman. The Request Type of the request is POST. In the Params, please use the following key-value pairs:

    1. webhook_endpoint ==== webhook

    2. event ==== DOC_VERIFIED,book.analytics_v2.generated

For the webhook, use the site created in Step - 4, and append /services/apexrest/bankconnect/getOCRInsights at last. For example, if the site created is https://sunlightfinancial--crt.sandbox.my.salesforce-sites.com/BankConnect/, the webhook will be https://sunlightfinancial--crt.sandbox.my.salesforce-sites.com/BankConnect/services/apexrest/bankconnect/getOCRInsights.

image-20231226-162205.png
  1. In the headers of the request, use the following key value pairs:

    1. accept ==== application/json

    2. authorization ==== Bearer {{token}}

Please use the actual access token copied from 3. in place of {{token}}.

image-20231226-162138.png
  1. Click on Send.



5. Support & Contact Information

Setup and Configuration

setup@cloudmaveninc.com

Production Issue or Report Bug

support@cloudmaveninc.com

Sales and Partnership

sales@cloudmaveninc.com


6. Conclusion

By following this post-installation guide, you have successfully configured the Document Insights in your Salesforce org. The integration enables manual & automated data parsing and improved data management. If any issues arise, consult the support team for further assistance.