Agent Workflow Configuration in NICE CXone (Detailed Guide)

Agent Workflow Configuration in NICE CXone

Agent Workflow Configuration is a key action in NICE CXone Desktop Studio used to connect your CRM workflows with the Agent Workspace.

In simple terms:

It tells the system “When an agent performs an action → trigger this CRM workflow.”

This is essential when integrating platforms like Salesforce, ServiceNow, or any CRM with NICE CXone.

Why This Action is Important

Without this configuration:

Agents cannot trigger CRM workflows Customer data won’t sync properly Automation inside Agent Workspace won’t work

With it:

Agents get real-time CRM data Automation reduces manual work Customer experience improves

What Agents Can Do Using This

This action enables 3 major agent activities:

1️. Search (Second-Level Search)

• Agent clicks Refresh/Search
• Gets more detailed customer data

2️. Add Timeline Activity

• Agent logs interaction into CRM
• Example: “Customer called regarding billing issue”

3️. Data Memorialization (ACD Data Mapping)

• Stores call/chat data into CRM fields
• Example:
  • Call duration
  • Agent ID
  • Queue name

High-Level Workflow Diagram

Here’s how everything connects:

Agent Action (Workspace)

    ↓

Agent Workflow Configuration

    ↓

Workflow Execute Action

    ↓

CRM Workflow Triggered

    ↓

CRM (Salesforce / ServiceNow)

    ↓

Data Displayed Back in Agent Workspace

Where to Find It in Studio

Location:

Framework Tab → Agent Workflow Configuration

Dependencies

Before using this action, ensure:

Agent Application

Agents must use one of:

• Agent Workspace (Desktop)
• Agent Workspace (Browser Extension)
• Agent for Microsoft Teams

CRM Integration Setup

• Must be configured in Agent Integrations page
• At least one workflow must exist

Login Requirement

To use the wizard: Login using CXone username & password

Session ID login → Wizard won’t open

Required Pairing

You MUST use:

Agent Workflow Configuration

        +

Agent Workflow Execute

These two always work together.

Script Type Support

Phone Scripts Digital Scripts (Chat, Email, etc.)

Input Properties

Caption

• Label for your action
• Example: CRM Workflow Setup

AgentUserID

Important difference:

| Script Type

|

Format

| | — | — | |

Phone

|

{__AgentID}

| |

Digital

|

{AgentID}

|

Wrong format = data won’t show in UI

SearchWorkflow

• Workflow used when agent performs search

TimelineWorkflow

• Workflow used when agent logs activity

DataMemorializationWorkflow

• Workflow used to store ACD data in CRM

SearchCacheKey

Used to pass search results from:

Workflow Execute → Agent Workspace

Leave empty if using Custom Event instead of cache

SearchInput

• Dynamic search field (configured in wizard)

Example: phone number, email, customer ID

Workflow Configuration Diagram

+——————————+

| Agent Workflow Configuration |

+——————————+

    |       |       |

    ↓       ↓       ↓

Search Timeline DataSave

Flow Flow Flow

    ↓       ↓       ↓

 CRM Workflows (Mapped)

Result Branch Conditions (Error Handling)

These help your script handle different situations:

| Condition

|

Meaning

| | — | — | |

Default

|

Normal path

| |

Success

|

Everything worked

| |

InvalidAgentId

|

Agent ID incorrect

| |

AgentNotConnected

|

Agent offline

| |

InvalidWorkflowConfigData

|

Wrong config

|

Branching Diagram

      Action Executes

             ↓

  -------------------

    |                |          |

 Success  Error   Invalid

    |                |          |

 Continue  Retry   Alert

Configuration Wizard (Step-by-Step)

Step 1: Open Wizard

Double-click the action

Step 2: Select CRM Configuration

• Choose integration (e.g., Salesforce)

Step 3: Select Agent Actions

✔ Search ✔ Timeline ✔ Data Memorialization

Step 4: Map Workflows

Example:

| Action

|

Workflow

| | — | — | |

Search

|

Customer Lookup

| |

Timeline

|

Case Notes Update

| |

Data

|

Save Call Details

|

Step 5: Save Configuration

Click Save Properties auto-fill

Full Integration Flow Diagram

[Customer Interaction]

    ↓

[Agent Workspace UI]

    ↓

(Agent clicks action)

    ↓

[Agent Workflow Configuration]

    ↓

[Workflow Execute]

    ↓

[CRM API Call]

    ↓

[CRM System]

    ↓

[Response Returned]

    ↓

[Displayed in Agent Workspace]

Example Use Case

Scenario: Customer Calls Support

1. Agent receives call
2. Clicks Search
3. Customer data loads from CRM
4. Agent handles issue
5. Adds note (Timeline)
6. Call details saved automatically

Best Practices

Always match same CRM config in both actions Use correct AgentID format Test workflows before production Keep cache key clean unless needed Handle error branches properly

Common Mistakes

Using {__AgentID} in digital script Not linking Workflow Execute No CRM workflow configured Wrong mapping in wizard

Final Summary

Agent Workflow Configuration = Bridge between Agent + CRM

It allows:

• Smart data retrieval
• Activity logging
• Automated data storage

When combined with Workflow Execute, it creates a fully automated CRM integration inside NICE CXone Training.