Business Data
Enrich your CXone interaction metadata using business data fields. These are custom fields that display data captured from Studio. For example, you can include data imported from your external sources (such as CRM systems) or during the IVR Automated phone menu that allows callers to interact through voice commands, key inputs, or both, to obtain information, route an inbound voice call, or both..
Once you've identified the fields you want to use, you need to:
-
Set Up a Studio Script—Professional Services can help you set up your script, but there might be a fee for this service. Contact your CXone Account Representative to learn more.
Keep in mind:
-
You can create up to 50 business data fields per tenant: 35 text, 10 numeric, and 5 true/false.
The business data field type can't be changed once created.
-
All field values show in search results, so make sure your field values don't include sensitive data.
-
You can change the Business Data Name but make sure to also update the Snippet action in the Studio script.
If the Studio script Snippet action and Business Data Name don't match, the data won't import from your third party system.
What Can You Use Business Data Fields For?
You can:
-
Filter interactions in a quality plan, see Quality Planner.
After business data is set up for your organization, you can create a quality plan that filters on the data imported from your CRM system. The business data must be defined as a text field for this to work.
For example, you can focus a specific account type (such as Platinum) and agent seniority (such as Junior).
-
Search for interactions based on the values in the business data text fields. The business data must be defined as a text field to be searchable.
You can add the business data columns to search results, see Customize Columns.
Set Up a Studio Script
Professional Services can help you set up your script, but there might be a fee for this service. Contact your CXone Account Representative to learn more.
In a Studio script:
-
Add a Snippet action that includes:
-
At least one Dynamic Data Object.
-
All the fields in the Snippet properties that you want to import from your third party system. For example, add Customer Acct Type and Agent Seniority.
-
A Business Data Name up to 38 characters.
-
-
Note the name defined in the Snippet action, you'll need to use the same name when you define the Business Data Name field in CXone.
-
Connect an MCR Meta Data action after the snippet.

DYNAMIC CustomUserFields
ASSIGN CustomUserFields.vipCustomer = "
{vipCustomer}
"
ASSIGN CustomUserFields.customerEmail = "
{emailAddress}
"
ASSIGN CustomUserFields.customerDepartment = "
{department}
"
ASSIGN CustomUserFields.mailingAddress = "
{mailingAddress}
"
ASSIGN CustomUserFields.customerName = "
{customerName}
"
For more information, see dynamic data object, Snippet, and MCR Meta Data.
Define Business Data Fields
You can create up to 50 business data fields per tenant: 35 text, 10 numeric, and 5 true/false. The business data field type can't be changed once created.
-
Make sure you have a Studio script with a Snippet and an MCR Meta Data action. See Set Up a Studio Script.
-
Click the app selector
and select Admin.
-
Go to Recording > Business Data.
-
Click New Field.
-
Enter the Business Data Name exactly as it appears in the Studio Snippet action. This field won't be displayed in CXone.
-
Enter the Display Name, as it should appear in CXone. This field can be up to 128 characters.
-
Select a Field Type. The field type must match the field type in your third party system.
Define the Field Type as text if it will be used in a quality plan, or if you want the contents of the field to be searchable in the Interactions application.
When the Field Type is text, the character limit for the business data value is 4000 characters.
-
Click Save.
Edit Existing Business Data Fields
The business data field type can't be changed once created.
You can change the Business Data Name but make sure to also update the Snippet action in the Studio script. The Business Data Name can be up to 38 characters.
If the Studio script Snippet action and Business Data Name don't match, the data won't import from your third party system.