Install Agent Embedded in Salesforce

This is the first step of setting up Agent Embedded in Salesforce.

This page explains how to install CXone Mpower Agent Embedded in Salesforce. Once it's installed, agents can use it to handle interactions directly inside Salesforce. When it's installed in Salesforce, Agent Embedded is called Agent for Salesforce.

Agent for Salesforce is only available in Salesforce Lightning. It is compatible with the following Salesforce solutions:

  • Salesforce Sales Cloud

  • Salesforce Service Cloud

  • Salesforce Marketing Cloud

Complete each of these tasks in the order given.

Before You Begin

  • Confirm that you do not have a namespace defined in your Salesforce org. You typically define a namespace when you use a developer org to create a managed package for distribution. Agent for Salesforce has its own namespace and will not run in an org that has one already defined. If you have one already defined, refer to the Salesforce help.
  • Ensure you are installing and using Agent for Salesforce on a supported platform and in a supported browser.
  • If you already have a contact center definition named CXone Mpower Contact Center, rename it before you install the application, because the installation will fail as it tries to create a new contact center definition.

Download Agent for Salesforce from the Salesforce AppExchange

When you download Agent for Salesforce from the Salesforce AppExchange for the first time, 25 trial licenses are installed for 30 days. Work with your Account Representative to adjust the number of licenses and update them to active licenses.

Agent for Salesforce is supported by the following Salesforce editions:

  • Professional
  • Enterprise
  • Unlimited
  • Developer
  • Performance
  • Hyperforce
  1. Log in to the Salesforce org where you want to install Agent for Salesforce.

  2. Navigate to CXone Mpower Agent for Salesforce with Digital Integrations in the Salesforce AppExchange.

  3. Click Get It Now.

  4. Click Install in Production. If prompted, log in first by clicking Log in to the AppExchange.

  5. Agree to the terms and conditions, and then click Confirm and Install.
  6. If prompted, enter your Username and Password and log in.
  7. Choose whether to Install for Admins Only, Install for All Users, or Install for Specific Profiles..., then click Install.

    If you choose Install for Specific Profiles..., you have the option to choose which profiles have access to the package. You can set a global policy by using the Set access level for all profiles to setting, and then modify profiles from there.

  8. Grant access to api.incontact.com and click Continue.

  9. When the installation has completed, click Done.

Assign Users to Your License

Agent for Salesforce is a license-managed application. When you install a trial of the application, you have 25 licenses that expire after 30 days. You must talk to your Account Representative to create a work order to update to an active license with your desired number of seats based on your contract. If you are installing Agent for Salesforce into a sandboxClosed A copy of a production environment used for testing agent applications, no licenses are needed.

Once you install the application, you must assign users to a license or the application will not load when your users log in to Salesforce.

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for Installed Packages, and then click Installed Packages.

  3. Find the NICE Agent for Salesforce package with the publisher CXAE_Salesforce. Click Manage Licenses. If you are assigning users in the Salesforce sandbox, Manage Licenses will not exist and you can skip this step.

  4. Click Add Users.

  5. Search for and add users to your license.

Enable Agent for Salesforce in Lightning Experience

You must add Agent for Salesforce to the utility bar for each Lightning Experience app you want your agents to be able to view Agent for Salesforce in.

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for App Manager. Click App Manager in the results.

  3. Find the app in which you want to enable Agent for Salesforce. In the App Type column, verify that the app uses the Lightning Experience.

  4. Click the drop-down arrow Image of downward facing arrow. on the right for that app. Click Edit.
  5. In the App Settings menu on the left, click Utility Items (Desktop Only).
  6. Click Add Utility Item.
  7. Search for Open CTI Softphone, then click Open CTI Softphone.
  8. Click Save at the bottom.

Configure the Call Center

When you install Agent for Salesforce to your Salesforce instance, two call centers will be installed:

  • Agent for Salesforce
  • Agent for Salesforce FedRamp

All Agent for Salesforce users should be assigned to one of those call centers. All the other, older call centers should not be used and can be deleted.

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for Call Centers, then click Call Centers in the results.

  3. Review the information and click Continue.

  4. Click Edit next to the Agent for Salesforce call center or the Agent for Salesforce FedRamp call center.

  5. Make sure the CTI Adapter URL field has the appropriate value for your organization:

    • Non-FedRamp customers: https://cxagent.nicecxone.com/login?base=https://login.salesforce.com/&app=cxa_sfdc

    • CXone Mpower FedRamp Moderate customers: https://cxagent.nicecxone-gov.com/login?base=https://login.salesforce.com/&app=cxa_sfdc
  6. The recommended Softphone Height is 700 pixels and the recommended Softphone Width is 420 pixels, but you can adjust this to better fit the computer resolution. Anything less than 365 pixels is not supported.

  7. Make sure the URL you entered for CXone Mpower System Issuer in step 5 is configured in Remote Site Settings.

    1. Use the Quick Find box to search for Remote Site Settings, then click Remote Site Settings.

    2. Select NICEinContact.

    3. Click Edit.

    4. In the Remote Site URL field, enter your CXone Mpower System Issuer URL.

    5. Click Save.

Assign Users to the Agent for Salesforce Call Center

After modifying the call center definition, you must assign users to the Agent for Salesforce call center. You can do this by modifying the call center or modifying individual users.

Modify the Call Center

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for Call Centers, then click Call Centers.

  3. If the Say Hello to Salesforce Call Center screen appears, click Continue.

  4. Select the appropriate call center:

    • Agent for Salesforce

    • Agent for Salesforce FedRamp

    Do not click Edit next to the call center name.

  5. In the Call Center Users section, click Manage Call Center Users.

  6. Click Add More Users. Search for users by configuring the filter fields and clicking Find.

  7. When the search results appear, check the box next to the users you want to add, then click Add to Call Center.

Modify Individual Users

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for Users, and then click Users.

  3. Click Edit next to the user you want to add to the call center.

  4. Scroll down to the bottom right part of the General Information section. Enter Agent for Salesforce or Agent for Salesforce FedRamp in the Call Center field, or use the search button to search for configured call centers.

  5. Click Save.

Allow URLs

You need to add cxagent.nicecxone.com and api.incontact.com as trusted URLs in Salesforce.

  1. In Salesforce, click Setup Image of gear icon with lightning bolt inside. in the top right.

  2. Use the Quick Find box to search for Trusted URLs, then click Trusted URLs.

  3. Click New Trusted URL.

  4. Enter an API Name for the trusted URL. For example, NICECXone.

  5. In the URL field, enter cxagent.nicecxone.com.

  6. Select all the checkboxes in the CSP Directives section.

  7. Click Save & New.

  8. Enter an API Name for the trusted URL. For example, NICECXone MpowerAPI.

  9. In the URL field, enter api.incontact.com.

  10. Select all the checkboxes in the CSP Directives section.

  11. Click Save.

Enable Click2Jack

You can set up clickjack protection with Click2Jack. Clickjacking occurs when an attacker adds an element, like a button, to your site to get users to click on it. Once the user has clicked on the malicious button, they are routed to the attacker's site. Enabling Click2Jack helps protect you from clickjack attacks. It also prevents issues from Google's third-party cookie deprecation. For more details about Google's cookie deprecation see the previous note.

To set up these protections and prevent further issues, you need to enable Click2Jack in your Salesforce application . You also need to add the following URLs as trusted domains:

  • https://mydomain.lightning.force.com

  • https://mydomain.my.salesforce.com

The next step of setting up Agent Embedded in Salesforce is to set up a CRM configuration.