Access Your Act-On Data in SugarCRM

  • Updated

Install the Act-On package for SugarCRM to let Sales users view Act-On activity history on records in SugarCRM and use Act-On dashlets (such as Hot Prospects). This article covers installing the SugarCRM package, configuring the connector, enabling the connector modules, and adding dashlets.

Quick Reference (Advanced Users) - Click to Expand
  1. Download the Act-On SugarCRM package ZIP.
  2. Generate an Act-On API key (Settings > Apps > API Access).
  3. In SugarCRM: Admin > Developer Tools > Module Loader (upload, install, commit).
  4. In SugarCRM: Admin > System > Repair (Quick Repair and Rebuild).
  5. In SugarCRM: Admin > System > Connectors (Set Connector Properties > Act-On Integrator).
  6. Set Act-On URL + API Key, then Test Connector.
  7. If needed: authorize IP in Act-On (Settings > Apps > API Access > Authorize IP).
  8. In SugarCRM: Admin > System > Connectors (Enable Connectors > Act-On Integrator).
  9. Enable Contacts, Leads, Targets, then add dashlets to dashboards.

Install the Act-On Package for SugarCRM

If you already have the package but need to upgrade versions, uninstall it before proceeding.

  1. In SugarCRM, go to Admin > Developer Tools > Module Loader.
  2. Find the existing Act-On package and click Uninstall > Commit.

To install the package:

  1. Download the Act-On Sugar package ZIP file. If macOS automatically unzips the file, re-compress it before uploading.

    This file only works with SugarCRM v7.10 or later. If you need help confirming your SugarCRM version, see: this SugarCRM support page.

  2. In Act-On, go to Settings > Apps > API Access, then click Generate Key.

    If you do not see the Apps option, contact Support to have the OAuth feature enabled.

generate_key.PNG

  1. Copy the generated API key into a Word or Google document for safe keeping.
  2. Using your administrator account, sign in to SugarCRM.
  3. Go to Admin > Developer Tools > Module Loader.
  4. In Module Loader, click Choose File.
  5. Select the ZIP file you downloaded in step 1 (for example, ...ActOnPackage-4.3.1.zip), then click Upload.
  6. Locate the Act-On package under the Module Loader upload area and select Install > Commit.

install_commit.PNG

  1. Go to Admin > System > Repair.

system_repair.PNG

  1. Click Quick Repair and Rebuild. A “done” message appears once completed.

repair_rebuild.PNG

  1. Go to Admin > System > Connectors.

system_connectors.PNG

  1. Click Set Connector Properties.

set_connector_properties.PNG

  1. Click the Act-On Integrator tab.

act_on_integrator.PNG

  1. In the first box, enter the (Global) Act-On URL for your account.
    • The format is https://ciXX.actonsoftware.com.
    • Replace ciXX with the “ci” instance code shown in your browser address bar when you are logged into Act-On.

ci_instance.PNG

  1. Paste the API key you generated in Act-On into the second box labeled API Key (Global).

    If you intend to link multiple Act-On accounts to one SugarCRM instance, see: Connecting a Single SugarCRM Account with Multiple Act-On Accounts.
  2. Click Test Connector.

test_connector.PNG

Testing the Connector

You may have to click Test Connector twice.

If testing fails with Illegal Remote Endpoint followed by an IP address, authorize that IP in Act-On.

illegal_remote_point.PNG

To resolve this:

  1. Copy the IP address shown in the error.
  2. In Act-On, go to Settings > Apps > API Access > Authorize IP.

aythorize_ip.PNG

  1. Paste the IP address (no extra spaces) and click Submit.

Ip_address_2.PNG

  1. Return to SugarCRM and click Test Connector again. If testing still fails, confirm the URL and API key values are correct, then test again. Click Save.

Enable Your Act-On Connectors

  1. Using your administrator account in SugarCRM, go to Admin > System > Connectors.

system_connectors.PNG

  1. Click Enable Connectors.

enable_connectors.PNG

  1. Click the Act-On Integrator tab.

act_on_integrator.PNG

  1. Ensure that Contacts, Leads, and Targets are under Enabled. If they are not enabled, move them to Enabled.
  2. Click Save.

Contacts_Leads_and_Targets_enabled.PNG

Enable Act-On Dashlets

After the connector modules are enabled, add Act-On dashlets to a SugarCRM dashboard.

To enable the dashlets in SugarCRM:

  1. Sign out of SugarCRM and close all browser sessions completely.
  2. Sign back in to SugarCRM.
  3. Open a dashboard where you want to add Act-On dashlets.
  4. Click the menu icon in the bottom-right corner.

burger_menu.PNG

  1. Click Add Dashlet.
  2. Select the Act-On Activity History dashlet for Leads and Contacts. Customize the options to select which marketing behaviors you want displayed, then click Save.

activity_history2.PNG

  1. Repeat the steps above to add the Marketing Timeline dashlet. Give it a name, choose the record type from the available list, and customize the options as needed.
  2. Add the Hot Prospects dashlet and customize the options:
    • Max Records: Number of records displayed in the Hot Prospects dashlet.
    • Days of History: Number of days of Act-On activity history to consider.
    • Minimum Score: Minimum lead score value required for a record to appear.

hot_prospects.PNG

For additional configuration options and troubleshooting, see Post SugarCRM Integration Options & Troubleshooting.

Was this article helpful?

Have more questions? Submit a request