Your Customer Service Data Template
Your Customer Service Data Template
This is our generic process mining data template for Customer Service. Use our system-specific templates for more specific guidance.
Select a specific system- Standardized data fields for consistent analysis
- Key activities for accurate process mapping
- Foundational structure applicable across various systems
Customer Service Attributes
| Name | Description | ||
|---|---|---|---|
| Activity Activity | The name of a specific business event, task, or step that occurred within the customer service process for a given service request. | ||
| Description An Activity represents a distinct step or event in the lifecycle of a service request. Examples include 'Service Request Created', 'Request Assigned', 'Solution Proposed', and 'Request Closed'. Each activity is associated with a specific service request and has a timestamp indicating when it occurred. This attribute is critical for building the process map, which is the visual representation of the customer service workflow. Analyzing the sequence and frequency of activities helps uncover the actual paths that service requests take, highlighting common workflows, bottlenecks, deviations, and rework loops. It forms the backbone of any process mining analysis. Why it matters This attribute defines the steps in your process map. It is essential for understanding what work is being done and in what sequence. Where to get Often derived from event logs, status change tables, or audit trail records within the customer service system. Examples Request CreatedRequest AssignedFirst Response SentRequest Resolved | |||
| Event Time EventTime | The timestamp indicating the precise date and time when a specific activity or event occurred. | ||
| Description Event Time, also known as the start time, captures the moment an activity happened. Every event in the log, from the initial creation of a service request to its final closure, is marked with a timestamp. This temporal data is crucial for ordering events chronologically. The sequence of these timestamps for a given service request allows process mining tools to reconstruct the process flow as it happened in reality. Event Time is the basis for all time-based analysis, including calculating the duration between activities, measuring the total case resolution time, identifying bottlenecks, and checking for compliance with service level agreements (SLAs). Why it matters This timestamp orders events and enables all duration-based analysis, such as calculating resolution times and identifying bottlenecks. Where to get Found in event logs or audit trail tables, often alongside the activity name. It may be named 'Creation Date', 'Event Date', or 'Timestamp'. Examples 2023-10-26T10:00:00Z2023-10-26T10:15:30Z2023-10-27T14:05:00Z | |||
| Service Request ID ServiceRequestId | The unique identifier for a single customer inquiry or issue. This ID links all related activities together into a single case. | ||
| Description The Service Request ID is the primary key that uniquely identifies each customer case from its creation to its final resolution. It serves as the case identifier, grouping all events, communications, and actions related to a specific customer issue into a cohesive timeline. In process mining, this attribute is fundamental for reconstructing the end-to-end journey of each service request. By correlating every activity to a specific Service Request ID, analysts can visualize process flows, identify deviations, and measure case durations accurately. It enables a case-centric view of the process, which is essential for understanding performance and identifying areas for improvement. Why it matters This is the essential case identifier. Without it, you cannot trace the journey of a single customer issue through the process. Where to get Typically found in the header or main table for cases, tickets, or incidents in a customer service management system. Examples SR-2023-00123CASE009876TKT-554321INC0123456 | |||
| Last Data Update LastDataUpdate | The timestamp indicating the last time the data was refreshed from the source system. | ||
| Description The Last Data Update attribute records the date and time of the most recent data extraction or refresh. This metadata is vital for understanding the freshness of the data being analyzed and for managing the data pipeline. This attribute provides transparency to business users and analysts about how current their analysis is. It helps in scheduling data refreshes and ensures that decisions are based on data that is as up-to-date as required. For monitoring ongoing processes, knowing the last update time is critical to correctly interpret the current state of open cases. Why it matters Indicates data freshness, ensuring that analyses and business decisions are based on timely and relevant information. Where to get This timestamp is typically generated and added during the data extraction (ETL) process. Examples 2023-10-27T02:00:00Z2023-10-28T02:00:00Z2023-10-29T02:00:00Z | |||
| Source System SourceSystem | The system of record from which the data was extracted. This is useful for tracking data lineage. | ||
| Description The Source System attribute identifies the application or platform where the customer service data originated, such as ServiceNow, Salesforce, Zendesk, or a custom in-house system. In environments where data from multiple systems is combined, this field is crucial for data governance and traceability. While not directly used in most standard process flow analyses, it provides important context. It helps in understanding potential variations in data quality or process execution between different systems. It is also essential for data validation, troubleshooting data extraction issues, and managing data integration pipelines. Why it matters Identifies the data's origin, which is crucial for data governance, troubleshooting, and analysis in multi-system environments. Where to get This is typically added during the data extraction (ETL) process and may not exist directly in the source system's tables. Examples Salesforce Service CloudZendesk SupportServiceNow CSM | |||
| Agent Agent | The name or unique identifier of the customer service agent or user responsible for an activity. | ||
| Description The Agent attribute identifies the individual employee who performed a particular activity or is currently assigned to a service request. This could be a unique ID, an email address, or a full name. This attribute enables performance and workload analysis at the individual level. It allows managers to see how work is distributed, compare agent performance on metrics like resolution time or customer satisfaction, and identify training opportunities. It is also crucial for analyzing handoffs between agents, which can be a source of delays and customer frustration. Why it matters This attribute is essential for analyzing agent workload, performance, and the impact of handoffs between different agents. Where to get Commonly found in case assignment history tables, event logs, or as a field on the main case or ticket record. Examples John Smithagent.jane@example.comuser_1138Sarah Doe | |||
| Assigned Group AssignedGroup | The team, department, or queue to which the service request is assigned. | ||
| Description The Assigned Group identifies the team or functional unit responsible for a service request at a given point in time. This could be 'Level 1 Support', 'Billing Department', or 'Technical Support Team'. Service requests are often routed between different groups as they progress. Analyzing the Assigned Group is critical for understanding inter-team collaboration and handoffs. It helps identify which teams are overloaded, where bottlenecks occur between groups, and the paths that different types of requests take through the organization. This information is vital for optimizing team structures, resource allocation, and routing rules. Why it matters Allows for analysis of team performance, workload distribution, and delays caused by handoffs between different departments. Where to get Located in the case or ticket record, often in fields like 'Assignment Group', 'Team', or 'Queue'. Examples Tier 1 SupportBilling InquiriesTechnical EscalationsHardware Support | |||
| Communication Channel CommunicationChannel | The channel through which the service request was initiated or communication occurred, such as 'Email', 'Phone', or 'Chat'. | ||
| Description The Communication Channel identifies the medium used by the customer to interact with the service desk. Common channels include email, phone, web portal, chat, and social media. The channel can influence customer expectations and the complexity of the resolution process. Analyzing the process by communication channel can reveal significant differences in performance. For example, requests submitted via phone might have faster resolution times but require more agent resources compared to those from a web portal. This analysis helps organizations optimize their channel strategy, allocate resources effectively, and tailor the service experience to different communication methods. Why it matters Reveals how different communication channels impact resolution times, agent effort, and overall process efficiency. Where to get Typically available as a standard field on the case or ticket record, indicating how the request was created. Examples EmailPhoneChatWeb PortalSocial Media | |||
| Customer Satisfaction CustomerSatisfaction | The satisfaction score or rating provided by the customer after the service request was resolved. | ||
| Description Customer Satisfaction is a key outcome metric that measures the customer's perception of the service they received. It is typically captured through a post-resolution survey, often on a numerical scale, like 1 to 5, or as a categorical rating like 'Good', 'Neutral', or 'Bad'. This attribute is crucial for connecting process performance to business outcomes. By correlating satisfaction scores with process metrics, analysts can identify which process behaviors lead to happy or unhappy customers. For instance, analysis might show that cases with multiple reassignments or long resolution times consistently receive low satisfaction scores. This provides a clear, data-driven basis for prioritizing process improvements that will have the greatest impact on customer experience. Why it matters Directly measures the customer's perception of service quality, linking process efficiency to business outcomes. Where to get Usually stored in a separate survey response table that can be linked to the service request record. Examples 5413 | |||
| End Time EndTime | The timestamp indicating when an activity was completed. It is used to calculate the duration of individual activities. | ||
| Description The End Time attribute marks the completion point of an activity. While Event Time marks the start, End Time provides the other necessary point to measure how long a specific task took. Not all events have a distinct end time, but for those that do, such as 'Agent Investigation' or a customer call, it is valuable information. In analysis, the difference between End Time and Event Time yields the activity's processing time. This is fundamental for bottleneck analysis, where the goal is to find which steps in the process consume the most time. Understanding activity durations helps in resource planning, performance evaluation, and identifying opportunities to streamline operations. Why it matters This attribute is key to calculating individual activity durations, which is essential for identifying bottlenecks and measuring efficiency. Where to get Usually found in event logs or audit trail tables alongside the start time. If not available, it may need to be derived from the start time of the subsequent event. Examples 2023-10-26T10:30:00Z2023-10-26T11:00:45Z2023-10-27T16:20:00Z | |||
| Is Escalated IsEscalated | A flag indicating whether the service request has been escalated to a higher level of support or management. | ||
| Description The Is Escalated attribute is a boolean flag (true or false) that marks a service request as having been formally escalated. Escalations typically occur when an issue is too complex for the current support tier, is not resolved within a specified time, or when a customer is highly dissatisfied. This attribute is essential for escalation analysis. It allows organizations to calculate the escalation rate, a key performance indicator. By analyzing the process flow of escalated cases, companies can identify the root causes of escalations, such as skill gaps in frontline support, unclear processes, or product issues. Reducing escalations is often a major goal, as they are costly and can negatively impact customer satisfaction. Why it matters Helps identify the frequency and root causes of escalations, highlighting opportunities to improve first-contact resolution. Where to get This is often a checkbox or flag field on the case or ticket record. It can also be derived by detecting an 'Escalate' activity. Examples truefalse | |||
| Priority Priority | The priority level assigned to the service request, such as 'Low', 'Medium', 'High', or 'Urgent'. | ||
| Description The Priority attribute indicates the urgency of a service request, which often influences how quickly it needs to be addressed. This level is typically determined based on the business impact and severity of the issue reported by the customer. SLAs are often tied to the priority level. In process analysis, priority is a key dimension for filtering and comparison. Analysts can check if high-priority requests are actually being resolved faster than low-priority ones, as expected. It helps to verify if prioritization rules are being followed and to assess whether resource allocation aligns with business priorities. Comparing the process flows for different priority levels can reveal inefficiencies in handling critical issues. Why it matters Allows analysis of whether urgent requests are handled faster and helps verify that resources are aligned with business needs. Where to get A standard field on the case or ticket form in most customer service systems. Examples LowMediumHighUrgent | |||
| Request Status RequestStatus | The current or historical status of the service request, such as 'Open', 'Pending', 'Resolved', or 'Closed'. | ||
| Description The Request Status indicates the state of a service request at a specific point in its lifecycle. The status changes as the request is worked on, for example, moving from 'New' to 'In Progress', then 'Pending Customer', and finally 'Resolved'. The sequence of status changes often forms the basis for the activities in the process model. Analyzing status changes is a primary way to understand the process flow. It helps identify how much time requests spend in certain states, such as 'Pending', which can highlight dependencies on external parties. It is also used to differentiate between open and closed cases, which is fundamental for reporting on active caseloads and resolution rates. Why it matters Tracks the lifecycle stage of a request, helping to identify time spent in waiting states and to define process activities. Where to get A core field on the case or ticket record. Status changes are often logged in an audit history table. Examples NewIn ProgressPending CustomerResolvedClosed | |||
| Request Type RequestType | The classification of the service request, such as 'Question', 'Incident', 'Problem', or 'Feature Request'. | ||
| Description The Request Type provides a high-level categorization of the customer's issue or inquiry. This classification helps segment service requests to understand the different types of demand being placed on the support organization. Common types include technical problems, billing questions, information requests, or complaints. This attribute is extremely valuable for analysis as it allows for filtering and comparing processes for different kinds of requests. For example, the resolution process for a 'Billing Question' might be much simpler and faster than for a 'Technical Incident'. Understanding these differences is key to setting appropriate SLAs, designing efficient workflows, and allocating resources effectively. Why it matters Segmenting requests by type is crucial for understanding different process paths and tailoring improvements to specific issues. Where to get This is a standard field on the main case or ticket form, often named 'Type', 'Category', or 'Classification'. Examples IncidentQuestionProblemFeature Request | |||
| Customer Customer | The name or unique identifier of the customer or company who initiated the service request. | ||
| Description The Customer attribute identifies the external client, either an individual or an organization, associated with the service request. This allows for the grouping and analysis of all service interactions for a particular customer. A customer-centric view is crucial for understanding the overall customer experience. By analyzing data filtered by customer, businesses can identify clients who submit a high volume of requests, which might indicate issues with a product or a need for better training. It also helps in tracking the service history for key accounts to ensure they are receiving the expected level of support. Why it matters Enables a customer-centric view of the process, helping to identify frequent issues for specific clients and manage key accounts. Where to get A standard field on the case or ticket record, linking to the contact or account object in the CRM. Examples ABC CorporationGlobal Tech Inc.Jane DoeACCT-00123 | |||
| Product Product | The product or service that the customer's request is related to. | ||
| Description The Product attribute specifies the particular product, service, or feature that is the subject of the customer's request. This allows for the categorization of service requests based on the area of the business they pertain to. Analyzing service requests by product is vital for root cause analysis and product improvement. A high volume of tickets for a specific product can signal quality issues, bugs, or usability problems. This data provides valuable feedback to product development and engineering teams, helping them prioritize fixes and enhancements that will reduce the support workload and improve the customer experience. Why it matters Links service requests to specific products, providing critical feedback for product improvement and root cause analysis. Where to get Often a field on the case or ticket form that links to a product catalog or can be manually entered. Examples Alpha-100 PrinterEnterprise Suite v2.5Mobile AppBilling Platform | |||
| SLA Target Time SlaTargetTime | The contractually agreed upon or targeted date and time for resolving the service request. | ||
| Description The SLA Target Time represents the deadline by which a service request is expected to be resolved according to the governing Service Level Agreement (SLA). This target is often dependent on the request's priority, type, or the customer's contract level. It can be stored as a specific timestamp or as a duration from the creation time. This attribute is fundamental for SLA compliance analysis. By comparing the actual resolution time with the SLA Target Time, organizations can determine their SLA compliance rate. Process mining can further break this down, showing which types of requests or which process steps are contributing most to SLA breaches. This allows for targeted improvements to meet service commitments. Why it matters This is essential for measuring SLA compliance, a critical KPI for customer service organizations. Where to get Typically calculated and stored on the case or ticket record based on defined SLA policies within the system. Examples 2023-10-28T10:00:00Z2023-11-01T17:00:00Z2023-10-26T14:00:00Z | |||
Customer Service Activities
| Activity | Description | ||
|---|---|---|---|
| Request Assigned | Represents the initial assignment of a service request to a specific agent or team for handling. This is a critical step that moves the request from a queue into an active workstream. | ||
| Why it matters This activity is crucial for tracking agent workload, measuring time to first assignment, and identifying bottlenecks in the dispatching process. Where to get Captured from changes to the 'Owner' or 'Assigned To' field in the service request record's audit log or history. Capture Identify the first population or change event for the agent or group owner field. Event type explicit | |||
| Request Closed | This is the final activity, representing the permanent, administrative closure of the service request. After this point, the request is considered complete and no further action is expected. | ||
| Why it matters This activity marks the definitive end of the process lifecycle. The time between resolution and closure can reveal process policies related to auto-closure or final review. Where to get Captured from an explicit status change to 'Closed'. Many systems have a dedicated 'Closed At' timestamp. Capture Use the 'Closed At' timestamp or the timestamp of the status change to 'Closed'. Event type explicit | |||
| Request Escalated | Represents the formal escalation of a service request to a higher tier of support, a different department, or management. This occurs when the initial agent cannot resolve the issue. | ||
| Why it matters Escalations are a key indicator of process complexity, agent capability, and first-contact resolution failures. Analyzing escalation paths helps optimize support structures. Where to get Can be an explicit event from an escalation rule engine or inferred from a reassignment to a designated escalation team or user. Capture Use a dedicated escalation flag or timestamp, or detect an assignment change to a known escalation team. Event type explicit | |||
| Request Reassigned | Indicates that responsibility for a service request has been transferred from one agent or team to another after the initial assignment. This represents a handoff within the support process. | ||
| Why it matters Tracking reassignments is crucial for analyzing process fragmentation and identifying unnecessary handoffs. Frequent reassignments can point to routing issues or knowledge gaps. Where to get Inferred by monitoring subsequent changes to the 'Owner', 'Assigned To', or 'Assignment Group' fields after the initial assignment. Capture Identify all changes to the owner or assignment group fields after the very first assignment. Event type inferred | |||
| Request Reopened | Occurs when a previously resolved service request is returned to an active state. This usually happens if the customer reports that the issue was not fixed or has recurred. | ||
| Why it matters Reopened requests are a direct measure of rework and a strong indicator of first-contact resolution failure. Analyzing these events is crucial for improving solution quality. Where to get Usually an explicit event where the system automatically changes the status from 'Resolved' back to 'Open' upon receiving a new customer reply. Capture Detect a status change from a 'Resolved' or 'Closed' state back to an 'Open' or 'In Progress' state. Event type explicit | |||
| Request Resolved | This is a key milestone where the agent has completed the work and considers the customer's issue addressed. The request is moved to a 'Resolved' or 'Solved' state. | ||
| Why it matters This is the primary event for measuring resolution time. It signifies the completion of active work by the support team and is a critical milestone in the service lifecycle. Where to get Captured from an explicit status change to 'Resolved' or 'Solved'. Most systems record a specific resolution timestamp. Capture Use the 'Resolved At' timestamp or the timestamp of the status change to 'Resolved'. Event type explicit | |||
| Service Request Created | Marks the beginning of the customer service process when a customer's request is formally logged. This event is captured when a new case, ticket, or interaction record is generated in the source system. | ||
| Why it matters This is the primary start event for the process. It is essential for measuring the total lifecycle duration and analyzing incoming request volumes over time. Where to get Typically captured from the creation timestamp of the primary case or ticket record in the service management system. Capture Use the creation timestamp of the main case, ticket, or incident entity. Event type explicit | |||
| Agent Starts Investigation | Signifies that an agent has actively started working on the service request. This is distinct from the assignment and represents the beginning of the diagnostic or resolution effort. | ||
| Why it matters Helps differentiate between waiting time and active work time. Analyzing this activity can reveal delays between assignment and the start of actual work. Where to get This is typically inferred from a status change in the service request, such as from 'New' or 'Assigned' to 'In Progress' or 'Work in Progress'. Capture Identify the first status change to an active 'in progress' state after assignment. Event type inferred | |||
| Customer Satisfaction Received | This event occurs when the customer submits their response to the satisfaction survey. The feedback, such as a rating or comment, is logged against the service request. | ||
| Why it matters Provides a direct link between process execution and customer-perceived quality. Analyzing satisfaction scores in the context of the process helps identify steps that lead to poor experiences. Where to get Captured from the survey module when a customer response is submitted and associated with the original service request. Capture Use the submission timestamp of the customer satisfaction survey response. Event type explicit | |||
| First Response Sent | Marks the first direct, non-automated communication sent by an agent to the customer after the request was created. This is a key milestone for customer engagement. | ||
| Why it matters This activity is critical for measuring and monitoring 'First Response Time' SLAs. It reflects how quickly the support team engages with customer issues. Where to get Often an explicit timestamped event in the system's SLA engine. It can also be inferred by finding the first outbound public communication from an agent in the case timeline. Capture Use the dedicated 'First Response Time' timestamp if available, or find the timestamp of the first outbound agent message. Event type explicit | |||
| Information Received From Customer | Marks the point when the customer provides the requested information, allowing the agent to resume work. This event typically moves the request from a pending state back to an active one. | ||
| Why it matters This event concludes a customer wait period. Analyzing the time between this and the 'Information Requested' activity reveals customer response times. Where to get Inferred from an inbound communication from the customer or an automatic status change from 'Pending' back to 'Open' or 'In Progress'. Capture Detect an inbound customer message or a status change from a 'pending' state to an 'active' state. Event type inferred | |||
| Information Requested From Customer | Occurs when an agent requires more information from the customer to proceed and places the request in a pending state. This pauses any internal process or SLA timers. | ||
| Why it matters This activity is key to understanding customer-related delays. Tracking the duration of this state helps separate agent work time from customer wait time. Where to get Typically inferred from a status change to a value like 'Pending', 'On Hold', or 'Awaiting Customer Info'. Capture Identify status changes to a 'pending' or 'waiting on customer' state in the case history. Event type inferred | |||
| Internal Comment Added | An agent adds a private note or comment to the service request, intended for internal collaboration with other agents or teams. This is not visible to the customer. | ||
| Why it matters These events indicate internal collaboration, knowledge sharing, or preparation for escalation. A high frequency of internal notes may suggest case complexity or knowledge gaps. Where to get Captured from the activity stream or communication log of the service request, filtering for comments marked as 'internal' or 'private'. Capture Filter the case comment or activity log for entries designated as internal-only. Event type explicit | |||
| Request Categorized | Represents the classification of a service request by type, category, or priority. This step is often performed by an agent or automation rules to determine urgency and routing. | ||
| Why it matters Analyzing categorization changes helps identify triage effectiveness, rework, and misrouted requests. It also provides context for the complexity and nature of service requests. Where to get Usually inferred from the audit log or history tracking changes to fields like 'Category', 'Type', or 'Priority' on the service request record. Capture Detect changes to categorization, priority, or type fields in the case history. Event type inferred | |||
| Satisfaction Survey Sent | Represents the sending of a customer satisfaction survey, typically triggered by an automation rule after a service request is resolved. This initiates the feedback collection process. | ||
| Why it matters This activity provides context for customer feedback metrics. It helps analyze survey response rates and the timing of feedback requests. Where to get Captured from an automation log, an outbound email record, or a dedicated survey instance record linked to the service request. Capture Identify the creation of a survey object or an outbound communication related to a satisfaction survey. Event type explicit | |||
| SLA Breached | Represents the moment a service request fails to meet a defined Service Level Agreement, such as time to first response or time to resolution. This is a business-critical event. | ||
| Why it matters This activity directly measures service level performance and compliance. Analyzing when and why breaches occur is essential for process improvement and managing customer expectations. Where to get This is a calculated event, derived by comparing activity timestamps against predefined SLA targets in the service contract or policy engine. Capture Compare the timestamp difference between start and end activities with the defined SLA target. Log a breach event if the duration exceeds the target. Event type calculated | |||
| Solution Proposed | Signifies that an agent has formulated a solution and communicated it to the customer. This activity may precede the formal resolution, especially if customer confirmation is required. | ||
| Why it matters This conceptual step helps differentiate the time taken to find a solution from the time spent waiting for customer acceptance. It provides a more detailed view of the resolution phase. Where to get Typically inferred from an outbound communication containing resolution details or a status change to 'Awaiting Acceptance' or 'Solution Provided'. Capture Identify an outbound message with keywords like 'solution' or a status change indicating a proposed resolution. Event type inferred | |||
Extraction Guides
Extraction methods vary by system. For detailed instructions,