Set up NiCE Digital messaging in Salesforce

NiCE Digital messaging brings chat, WhatsApp, SMS, and Facebook Messenger conversations into the same Omni-Channel widget agents already use for Salesforce Voice. NiCE CXone routes each digital interaction to an agent alongside their voice work, so agents handle all channel types from one console. This section walks a Salesforce admin through connecting a NiCE Digital messaging channel and confirming agent access.

Prerequisites

  • System Administrator access to Salesforce Setup.

  • A NiCE CXone contact center already configured for Salesforce Voice.

  • The NiCE Digital connector app and NiCE Digital Channel Definition already installed in the org.

  • At least one available Messaging User license, and Digital Engagement enabled in the org.

Limitations

  • The WhatsApp channel currently supports inbound messages only. Outbound support is planned for a future release.

  • The channel supports private messages only. Public messages aren't supported.

Review the NiCE Digital connector app

The messaging channel you create in the following task connects to this app, so confirm it's active before you continue.

External Client App naming constraint: NiCE Digital requires an External Client App with a specific API name. Salesforce lets you change an app's name after it is created, but it does not let you change the API name. An existing External Client App therefore does not work with NiCE Digital if its API name differs from the one below. In that case, create a new External Client App with the following details:

Field Value
App Name NiCE DigitalConnectorApp
API Name NiCE_DigitalConnectorApp

Then update the same app name and API name in the Connection Hub connectors.

  1. In Salesforce Setup, enter External Client Apps in the Quick Find box, then select External Client App Manager.

  2. Select NiCE DigitalConnectorApp.

  3. Expand OAuth Policies to confirm the Permitted Users setting and the enabled OAuth flow.

  4. Select the Settings tab, then expand OAuth Settings to confirm the Callback URL and the scopes listed under Selected OAuth Scopes.

Add a NiCE Digital messaging channel

  1. In Setup, enter Messaging Settings in the Quick Find box, then select Messaging Settings under Feature Settings > Service > Messaging.

  2. Confirm the Messaging toggle is turned on.

  3. Under Channels, click New Channel.

  4. In the Add a Channel window, under Bring Your Own Channels, select NiCE Digital Channel Definition, then click Next.

  5. Select Use an existing contact center, choose your NiCE CXone contact center from the Contact Center dropdown, then click Next.

    If your existing Contact Center doesn't appear in the dropdown, delete the current Contact Center configuration and create a new one. After you recreate it, the Contact Center appears in the dropdown.

  6. Enter the following channel details, then click Save:

    Field Value
    Channel Name NiCE Digital
    Developer Name NiCE_Digital

    In the Add a Channel window, enter the Developer Name in the API Name field.

  7. On the channel's detail page, confirm the Conversation Channel Definition section lists NiCE DigitalConnectorApp as the connected app and your NiCE CXone contact center under Contact Center.

Give the SCRT2 Permission Set access to the NiCE Digital platform event

The SCRT2 Permission Set needs access to the custom NiCE Digital platform event. Without this access, outbound messages fail with an error.

  1. In Setup, enter Permission Sets in the Quick Find box, then select Permission Sets.

  2. Select the SCRT2 Permission Set.

  3. Go to Object Permission.

  4. Find NiCE Digital Events, and then select Read and Create.

  5. Click Save.

Confirm agent permission assignments

Agents need the right permission set and permission set license to work the new channel.

  1. In Setup, enter Users in the Quick Find box, then select Users.

  2. Select the agent's user record.

  3. Under Permission Set Assignments, confirm the user has Contact Center Bring Your Own Channel User and the Salesforce Voice contact center permission set that matches their role.

  4. If Contact Center Bring Your Own Channel User (or the matching Salesforce Voice contact center permission set) isn't already listed under Enabled Permission Sets, add it:

    • Click Edit Assignments next to Permission Set Assignments.

    • In Available Permission Sets, select Contact Center Bring Your Own Channel User, then click Add to move it into Enabled Permission Sets.

    • Click Save.

  5. Under Permission Set License Assignments, confirm the user has the Messaging User license. If it isn't already selected, add it:

    • Click Edit Assignments next to Permission Set License Assignments.

    • Select the checkbox next to Messaging User.

    • Click Save.