> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pipelaunch.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# FillDesk Salesforce Installation and Setup Guide

### Package Installation

Install the "FillDesk" managed package from the package installation link or from the Salesforce AppExchange listing. Select  **Install for Admins Only**

| Direct installation link:  https://login.salesforce.com/packaging/installPackage.apexp?p0=04tTr000000pnrVIAQ

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_1lzrcvt.png)

| "Install for All Users" makes the package available organization-wide, ideal for site licenses. It appears in the App Launcher for all users, subject to their permissions. This option is typically preferred for immediate deployment and when the package functionality is intended for the entire organization.

|| You need Permissions to Download AppExchange Packages. If you receive an error saying "This Package can't be installed. The requested package doesn't exist yet or has been deleted..." please follow this [guide](/en/article/error-this-package-cant-be-installed-the-requested-package-doesnt-yet-exist-or-has-been-deleted-15yjqok/) or check your permissions in this guide: [How to Verify if a User Has Permission to Install Packages in Salesforce](/en/article/how-to-verify-if-a-user-has-permission-to-install-packages-in-salesforce-xjwxzw/)
  
* Accept the remote site permissions and follow the standard Salesforce package installation prompts.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_erxnch.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_2pwlf1.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_11i8jj6.png)

### Named Credentials Setup

* In Salesforce Setup, navigate to Security > **Named Credentials**. Select the legacy named credential from the list and click **Edit**

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_c1g888.png)

 ![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_7y0bh0.png)
* Enter the following details and click **Save**:
Username: *any*
Password: *security token provided by the PipeLaunch team*
Callout Options > Allow Merge Fields in HTTP Header: ✅

||| Make sure to leave the checkbox Allow Merge Fields in HTTP Header. Any misconfiguration will result in failed API calls and prevent the application from functioning.


### Trust your Lightning domain for inline preview
######  
FillDesk renders documents inside a Visualforce page that the Lightning component loads in an `<iframe>`. By default, Salesforce's protection blocks this cross-origin framing, so you need to add your Lightning domain to the **Trusted Domains for Inline Frames** allowlist. Without this step, users will see an error similar to `<host>--filldesk.vf.force.com refused to connect` and the preview will not render. 
In Salesforce Setup, type **Session Settings** into the Quick Find box, then open **Security > Session Settings**. Scroll down to the **Trusted Domains for Inline Frames** section and click **Add Domain**. Enter your org's Lightning domain as a full HTTPS origin (scheme and host only, no path, no trailing slash).  

*Examples:* 
Production: https://acme.lightning.force.com 
Sandbox: https://acme--partial.sandbox.lightning.force.com

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_bcfl4i.png)



### Assign Permission Sets
In Salesforce Setup, navigate to Users > Permission Sets.


![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_jhl8yy.png)
* Find and select the FillDesk Permission Set. Click to open it.
* Click on the **Manage Assignments** button

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_kuxch3.png)
* Select all users or profiles that require access to the FillDesk functionality and click Next and then Assign to confirm the operation.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_pgotx1.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_qorgym.png)

### Add components to the page layout

* Navigate to an example Account (if you are using Person Accounts), Lead, or Contact record. Click the Setup gear icon and select Edit Page to open the Lightning App Builder.



![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_1nna418.png)

10. In the list of Lightning Components on the left, find the FillDesk components. Drag the components onto the desired location on the page layout.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_19ldl3o.png)If prompted, Activate the page for the desired org, app, and profile combinations.
Repeat for other FillDesk components as needed.


### Setup Lightning Web Security (LWS) 

Ensure the following is configured in your Salesforce org:

Lightning Web Security (LWS) must be enabled. FillDesk components rely on LWS and will not function correctly without it.

To enable LWS, go to Salesforce Setup and search for **Session Settings** > **Lightning Web Security**. Toggle the setting on and save.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_9f3jfa.png)


||| Disabling LWS after installation will cause FillDesk components to stop working. Do not disable this setting in production orgs where FillDesk is active.


### Security & Network Prerequisites for Agent Search

|| This only applies to Agent Search clients with the ECA

To prevent security warnings within Salesforce and ensure the FillDesk external client application functions correctly, your network or Salesforce security settings must permit traffic from our backend infrastructure.

Please ensure your Salesforce security policies allow OAuth server logins and API traffic originating from the following FillDesk static egress addresses:

* **Primary Egress IP:** `52.209.235.82`
* **Secondary Egress IP:** `54.72.142.94`

Adding these IPs resolves standard Salesforce security compliance blocks and guarantees that automated features and embedding searches function seamlessly.