Salesforce integration: Installation Guide

Effortlessly integrate Showell into Salesforce: Streamline your content management and Sharing process

1. Install/Update Showell to Salesforce

SalesForce Appexchange

Before you start installing, make sure 'Enhanced Email' is enabled:

  • From the Salesforce Setup page: type 'Enhanced Email' in the side menu 'Quick find'. Open the page and click 'Enable'
  • For more information: Set Up Enhanced Email

1. Open Showell in the Salesforce AppExchange and click 'Get It Now'.

2. If you are not signed in yet, you will be prompted to sign in to Salesforce.

3. Proceed to install Showell to Salesforce using the installation wizard. During this, you will have to add the installation key. This key is provided by your Showell CS Manager or you can request one by contacting Showell Support

4. After the installation is complete, you can start configuring the components.

➡️ The above steps are to be followed with updating Showell in Salesforce as well

 



2. Add share-component to the record pages

You are able to add the share-component to the Contact, Opportunity and/or Lead record pages


The following step-by-step instructions adds the share-component to the Contact record page.

1. From the Salesforce Setup page: Click Object Manager > Search (Quick Find) and then open 'Contact'

2. Choose Page Layout > Contact Layout > Mobile & Lightning Actions

3. Drag the 'Share files from Showell' to the desired place in the Salesforce Mobile and Lightning Experience Actions

  • You might encounter the following message:"Actions in this section are predefined by Salesforce. You can override the predefined actions to set a customized list of actions on Lightning Experience and mobile app pages that use this layout. If you customize the actions in the Quick Actions in the Salesforce Classic Publisher section, and have saved the layout, then this section inherits that set of actions by default when you click to override." Simply click 'Override the predefined actions' to enable editing.

4. Select Related Lists. Drag 'Showell shares' to the desired place on the layout > Modify 'Showell shares' by clicking the wrench icon:

  • In the Columns section:
    • Remove all items from the Selected Fields-column
    • Add 'Showell Share' and 'Last Modified Date' to the Selected Fields-column
    • Sort by 'Last Modified Date' in Descending order
  • In the Buttons section: ( ⚠️ Above video does not show this action)
    • Deselect 'New'
    • Optional: Deselect 'Change Owner'
  • Click 'OK' when done

5. Choose Save > Yes

6. Repeat steps 1 to 5, for 'Lead' and 'Opportunity'

 



3. Add 'Open Showell'-component to the Account record page


1. From the Salesforce Setup page: Click Object Manager > Search (Quick Find) and then open 'Account'

2. Choose Page Layout > Account Layout > Mobile & Lightning Actions

3. Drag the 'Open Showell' to the desired place in the Salesforce Mobile and Lightning Experience Actions

4. Choose Save > Yes

 



4. Activate lightning page


1. From the Salesforce Setup page: search (Quick Find) and open 'Lightning App Builder' from the side menu

2. click 'View', under actions, for the Showell lightning page

3. In the top right, click Activation > Lightning Experience > Sales > Add Page to App > Drag 'Showell' to the desired position > Save

4. Navigate back to the Salesforce Setup page

 



5. Add Frame Ancestor to Showell

To utilize the 'Showell' component within Salesforce, you must configure its URL in Showell Admin.

Salesforce frame-ancestor


1. Log in to Showell Admin > select Account settings from the top right menu

2. Scroll down to the Frame-Ancestors section.

3. Add your Salesforce Sales URL

  • Copy the first part (domain name) of the Salesforce URL from your Browser Address Bar. You can find this by simply opening your Salesforce sales page.
  • For example: https://RANDOM.lightning.force.com

4. Click Save changes




6. Enable Showell share analytics in Salesforce

 

1. From Showell Admin: Click Admin (top menu) > Salesforce Connected App

2. Begin authorization by selecting “Authorize by signing in to Salesforce”

3. Login with your Salesforce user’s credentials > Click "Allow"

4. The connection is now authorized between Showell And Salesforce

 



7. Configure permissions for users

To enable users to use custom objects provided by Showell for the Salesforce app, their permissions need to be updated.

Showell offers a 'Showell Custom Objects' Permission set specifically designed for this. You can either use this permission set as it is or review its required permissions and assign those permissions to existing permission sets. This will allow all users to fully utilize the Showell app within Salesforce.

 

 


1. From the Salesforce Setup page: search (Quick Find) and open 'Permission Sets' from the side menu

2. Open ‘Showell Custom Objects’ from the list and Choose Manage Assignments

3. Select ‘Add assignment’ from the top right

4. Select the right users by ticking their checkbox and continue by clicking next

5. If necessary, set an expiration date

6. Confirm the assignment by clicking Assign

 



8. Assign Licenses

Once the setup of Showell and its components is complete in Salesforce, you can allocate licenses to users who require access to these features.

1. From the Salesforce Setup page: search (Quick Find) and open 'Installed Packages' from the side menu

2. Click 'Manage Licenses' next to the Showellapp Package

3. You've now opened the Showellapp Package Manager. From here, you can see the amount of licenses you are able to allocate to users; 'Allowed Licenses'. Please contact your Showell Contact person or Showell Support if you'd like to upgrade this.

4. In the 'Licensed Users' section, click 'Add Users'

5. Select all the Users that need access to the Showell components > 'Add'. Keep in mind that you cannot exceed the amount of allowed licenses

 


