This article offers a detailed walkthrough on how to install the Showell App in MS Dynamics. The process involves acquiring the DynamicsUri, installing Showell, setting up the Frame-Ancestor in Showell Admin, activating the Component Framework, customizing Showell Pages in the Sales Hub side menu, and establishing the connection for Showell Share Analytics in MS Dynamics.

After the installation is complete, users will have the ability to access and share content directly from Showell without having to leave the MS Dynamics environment.

1. Copy the 'Web Link'

This Web link/URL is used with the DynamicsUri and Frame-Ancestors fields. Please copy this link to your clipboard or a text file for later use.

A. Get the 'Web Link' using Power Apps

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, choose 'Apps'

3. Click 'Shared with me' and select 'Sales Hub'. Choose 'Details' from the top menu

4. Copy the first part (domain name) of the Web link to your clipboard or a text file.

For example: https://RANDOM.crm4.dynamics.com

B. Get the 'Web Link' from MS Dynamics - Sales Hub

1. Navigate to your MS Dynamics - Sales Hub

2. Copy the first part (domain name) of the URL in your Browser Address Bar Web, to your clipboard or a text file.

For example: https://RANDOM.crm4.dynamics.com

2. Install Showell to MS Dynamics

The Showell App is currently not yet available from the Microsoft AppSource. However, you are able to install it via Power Apps or the 'Classic' way.

A. Installation using Power Apps

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, choose 'Solutions', then click 'Import solutions' from the top menu

3. A menu will open, click 'Browse' and add the Showell.zip file that was provided to you by your Showell Customer Success Manager. If you have not received this file, please contact us.

4. Click 'Next' - The file will now be imported and processed. Once completed, make sure that under 'Advanced Settings', the 'Enable plugin step and flows included in the solution' is checked. Click 'Next' again.

5. You will now find 'Microsoft Dataverse Showell'. By default you should be automatically logged in to this, and a green checkmark will indicate so. If this is not the case click 'Sign In' and follow the login procedure > Once ready Click 'Next'

The Dataverse connection is a connection that allows users to do for example search, updates and other operations to the data

6. You now have to provide Environment Variables. (➡️ You are able to change these later.)

DynamicsUri: Paste the Web link you've copied in Point 1.
ShowellAppUrl: Type 'https://showellapp.com' OR, add your Custom Domain URL if activated for your Workspace.

7. Click 'Import' to complete the Showell installation

B. Installation using the 'Classic' way, starting from the Sales Hub

1. Navigate to your MS Dynamics - Sales Hub

2. Click the settings icon in the top right corner, and choose 'Advanced Settings'

3. From the top menu, choose Settings > Solutions. Choose 'Import'

4. Continue the installation steps from Point 2A, Step 3

3. Add the Frame-Ancestors to Showell Admin

Frame-Ancestors

1. Open Showell Admin

2. Click your name/company name in the top right corner > Workspace Settings

3. Scroll a bit down, and you'll see on the left side 'FRAME-ANCESTORS'. Click 'Configure frame-ancestors'

4. Paste the Web link you've copied in Point 1.

5. Click 'Save changes'

4. Enable Component Framework

Power Apps component framework

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. Click the settings icon in the top right corner, and choose 'Admin Center'

3. From the side menu, click Environments and then choose your Environment name

4. Click 'Settings' in the top, expand 'Product' and click 'Features'

5. On this page, you'll find many options. Toggle the 'Power Apps component framework for canvas apps' ON.

5A. Configure the Showell App: Add Showell Pages

This allows you to access Showell from the side menu in your Sales Hub.

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, click 'Apps' ( > 'Shared with me' or 'All'), select 'Sales Hub' and click the edit (pencil) icon.

3. You can now customize the Sales Hub side menu on the left side. This allows you to add Showell pages and arrange them freely within the menu for easy access and navigation.

Choose a preferred section (such as My Work, Sales or Collateral) and click on the '3 dots' next to the section's name. Then, select 'New page'

💡Once the new page is added, you can click its '3 dots' and choose to move it up or down in the list (see video at 00:28), and you can also edit its title from the menu on the right hand side (see video at 01:05)
While adding the pages, you might see a "This page needs to be published" error. This can be ignored.

3A: Add the 'Open Showell' Page

