Overview
Shared NICE integration
PolyAI integrates with NICE CXone using a shared connector service. Each client is assigned unique pseudo numbers by NICE, which are used alongside an authentication token to route calls to the correct project.Handoff process
Signal API
PolyAI uses the Signal API for call handoffs. This API supports up to 9 additional parameters, making it useful for passing larger data sets to clients.Requirements for the Signal API
- A Client-provided
access_key_idand access_key_secret. - The
Client_idandclient_secretfrom NICE: To obtain these, fill out the NICE API application form. Include:- Your CxOne business unit number.
- Your contact details, arbitrary application name, and description.
- Answer tenant-related questions: Select Single and Global.
- Select
secret_basicfor the authentication method andAdminAPIfor the API type. - Select Back-End for the application type.
client_id and client_secret from NICE.
Using the Signal API
- Configure the Signal API in the PolyAI project:
- PolyAI configures the Signal API connection for your project.
- The
contact_idis passed via an X-Header in the initial SIP INVITE.
- Pass additional data:
- The Signal API supports up to 9 additional parameters if more detailed data is needed beyond what the SIP X-Header can accommodate.
Setup steps
1: Obtain required credentials
- From NICE: Retrieve
client_idandclient_secretafter form submission. - From the client:
Access_key_idandaccess_key_secret, and the CxOne business unit number.
2: Configure the NICE connector in PolyAI
- Add a NICE connector to your PolyAI project.
- Save the provided authentication token for routing calls.
- If applicable, enable the Handoff API in your project and generate an API key for screen-pop or related functionality.

