Installing the Act-On package in Salesforce will allow your Salesforce Sales users to see the Act-On behavior history for Leads and Contacts, access the Act-On Hot Prospects dashboard, and send emails to Leads and Contacts with custom email templates and can use Act-On email tracking.
Features this package provides:
- Send Act-On Emails from Salesforce to Leads/Contacts, and to Reports
- View the Act-On Contact Report for a Lead/Contact
- View the Act-On Account Report for your Accounts
- View the Act-On Tab, a sales user portal that contains:
- Hot Prospects dashboard for Sales
- Website Prospector
- Sent Messages
- User profile settings such as signatures
- Import a Campaign List from Salesforce in one click
This guide provides instructions to install the package. Once the package is installed, the Act-On components must be enabled in Salesforce.
Prerequisites
- Act-On Marketing or Admin user credentials
- An active connection from Act-On to Salesforce
- Username, password, and security token for a Salesforce Administrator
- Pop-up blocker disabled
Important! If you have previously installed an Act-On package in your Salesforce account and need to upgrade, see How to Upgrade your Salesforce Package for further instructions.
Instructions
Install the Salesforce integration package in the following steps:
- Configure Remote Sites for Act-On
- Set up a Domain for your Salesforce account
- Install the package
- Enable Oauth for System Administrator and Act-On Users
Step 1: Remote Site Setup
Act-On's inline activity history view for the sales team requires you to authorize two Act-On URLs as remote sites in your Salesforce account.
- In Salesforce, navigate to Setup.
- In Quick Find in the left column, type “Remote Site” and click on Remote Site Settings.
- Click the button New Remote Site.
- Configure two new remote sites with the following settings:
- First site:
- Remote Site Name:
Act_On_Service
- Remote Site URL:
https://sf.actonsoftware.com
- Remote Site Name:
- Second site:
- Remote Site Name -
Act_On2
- Remote Site URL - This will match the URL of your Act-On account. Log in to Act-On and check the address bar in your web browser. Examples:
-
https://cid2.actonsoftware.com
https://ci300.actonsoftware.com
https://forpcid11.actonsoftware.com
https://acapcid1.actonsoftware.com
-
- Remote Site Name -
- Ensure that the Active checkbox is checked for both sites.
- Ensure these reflect secure URLs (https://) exactly as above.
- First site:
Step 2: Set up a Domain for Salesforce
Note: Some Salesforce accounts already have this configured.
This step sets up a custom subdomain for your Salesforce account, which is required to use the Act-On Lightning app.
- Log in to Salesforce as a System Administrator
- Go to Company Settings > My Domain
- Click Add a Domain
- Enter the domain name
- Click on Check Availability
- Register Domain (Note: this can take a few minutes)
- Click on Login
See Salesforce Help for more information on this setting and more advanced configuration options.
Step 3: Install the Act-On Package
Note: When installing the package, a custom field will be created labeled "AccountId18char". This is a field necessary for our Account Report feature.
- In Act-On, go to Settings > Connectors > CRM > Salesforce and click on the Install Package button.
- Click OK to acknowledge that you have set up your Remote Site Settings (above)
- Alternatively, Salesforce Administrators can Click Here to install ActOnInfo v 1.88
- A new window will pop up. Log in to Salesforce as a System Administrator
- Select Install for All Users
- Even though access will be granted to all Salesforce users, Act-On will not be accessible by any users until the features have been exposed via Salesforce layouts and the users have been registered in Act-On.
- Check the box to acknowledge this is a non-native Salesforce App and approve the installation.
- Click Install
Note: This may take a while. You will receive an email when the installation is complete.
Step 4: Pre-approve OAuth for System Administrator and Act-On Users
This allows users to access Lightning features.
- Go to Setup > Apps > App manager > Act-On Lightning Support > select Manage from drop-down
- Click Edit Policies
- Go to OAuth policies > Permitted Users > Admin approved users are pre-authorized > Save
- If you get a pop-up warning, click OK
- Scroll down and find the button "Manage Profiles"
- Check the box for System Administrator and any other Profiles for your Act-On Users (eg, Standard Platform User) click Save
See Salesforce Help for more information on this setting.
Step 5: Update Clickjack Protection settings
Clickjack Protection is not required to use Act-On, however, if your organization has chosen to use this security feature, it may block Act-On from loading on the page.
To display Act-On elements in your Salesforce account while still using Clickjack Protection, your Salesforce System Administrator may add the domain, *.force.com to your allowlist
- Go to Setup > Quick Find and type to find "Session Settings".
- Find Clickjack Protection
- Turn off/uncheck “Enable clickjack protection for custom Visualforce pages with headers disabled”
- Scroll to the bottom of the page and click Save.
Next Steps
Once the Salesforce package has been installed, your Salesforce Administrator can enable Act-On components in Salesforce so your users can access Act-On features directly in Salesforce.
FAQs & Troubleshooting
My Act-On host changed, do I need to change my Remote Site Settings?
Occasionally, the URI for your account host server may change. This is uncommon, but will happen in these scenarios:
- Your account has migrated to a new host for some reason (e.g. your account was upgraded to a dedicated server, or our Engineering department moved your account to a more performant host).
- Your account's host server has had a major change made by Act-On and the server name is now slightly different (e.g. you were hosted on
ci36.actonsoftware.com
, but now you are hosted onforpci36.actonsoftware.com
).
With Scenario 1, you will need to update your settings in Salesforce.
With Scenario 2, you will not need to change your Salesforce settings but you may wish to do so. Old URIs will always resolve to the newest URI for the same host. Any new configurations should always use the new/current hostname.
Remote Site Errors
If you continue to receive an error to add the Remote Sites list, have your Salesforce Administrator follow these steps to resolve the errors.
- Remote Site Settings error:
- Additional indication there are errors with remote site settings:
Solution: Review and Update Remote Site Settings
- Confirm in Salesforce that your Remote Site Settings for Act_On2 and Act_On_Service are:
- Active
- Reflect secure URLs (https)
- Act_On2 must match your account server URL
- This will match the URL of your Act-On account. Log in to Act-On and check the address bar in your web browser. Examples:
https://cid2.actonsoftware.com
https://ci300.actonsoftware.com
https://forpcid11.actonsoftware.com
https://acapcid1.actonsoftware.com
- You can obtain your account server URL by logging in to Act-On and reviewing the address bar of your web browser.
Note: if you originally were hosted on a server starting withci*.actonsoftware.com
, and are now hosted onforpci*.actonsoftware.com
, you do not need to change this setting, as the original hostname will still resolve to the correct location. See our FAQ above for more information. - This will match the URL of your Act-On account. Log in to Act-On and check the address bar in your web browser. Examples:
- Have no other syntax errors
- If you made changes here, visit the Act-On tab to test the integration.
In this example, the account is hosted on https://ci36.actonsoftware.com:

For this account, these are the correct Remote Site Settings in Salesforce:

Contact Support for Remote Sites Warning
If you are still receiving errors after you have confirmed the Remote Site Settings, something else could be wrong. Please contact our support team for further assistance.