Choose 'Custom Page' and click 'Next'
Choose 'Use an existing custom page' > select 'open Showell' > Make sure 'Show in navigation' is enabled > click 'Add'.

3B: Add the 'Share Files from Showell' Page

Choose 'Custom Page' and click 'Next'
Choose 'Use an existing custom page' > select 'Share Files from Showell' > Make sure 'Show in navigation' is enabled > click 'Add'.

3C: Add the 'Showell Shares view' Page

Choose 'Dataverse table' and click 'Next'
Choose 'Select existing table' > Search for 'Showell Share' and select it > Make sure 'Show in navigation' is enabled > click 'Add'.
As a recommended next step, you can now also edit the 'Showell Shares view' columns

4. Click the 'Save' button in the top right corner.

5. Once saved, click the 'Publish' button next to it. The preview window will inform that the publishing is still ongoing and it will refresh the preview once this is done.

6. Once Published, Click the 'Play' button next to it.

This will now open your Sales Hub. In the top left, you'll be informed that a new version of the app is available and you'll have to refresh your browser tab to update it.

7. You will now find the Showell Pages from the left side menu

5B. Configure the Showell App: Edit 'Showell Shares view' Columns

This allows you to see analytics data for Shares creates in Dynamics in a glance.

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, click 'Apps' ( > 'Shared with me' or 'All'), select 'Sales Hub' and click the edit (pencil) icon

3. From the Sales Hub side menu on the left side, find 'Showell Shares View' (as configured in 5A) and click the edit (pencil) icon

4. From the left side (Table Columns) click 'Owner', 'Visitors', 'Visits', 'File Views' and 'Downloads'. This will add them as columns to the Showell Shares View

Additionally you can drag and drop the columns in your preferred order

5. Click 'Save and Publish'

5C. Configure the Showell App: Add Showell Shares tab to your contacts, leads and opportunities

This allows you to add a quick access Showell Shares tab to any contact, lead or opportunity.

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, click 'Apps' ( > 'Shared with me' or 'All'), select 'Sales Hub' and click the edit (pencil) icon

3. From the Sales Hub side menu on the left side, You can find and edit the following 3 pages:

Contacts view > Contacts form
Leads view > Leads form
Opportunities view > Opportunities form

4. Click the edit (pencil) icon for one of the above forms you'd like to adjust.

5. From the left hand side menu, choose 'Components'.

6. From the components menu, drag and drop the '1-column tab' to the desired location in Sales Hub (for example next to Summary or Details).

7. From the right hand side properties panel, change the label name to for example 'Showell Shares'

8. Open the 'Showell Shares' tab you just created

9. From the components menu, Click on 'Grid' > 'Subgrid'.

Checkmark 'Show related records'
Choose 'Showell Shares' from the table dropdown
Click Done

10. Select the Subgrid. From the right hand side properties panel, checkmark 'Hide label'

11. Select the 'new section'. From the right hand side properties panel, checkmark 'Hide label'

12. Open the 'Related'-tab and select 'Showell Shares'. From the right hand side properties panel, checkmark 'Hide'

13. Click 'Save and Publish'

6. Enable Showell share analytics in MS Dynamics

1. From Showell Admin: Click Admin (top menu) > MS Dynamics

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

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

4. The connection is now authorized between Showell and MS Dynamics

Optional: Update the DynamicsUrl or ShowellAppUrl

If you have an new DynamicsUrl, or your ShowellAppUrl has changed (for example by utilizing a new Custom Domain), you have to ability to change these.

You can obtain the new DynamicsUrl the same way as seen in Point 1
Updating the URLs will overwrite your previous input as seen in Point 2A, Step 6
Remember to also update your Frame-Ancestors in Showell Admin, as seen in Point 3

1. Navigate to MS Dynamics - Power Apps (make.powerapps.com)

2. From the side menu, choose 'Solutions', then click 'Default Solution'

3. From the left side section, search for, and open 'Environment variable Value' (under 'Tables')

4. Next to 'Environment Variable Value columns and data', click 'Edit'

5. Select the value you want to edit and choose 'Edit row using form' from the top menu.

6. Make your changes and click 'Save and Close' > 'Done'

💡 FAQ

How can I get the MS Dynamics integration?

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

Where can I find the "Showell for Microsoft Dynamics 365" Privacy Policy?

You can access the Privacy Policy on our Website.

🔔 Troubleshooting

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

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