The SafeBase Salesforce Managed App is an optional feature of our platform that allows for users to invite Contacts to SafeBase directly from Salesforce in the Contact and Account pages.
Note: We are planning to have the Managed App available on the Salesforce AppExchange in the near future. At the moment, installation requires using a direct link.
This installation process should take less than 20 minutes if all steps are followed correctly. If you run into issues, please use our Intercom help widget, or email us at support@safebase.io.
Prerequisites
This package can only be installed on Salesforce Enterprise plans.
Before installing the Managed App, you must have completed an OAuth connection in SafeBase as described here: https://help.safebase.io/en/articles/6116978-salesforce-integration
Package Installation
Use the appropriate link below to install the package based on the environment. The steps below are the same for both Production and Sandbox environments. Note that this should match the same environment that has been configured in the SafeBase app using the OAuth connection.
Production: login to your production environment. In the same browser profile, navigate to https://login.salesforce.com/packaging/installPackage.apexp?p0=04t4x000000ig71&isdtp=p1
Sandbox: login to your sandbox environment. In the same browser profile, navigate to https://test.salesforce.com/packaging/installPackage.apexp?p0=04t4x000000ig71&isdtp=p1.
Select Install For All Users then click Install.
A popup will appear. Ensure that Yes, grant access to third-party websites is checked, Click Continue.
Once the installation is complete, click Done. You will be redirected to the Installed Packages Page.
Verify that the package is listed in Installed Packages.
API Key Configuration
We are now going to configure the App with a SafeBase API Key.
In the top right corner, click the gear icon and enter Setup.
On the top left screen, find the QuickFind search box, type then click : Custom Metadata Types.
Find the line SafebaseHostToken, then click on Manage Records.
Click Edit, on the default record.
Insert your SafeBase API Key in the Token field. See step 6 for instructions on how to create one.
Go to your SafeBase Security Portal, under Settings, then API Keys, you can click the Add button to create a new one or click here to go to this section. You will need to be a SafeBase Admin to generate this key. If you are not a SafeBase Admin, ask one of your SafeBase Admins to generate this for you.
Note: API Keys can only be viewed when created, make sure you copy your API to a secure location such as a password manager.
In Salesforce, click Save.
Remote Site Configuration
Now that the API has been added, we are now going to verify that the App is configured to reach the SafeBase API properly.
On the top left screen, find the QuickFind search box type then click: Remote Site Settings.
Click Edit for the GetSafebaseAccount record.
Make sure the Active checkbox is checked.
Click Save.
Modifying Page Layouts and Adding Fields
We are now going to be modifying the Account Page Layout to add the appropriate custom fields that the App requires.
Account Page Layout
At the top of the page, click the tab Object Manager.
Find and click Account.
In the left side column, click Page Layouts.
Click your org’s default Account Layout, to open it in edit mode.
Note: If you have multiple layouts that your Sales team uses, you will have to repeat the following steps for each layout.
From the Fields box, click and drag a Section onto the page. Name the section SafeBase.
Click OK.
Note: This step is only required if you want to have a separate SafeBase section. You may optionally drag these fields to an existing section. We recommend putting these in a separate section to avoid clutter.
From the Fields box, drag and drop the following fields into the newly created SafeBase section:
Once the fields are added, hover over the field, select the wrench icon, and set the field to Read-Only. Do this for each field.
Click Mobile & Lightning Actions, use quick find to search for Add to SafeBase button.
Drag and drop the Add to SafeBase button into the section Salesforce Mobile and Lightning Experience Actions.
Click Save.
Contact Page Layout
The steps for this are quite similar to what we just did for the Account Page Layout.
At the top of the page, Click Object Manager, Contact, Page Layouts, then select your organization’s default Contact Layout.
In the Fields box, drag and drop the SafeBase: Invited into one of the existing sections, or create a new section for it.
Once the field is added, hover over the field, click the wrench icon, and set the field to Read-Only and click OK.
In the Mobile & Lightning Actions section, Drag the Add to SafeBase button to the Salesforce Mobile and Lightning Experience Actions section.
In the Mobile & Lightning Actions section, Drag the Resend SafeBase Invite Email button to the Salesforce Mobile and Lightning Experience Actions section.
Click Save.
Lightning Record Page Modification: Adding Buttons & Filters
Account Record Page
We are now going to modify the Account Record Page to make the Add to SafeBase button visible.
Return to the Salesforce default Sales page.
Open any Account, click the Gear icon, then Edit Page.
Click on the highlighted panel at the top where the buttons will live, and click Upgrade Now in Upgrade to Dynamic Actions on the right.
Note: Steps 3-6 may not be applicable if ‘Dynamic Actions’ have been previously enabled.
Click on Migrate and next.
Select the layout record page you want to migrate to Dynamic Actions and click Finish.
Click Add Action then find Add to SafeBase and click on it.
Click on Save then Activate in the pop-up. If you do not see a popup, click Activation….
Note: These steps are not necessary if the layout is already the default one.
When you activate the page, you can make the page layout with the SafeBase functionality the App default, or depending on the App, record type, and profile assignments.
Contact Record Page
These steps are similar to what we just did for Account Record Page, but we will also be adding filters to the 2 buttons.
Open any Contact, click the Setup icon and then click on Edit Page.
Click on the highlighted panel where the buttons will live, and find the Upgrade Now option in the Upgrade to Dynamic Actions box on the right.
Note: This may not be required if this was previously enabled.
Click on Migrate and click Next.
Select the layout record page you want to migrate to Dynamic Actions and click Finish.
Locate the top highlight panel and click on it.
Click Add Action, find the Add to SafeBase action and and click on it.
Now we are going to add 3 filters on this button so that it only appears as needed. Click Add Filter:
We are now going to add the second filter. Click Add Filter:
Now we are going to add the third and final filter for this button. Click Add Filter:
Select All filters are True radio button.
Click Done.
The steps for the next button are similar, but only one filter is needed. Click the Add Action, find the Resend SafeBase Invite Email and click on it.
Click Add Filter:
Click Done again to save the new action.
Click on Save on the top right corner and click Activate in the next popup, or click on Activation….
Note: These steps are not necessary if the layout is already the default one.
When you activate the page, you can make the page layout with the SafeBase functionality the App default, or depending on the App, record type, and profile assignments.
Note: If you previously installed our Managed App for versions < 1.15, please see this additional guide on extra steps needed after the upgrade: https://help.safebase.io/en/articles/6830877-upgrading-from-salesforce-managed-app-beta
This concludes the setup process for the SafeBase managed app. Users can view this article for instructions on how to use the buttons once this setup process has been completed: https://help.safebase.io/en/articles/6830743-salesforce-managed-app-usage-guide