Install Agent for Salesforce

Agent for Salesforce supports the current version and the two previous versions of the agent.

Installing Agent for Salesforce requires several steps. After you complete the required steps, many optional configuration tasks are available. When you configure Agent for Salesforce, do not change the call center profile unless you have NICE WFO enabled.

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. The Agent for Salesforce has its own namespace and will not run in an org that has already defined one. If you have one already defined, refer to 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 NICE CXone Contact Center, rename it before you install the application, because the installation will fail as it tries to create a new contact center definition.

Install the Agent for Salesforce Package

Before you begin, Agent for Salesforce is supported by the following Salesforce editions:

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

  2. Navigate to http://appexchange.salesforce.com and search for NICE CXone.

  3. Hover over Best-in-Class Omni Channel CTI / IVR / ACD / Dialer / Contact Center and click More.

  4. Click Get It Now.

  5. Click Install in production. If prompted, log in first by clicking Log in to the AppExchange.

  6. Agree to the terms and conditions, and then click Confirm and Install.
  7. If prompted, select a user name and log in.
  8. Choose whether to install for Admins Only, All Users, or Specific Profiles and 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.

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

  10. When the installation has completed, click Done.

Following this installation process installs the Agent for Salesforce Lightning.

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 will need to talk to your NICE CXone account manager 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. Click Setup in the upper right corner.

  2. Use the Search box to search for Installed Packages, and then click the Installed Packages link.

  3. Find the NICE inContact CXone Agent for Salesforce package and 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 the Salesforce Agent in.

  1. Click the gear icon in the top right. Click Setup.

  2. In the left menu, click Apps > App Manager.

  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 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.

Set Permissions for Your Users

Configure Permission Sets For a Single User

  1. Click Setup in your account menu located in the top right corner.

  2. Use the Search box to search for Users, then click the Users link.

  3. Find and click the non-administrator user you want to modify.

  4. In the Permission Set Assignments section, click Edit Assignments.

  5. Select inContact Agent Permissions from the list of Available Permission Sets.
  6. Click Add.
  7. Click Save. The inContact Agent Permissions set will appear under the Permission Set Assignments section of the User Details page.

Configure Permission Sets For Multiple Users

  1. Click Setup in your account menu located in the top right corner.

  2. Use the Search box to search for Permission Sets, then click the Permission Sets link.

  3. Find and click on the inContact Agent Permission you want to modify.

  4. Click Manage Assignments and select the users you want assigned to the permission.

  5. Click Save. The inContact Agent Permissions set will appear under the Permission Set Assignments section of each agent's User Details page.

Configure the NICE CXone Call Center

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

  1. Click Setup in your account menu located in the top right corner.

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

  3. Review the information and click Continue.

  4. Click Edit next to the NICE CXone call center.

  5. In the NICE CXone Settings section, make sure the CXone System Issuer field has the appropriate value for your organization:

    • Non-FedRamp customers: https://cxone.niceincontact.com

    • CXone FedRamp Moderate customers: https://cxone-gov.niceincontact.com
  6. Optional: Enter the Tenant ID of your CXone account in the CXone Tenant Id field. This will:

    • Hide the Use Company Domain option from agents when they're logging in.

    • Display the external login authenticator configured for your tenant.

    You can ask your CXone Account Representative for the CXone Tenant ID.

  7. Make sure the URL you entered for CXone 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 System Issuer URL.

    5. Click Save.

Assign Users to the NICE CXone Call Center

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

Modify the Call Center

  1. Click Setup in the upper right corner.

  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 NICE CXone call center. 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. Click Setup in the upper right corner.

  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 NICE CXone in the Call Center field, or use the search button to search for configured call centers.

  5. Click Save.

Configure Softphone Layout

The softphoneClosed A software program for making telephone calls over the Internet using a computer instead of a telephone. layout controls which action Agent for Salesforce takes when the console performs a query. You can perform default and custom queries. You can find more information about both types of queries in the Salesforce integration guides located in the Salesforce help site. When you perform a default query, Salesforce searches the phone fields of selected object types for the caller's ANIClosed Also known as caller ID. Listed phone number of an incoming voice call.. When you perform a default query, Salesforce searches the Phone fields of selected object types for the caller's ANI. After, it opens the object with matching numbers.

  1. Click Setup in the upper right corner.

  2. Use the Search box to search for Softphone Layouts, and then click Softphone Layouts.

  3. If the Introducing Salesforce CRM Contact Center screen appears, click Continue.

  4. Click Edit next to an existing layout, or create a new one by clicking New.

    Multiple softphone layouts are allowed. When you create or edit a layout, you can specify that layout to be the default used by profiles.

  5. If you want to modify the list of objects to search, click Add / Remove Objects in the Softphone Layout section, under Display these salesforce.com objects.

  6. If you want to edit the field list for an object type, click Edit in the Results panel of Agent for Salesforce. Be aware that you can select more than three fields, but the Results panel only displays the first three fields defined.

  7. If you want to modify the browser that the screen pop opens within select Existing browser window or New browser window or tab.

  8. If you want to specify the action Agent for Salesforce takes when you perform a default or custom query, modify the CTI 2.0 or Higher Settings.

The screen pop opens the object type that was requested. No additional information is included from the ACD. If you would like to map data to the screen pop when it opens, such as ACD data or script variables, this requires custom scripting. If necessary, reach out to your CXone Account Representative for scripting assistance.

Assign Profiles to the Softphone Layout

  1. Use the Search box to search for SoftPhone Layouts, and then click SoftPhone Layouts.

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

  3. Click SoftPhone Layout Assignment.

  4. Assign the appropriate softphone layout for each profile. Profiles assigned to -- Default -- use the layout you specified as the default when you configured the softphone layout. When done assigning layouts to profiles, click Save.

    The only profiles that display here are ones assigned to users with an assigned contact center definition. Profiles that are not assigned to users, or are not assigned to users with an assigned contact center definition, are not displayed.