> ## Documentation Index > Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt > Use this file to discover all available pages before exploring further. # NiCE CXone (Non-Integrated) > Integration with NiCE CXone for handing over conversations to human agents in environments that are not pre-integrated with NiCE CXone. Added in 2026.12 (beta) NiCE CXone handover provider logo ## Description This feature is in beta. We encourage you to try it out and provide us with feedback. The NiCE CXone (Non-Integrated) handover provider bridges Cognigy.AI and [NiCE CXone](https://www.nice.com/), enabling end users to connect with human agents in a NICE CXone contact center. NiCE CXone (Non-Integrated) is for Cognigy.AI installations that are deployed independently from NiCE CXone. The two systems run on separate infrastructure, so you must configure a BYOC (Bring Your Own Channel) channel and provide NiCE CXone credentials manually. ## Prerequisites * Access to [NiCE CXone](https://cxone.niceincontact.com/). * Cognigy.AI installation isn't integrated with [NiCE CXone environment](/ai/administer/access/management-ui#create-an-organization). If your Cognigy.AI installation is already integrated with NiCE CXone at the platform level, use the standard [NiCE CXone (Integrated) handover provider](/ai/escalate/handover-reference/nice-cxone/nice-cxone-integrated). * An Administrator role in NiCE CXone to access the required configuration settings and create API credentials. * A Client ID and Client Secret obtained by submitting the [CXone Application Registration](https://forms.microsoft.com/Pages/ResponsePage.aspx?id=vdojcYcOqU2cubfsggEarfHlkRVlgSlMjqsp52ASGttUM1U2VTQ4N0pXNk5XSzROV0VNNkhBU1gzMC4u) form. NiCE sends the credentials to your registered technical contacts within 2–3 business days. You need these credentials later in Cognigy.AI. ## Restrictions * [Snapshots](/ai/agents/deploy/snapshots) and [Packages](/ai/platform-features/packages) aren't supported. * The [Transfer Node](/ai/agents/develop/node-reference/voice/generic/transfer) isn't supported. * If your NiCE CXone Studio script is configured to send a message to the user after a handover is initiated, the **Repeat Handover Accepted Message** setting in the [Handover to Human Agent](/ai/agents/develop/node-reference/service/handover-to-agent) Node won't work. The message sent by the Studio script is treated as a human agent response, which prevents the **Handover Accepted Message** from repeating. * Configuring the estimated wait time logic isn't supported on the Cognigy.AI side for the NiCE CXone integration. Instead, add an [Estimated Wait Time](https://help.nicecxone.com/content/studio/actionscx/ewtestimate/ewtestimate.htm?cshid=EWTESTIMATE) action to your NiCE CXone Studio script. ## Configuration on the Cognigy.AI Side 1. In Cognigy.AI, go to **Deploy > Handover Providers**. 2. Click **+ New Handover Provider** and select **NiCE CXone**. 3. Enter a unique name for the provider. This name will be used as the channel name in NiCE CXone. 4. Click **Save**. The **Handover Provider Editor** page opens. In the browser address bar, locate the URL and copy the handover provider ID after `/handover-provider/`. For example, in the following URL: `https://trial.cognigy.ai/project/65ae8e3adc2d77e6e260aa37/69b009f72e3deaa53a602d66/handover-provider/69f9bba8844ecf15d07954f9`, the handover provider ID is `69f9bba8844ecf15d07954f9`. Copy and save this value. You need it when configuring the [Channel Integration ID](#channel-integration-id) field. 5. Configure the following fields: The unique identifier of your NiCE CXone instance. 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **General > Admin**. 3. Open the upper-right menu, click **My Profile And More** and select **My Profile**. 4. On the **General** tab, copy the value from the **Tenant ID** field and enter it in Cognigy.AI. The identifier of your NiCE CXone business unit. 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD > ACD Configuration > Business Units**. 3. On the **Business Unit details** page, copy the value from the **Unit Number** field and enter it in Cognigy.AI. Credentials for authenticating outbound API calls from Cognigy.AI to NiCE CXone. Configure the following parameters: * **Name** — a unique name for your connection. * **Access Key ID** — the Access Key ID for your NiCE CXone user: 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **General > Admin**. 3. Open the employee profile used for API access. 4. On the **Security** tab, click **Add Access Key**. 5. Click **Show Secret Key** and immediately copy the Access Key ID and Access Key Secret to a secure location. The Access Key Secret is shown only once. * **Access Key Secret** — the Access Key Secret copied in the same step as the Access Key ID. * **Client ID** — the Client ID received from NiCE CXone as part of [Prerequisites](#prerequisites). * **Client Secret** — the Client Secret received from NiCE CXone as part of [Prerequisites](#prerequisites). The identifier of the channel integration in NiCE CXone. 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD**. 3. Go to **Digital > Bring Your Own Channel** and click **+ Add**. 4. Configure the following fields: Replace `` in the URL with the domain of your Cognigy.AI instance. For example, if your instance URL is `https://trial.cognigy.ai`, replace `` with `trial`. * **Name** — a name for the integration, for example, `Cognigy.AI Integration`. * **Integration box URL** — `https://endpoint-.cognigy.ai/handover/niceCxOne`. * **Authorization URL** — `https://endpoint-.cognigy.ai/handover/niceCxOne/{handover-provider-id}/auth/token`, where `{handover-provider-id}` is the handover provider ID copied earlier. * **Add action URL** — `https://endpoint-.cognigy.ai/handover/niceCxOne/add`. * **Reconnect action URL** — `https://endpoint-.cognigy.ai/handover/niceCxOne/reconnect`. * **Remove action URL** — `https://endpoint-.cognigy.ai/handover/niceCxOne/remove`. * **Client ID** — a Client ID of your choice, for example, `nice-cxone-dev-tech-writers`. Save this value. You need it for the **Client ID** in [Channel Integration Authentication](#channel-integration-authentication). * **Client Secret** — a 32-character string. You can generate this value using any secure random string generator. Save this value. You need it for the **Client Secret** in [Channel Integration Authentication](#channel-integration-authentication). 5. Click **Save**. Copy the generated **Integration ID** and enter it in Cognigy.AI. Credentials for authenticating the channel integration. Configure the following parameters: * **Name** — a unique name for your connection. * **Client ID** — the Client ID you entered when creating the [channel integration in NiCE CXone](#channel-integration-id). * **Client Secret** — the Client Secret you entered when creating the [channel integration in NiCE CXone](#channel-integration-id). 6. Click **Save**. A channel is created on the NiCE CXone side. 7. Verify the created channel in NiCE CXone: 1. In NiCE CXone, go to **Omnichannel Routing > ACD**, then **Digital > Points of Contact Digital**. 2. Find the channel with the same name as your NiCE CXone handover provider in Cognigy.AI. If you don't find the channel, the connection wasn't established. Check the handover provider configuration to ensure that all credentials are valid. 1. In the Flow editor, add a [Handover to Human Agent](/ai/agents/develop/node-reference/service/handover-to-agent) Node. 2. From the **Handover Provider** list, select the NiCE CXone provider that you created. 3. Configure the handover behavior, such as accepted messages or cancellation handling, as needed. 4. *(Optional)* Configure additional settings: * **Send Transcript as first message** - allow NiCE CXone to receive the conversation transcript as the first message when the handover begins. This setting is turned on by default. * **Display Agent Details** - display the human agent's name and avatar from NiCE CXone in the chat for the end user. This setting is turned off by default. * **Custom Attributes** — add custom attributes, which allows you to include additional information. When sending custom attributes from Cognigy.AI to NiCE CXone, you can enter them in two ways: ```json JSON String theme={null} "{\"customerType\":\"premium\",\"tags\":[\"urgent\",\"vip\"]}" ``` ```json JSON Object theme={null} { "customerType": "premium", "tags": ["urgent","vip"], "preferences": { "language": "en", "notifications": true } } ``` No NiCE CXone-specific fields are required in the Node. Routing to the correct queue or human agent team is configured on the NiCE CXone side. ## Configuration on the NiCE CXone Side 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD > Roles**. 3. Select the role assigned to your account, for example, **Administrator**. 4. In **Assigned Channels**, select the channel with the same name as the NiCE CXone handover provider you created in Cognigy.AI. 5. Click **Update Role Permissions** and assign either all permissions or the minimum scope: * `Send Replies` * `Assign / Reassign Conversations` * `Reassign Conversations` Save your changes. To ensure that conversations are automatically assigned to human agents, create a skill and assign it to the channel and human agent. 1. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 2. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD > ACD Skills**. 3. Click **Create New > Single Skill**. 4. Configure the following fields: * **Media Type** — select **Digital**. * **Skill Name** — enter a name for your skill. * **Inbound/Outbound** — select **Inbound**. * **Campaign** — select any existing campaign. 5. Click **Create**. After creating the skill, assign it to the channel: 1. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD > Digital > Points of Contact Digital**. 2. Find the channel with the same name as your Cognigy.AI handover provider. Click **Edit**, go to the **Skills** tab, and select the created skill from the **Select default skill** list. 6. Verify the skill is assigned to a human agent: 1. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > ACD > ACD Users**. 2. Select the user from the list, and check the **Skills** tab to ensure the required skill is assigned. 1. Click the **Applications** app selector in the upper-left corner. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > Studio**. 2. Open the **Cognigy** folder. Inside, locate the **Cognigy Handover Script ``**, where `` is the ID of the handover provider in Cognigy.AI. Don't rename the folder because Cognigy.AI references the script by its original name when deleting the provider. You can adjust the script later using the [NiCE CXone Studio Scripts](https://help.nicecxone.com/content/studio/fundamentals/workwithscriptscx.htm?Highlight=scripts) documentation. In the script, make sure not to change the `ESCALATE` and `END ESCALATION` actions because Cognigy.AI uses them to start and end handovers. The `ONRELEASE` action notifies Cognigy.AI that the human agent has closed the conversation. Cognigy.AI then triggers the **On Resolve Options** setting configured in the [Handover to Human Agent](/ai/agents/develop/node-reference/service/handover-to-agent) Node. Use a Cognigy.AI [Webchat v3 Endpoint](/webchat/v3/configuration) for quick testing. 1. In Cognigy.AI, go to the Webchat v3 Endpoint settings. Open **Demo Webchat** and trigger the handover. 2. In NiCE CXone, click the **Applications** app selector in the upper-left corner. 3. In the left-side **CXone Mpower Hubs** menu, go to **Omnichannel Routing > Agent**. 4. In the **Agent** window, select your preferred option for how you want to connect. For example, select **Set Phone Number**, enter a phone number, and click **Launch**. 5. With the [correct skill assigned](#create-a-skill), the conversation will appear in the agent's queue. Otherwise, you can select **Search** in the left-side menu and find the recent conversation that was created. 1. Verify that the conversation appears in NiCE CXone. Confirm that it can be picked up by a human agent. 2. Send a reply from NiCE CXone and verify that it appears in the **Demo Webchat**. ## Troubleshooting | Issue | Cause | Recommended Action | | ----------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | The **Save** button remains active after saving | NiCE CXone authentication or timeout issue | Verify the NiCE CXone authentication outbound credentials or try clicking the **Save** button again later because NiCE may experience timeout issues. | ## More Information * [NiCE CXone (Integrated) Handover Provider](/ai/escalate/handover-reference/nice-cxone/nice-cxone-integrated) * [NiCE CXone Handover Provider Overview](/ai/escalate/handover-reference/nice-cxone/overview) * [All Handover Providers](/ai/escalate/handover-reference/overview) * [Handovers](/ai/escalate/handovers) * [NiCE CXone Endpoint](/ai/agents/deploy/endpoint-reference/nice)