Configuring the Customer History component
Summarize
Summary of Configuring the Customer History component
The Customer History component in ServiceNow’s Customer Service Management (CSM) provides a dynamic way for admins to customize how customer activity data is displayed and refreshed within various record pages, such as the Front-line case page and the CSM default record page. These configurations enhance agent workflows by improving data visibility, interaction, and responsiveness in the CSM Workspace.
Show less
Key Features
- Refresh Requested Property: Automatically refreshes the Customer History component and captures the last refresh timestamp. Admins can customize refresh behavior via event handlers in UI Builder, applicable on both Front-line case and CSM default record pages.
- Header Title Customization: Allows renaming the Customer History title directly within the component’s visibility settings on any page where it appears, improving interface clarity and user preferences.
- Show Bordered Icons: A toggle to enable or disable borders around icons within the component, helping tailor the visual design according to admin or user preferences.
- Page Design Drag-and-Drop: Simplifies customization by enabling admins to add, move, and resize the Customer History component directly in the page layout without navigating through tabs.
- Presets for Display: Two new presets on the Front-line case page allow admins to control how customer data loads and appears, including lazy loading options to optimize performance and user experience.
- Empty State Handling: Introduces clear messages like “No activities found” or “No customer identified yet” when data is missing, guiding agents to add necessary customer context. Admins can also enforce prompts when customer contact or name fields are empty, ensuring completeness.
- Show with Activity Creation Date: Controls whether timestamps reflect the original record creation date or the latest update date, allowing admins to align timestamp display with business needs.
- Activity Time Period Grouping: Enables grouping customer activities by day, month, quarter, or year. This setting is configurable per record page and helps agents view activities in the most relevant time context.
Practical Application for ServiceNow Customers
By configuring these properties, ServiceNow customers can tailor the Customer History component to better fit their organizational workflows and agent needs. Automatic refreshes keep data current without manual intervention, while customizable titles and icon styles enhance interface usability. The drag-and-drop design mode accelerates page setup and modification, and preset options optimize data loading and presentation. Handling empty states and timestamp formats ensures data completeness and clarity, reducing agent confusion. Lastly, flexible activity grouping allows teams to analyze customer interactions over preferred time frames, improving case resolution efficiency.
Admins should use UI Builder and Customer Central interfaces to access and adjust these settings, ensuring the Customer History component aligns with their customer service strategies and maximizes agent productivity.
Users with the admin role can configure several properties for the Customer History component.
Refresh requested
The Customer History component refreshes automatically, eliminating the need for manual page refreshes.
The Refresh requested UI Builder property captures the last refresh timestamp and triggers events such as Context Refresh Requested whenever the value changes. Admins can configure custom event handlers to adjust the refresh behavior as needed.
This property can be set for the following record pages:
- Front-line case page
- CSM default record page
- Navigate to .
- Select the CSM/FSM Configurable Workspace experience.
- Open the Front-line case page.
- Select the Customer History component.
- Navigate to the Properties panel.
- Capture the last refresh timestamp by enabling the Refresh Requested property.
- Customize the refresh behavior by adding or modifying event handlers under the Events tab.
- Select Customer Central.
- Open the Customer history section.
- Navigate to the Properties panel.
- Capture the last refresh timestamp by enabling the Refresh Requested property.
- Customize the refresh behavior by adding or modifying event handlers under the Events tab.
Header title
The Customizable Customer Activity Title feature enables admins to rename the Customer History title directly from the interface.
- In the right navigation pane, navigate to the Component visibility settings.
- Change the title according to user preferences by editing the Header title property.
This customization option is available on all pages where the Customer History component is used.
Show bordered icons
- Set to true: Enables bordered icons
- Set to false: Disables bordered icons
Admins can adjust this setting based on their preferences.
Page design
The Page Design feature introduces a drag-and-drop interface for easier customization of page layouts. Admins can add, position, and resize components directly on the page without using tabs.
- On the left navigation pane, select +Add Content.
- In the toolbox window that appears, enter Customer history component and then select and drag it.
The Customer History component is now available in the toolbox.
Presets
- Customer history for record page with lazy load
- Customer history for record page
- Navigate to .
- Select the CSM/FSM Configurable Workspace experience.
- Open the Front-line case page.
- Select the Customer History component.
- Select the existing preset in the configuration panel.
- In the Select a preset window, choose All under Controller to view available presets.
- Select one of the new presets to update how customer activity is displayed.
Default values are set for all fields to help prevent errors by ensuring that fields are never left null or empty.
New empty state for context fields
On the agent side, when viewing a case, customer history or activity data loads automatically if available. If there’s no activity, the system shows No activities found. If no account, contact, or consumer is selected, it displays No customer identified yet. This behavior is part of the empty state feature, guiding users to select or add context (account, contact, or consumer) to proceed.
Admins can now configure cases to handle scenarios where customer contact or name fields are empty. Instead of leaving the fields empty, the system prompts users to add the relevant account or contact information.
Show with activity creation date
- When enabled: Both the timeline and side timestamp display the activity creation date. For example, if a record (such as a case or interaction) was created 10 days ago but updated today, both will show today’s date.
- When not enabled (default behavior): Both the timeline and side timestamp display the original record creation date. So, in the same example, the record would continue to show as being created 10 days ago, even if it was updated today.
Activity time period
The Activity time period field in the Customer History component enables admins to define how customer activities are grouped for agents in the CSM Workspace. By default, activities appear by day, but you can change this to group them by quarter or by year.
- Navigate to .
- Select the CSM/FSM Configurable Workspace experience.
- Open the Front-line case page.
- Select the Customer History component.
- Navigate to the Properties panel.
- From the Activity time period drop-down, select one of the following options:
- Day: Enables an additional field where you can enter a date in
DD:MM:YYYYformat. - Monthly: Groups activities by month.
- Quarter: Groups activities by calendar quarter.
- Year: Groups activities by calendar year.
- Day: Enables an additional field where you can enter a date in
- Select Customer Central.
- Open the Customer History section.
- Navigate to the Properties panel.
- From the Activity time period drop-down, select one of the following options:
- Day: Enables an additional field where you can enter a date in
DD:MM:YYYYformat. - Monthly: Groups activities by month.
- Quarter: Groups activities by calendar quarter.
- Year: Groups activities by calendar year.
- Day: Enables an additional field where you can enter a date in