9. Additional Options:


9A. Add Custom tabs for 'Showell Shares' and/or 'Showell App'

This is an additional option where you can add custom Showell tabs


1. From the Salesforce Setup page: Open the App launcher (top left) > open 'Sales'

2. Click the pencil icon on the right side of the navigation/tab bar

3. Choose: Add more Items > All > Search and select 'Showell Shares' and/or 'Showell' > Add Nav Items > Drag and Drop the tabs to the desired location > Save

 



9B. Embed Showell in your Home page, App page, and/or Record page

This is an additional option where you can embed Showell in a page of choice


1. From the Salesforce Sales App: open from the top right, the setup menu (cogwheel) > Edit Page

2. Find the 'Showell'-Component in the left-side menu under 'Custom - Managed'

3. Drag and drop the 'Showell'-Component to the desired place on your page

4. In the top right: Click Save > Activate > Assign as 'Org default', 'App default' or 'any app and profile' > Save

 



9C. Configure your Custom Domain in Salesforce

If you have a Showell Custom Domain, such as 'subdomain.companyname.com', you will need to configure this within Salesforce.


1. From the Salesforce Setup page: search (Quick Find) and open 'Custom Metadata Types' from the side menu

2. Click 'Manage Records', under actions, for the Showellapp settings

3. Click 'Edit', under actions, for the App hostname

4. Type your Custom Domain in the 'App Hostname'-field > Save

 



9D. Use Showell inside your Experience Cloud Site

You have the option to utilize Showell within your Experience Cloud Site if your users have a Salesforce or Partner Community License.

To use Showell custom objects and fields, users must have the necessary permissions. You can assign the "Showell, Partner" Permission Set from the Showell installation package to grant these permissions. Alternatively, you can review the required permissions and assign them to your existing permission sets.

Embed the 'Showell'-component within your Experience Cloud site:

1. Navigate to the Experience Builder

2. Find the 'Showell'-component under Components > Custom Components

3. Drag and drop the 'Showell'-Component to any desired location on your page

CSP-violation error:

If you embed the 'Showell'-component for the first time, you may encounter a CSP-violation error indicating that you cannot access the external host. The following instructions will guide you how to fix this:

CSP Errors


1. Go to Experience Builder Settings and select Security & Privacy

2. Under Content Security Policy (CSP), you'll find the CSP Errors - Blocked Resource list

3. Click Allow URL for https://showellapp.com

  • Please note that if you have set up a Custom Domain, the URL domain should match it

4. When asked for confirmation, click 'Allow'

Configure the Experience Cloud site (URL) in Showell Admin:

To utilize the 'Showell' component within your Experience Cloud site, you must configure the URL of the Experience Cloud site in the Showell Admin.

Salesforce additional frame ancestor


1. Log in to Showell Admin > select Account settings from the top right menu

2. Scroll down to the Frame-Ancestors section.

3. Add the Experience Cloud site URL, alongside the main Frame-Ancestor as seen in Point 5

  • You have the option to add multiple URLs by separating them with a space

4. Click Save changes

 



9E. Rename the Showell buttons in Salesforce

You have the ability to rename the Showell buttons in Salesforce

1. From the Salesforce Setup page: Click Object Manager > Utilize Search (Quick Find) to find the location where the button, you'd like to rename, is used. For example: Opportunities, Leads or Contact

2. Choose 'Buttons, Links, and Actions' and choose to Create a new Action

  • Action Type: Lightning Web Component
  • Lightning Web Component: Shw:showellShare
  • Label: Choose your desired button Label
  • Name: Choose your desired button Name

3. Click 'Save'

4. Follow the instructions as shown in Point 2 to move the new button into place. Remember to also remove the old button from its location.

 



9F. Add Showell Shares to a Salesforce Event/Meeting

This feature allows you to include Showell Shares with the Event object. For instance, you can add Showell Shares to specific calendar meetings or events.

1. From the Salesforce Setup page: Click Object Manager > Search (Quick Find) and then open 'Event'

2. Choose Lightning Record Pages

➡️ If you have previously set up a Lightning page for events, you can proceed to step 5.

3. Click New > Record Page > Next

  • Label: Choose a label of choice - For example: 'Events'
  • Object: Event

4. Click Next > Clone Salesforce default page > Select 'Event Page Default' > Done

5. Open the 'Events' lightning Record page (this will automatically open if you just created it) and Choose 'Related'

6. In the left side menu, scroll down till you find 'Associated Showell Shares', and drag it into the 'Related' section > Click 'Save'

7. You will now have to activate this page for your users: Click 'Activate' > Assign as Org Default > Desktop > Save

8. Click 'Save' once more

 

💡 FAQ

 
How can I get the Salesforce integration?

Salesforce is a premium Showell integration. If you'd like to know more:

On what Salesforce framework can I install Showell?

Showell works with Salesforce Lightning: Providing a more user friendly environment and modern user interface.

Can Showell and its components be installed in a Salesforce Lightning app of choice?

Yes, but we do recommend to install Showell as shown in this installation guide.

Are Showell usage analytics still available when Showell is used within Salesforce?

Yes, the analytics are collected normally, as the embedded Showell App equals the Showell App for Web.

🔔 Troubleshooting

 

Why am I unable to see Showell's share analytics and tracking data in Salesforce?

It takes about 1 hour for the Analytics to be available within Salesforce.

Showell