Sentient Guide

Cases

Cases is the core of the Support module. It allows agents to:

Cases Overview Interface
The Cases interface showing the main dashboard with case listings, filters, and action buttons.

1. Add New Case

  1. Go to Support > Cases
  2. Click “+ Case” and fill required fields then Save.
  3. If contact not found, click the green "+" icon beside the Company/Contact field and fill in the required information for the new contact under the specific company.
  4. If site not found, click the green "+" icon beside the Site field and fill in the required information.

Fields marked with a red asterisk ( * ) are mandatory and must be filled out before submitting the case.

Add New Case - Small View
Quick view of the Add Case button and initial form.
Add Case Form - Part 1
The Add Case form showing required fields and company/contact selection.
Add Case Form - Part 2
Site and Company/Contract Selection.

1.1 Assign Multiple Cases

After selecting one or multiple cases, you can either assign them directly to a specific user or move them to another board.

Assign Multiple Cases
Assigning multiple cases to a specific user or moving them to another board.

1.2 Merge Cases

Cases must share the same Company, Site, and Contact.

How it works:
Selecting Cases to Merge
Selecting cases with the same company, site, and contact, and clicking on merge.
Merge Modal - Choosing Parent
The merge modal showing the option to choose which case will act as the parent.

1.3 Delete Cases

You can also delete one or multiple cases. A confirmation popup will appear, requiring you to type the word "delete" to confirm and proceed with the deletion.

Selecting Cases and Delete Modal
Selecting cases and clicking on delete, showing the delete modal popup.
Delete Confirmation Modal
The confirmation modal requiring you to type the word "delete" to confirm and proceed with the deletion.

2. Generate Report

The Generate Report functionality allows agents to filter and export case-related data based on multiple criteria mentioned above.

The Table View dropdown includes three report formats:

Also includes the option to export the filtered report to a downloadable format (typically Excel or CSV).

Generate Report Button
The Generate Report button to access the report generation functionality.
Generate Report Modal
The Generate Report modal showing the three report formats: Support Report, Generic Report, and Notes View Report.

3. Filter Table

Clicking on the checkbox toggles visibility:

Filter Table Interface
The Filter Table interface showing checkboxes to toggle column visibility and drag & drop functionality to reorder columns.

4. Edit Case

By simply clicking on the case number, the Edit Case modal opens, allowing you to perform a variety of updates.

Clicking Case Number to Edit
To edit a case, click on the case number to open the Edit Case modal.
Edit Case Modal
The Edit Case modal showing case details with the Save Changes button below.

4.1 SLA Overview

This section displays the Service Level Agreement (SLA) tracking for the selected case. It includes the following metrics:

Each metric is represented by a colored badge that clearly indicates whether the SLA was met or breached for that stage.

You can toggle the visibility of this section using the arrow button in the top-right corner — click to expand or collapse the SLA details.
SLA Overview
The SLA Overview section showing Response Time, Workaround Time, and Closure Time metrics with colored badges indicating SLA status, and the toggle arrow button.

4.2 Basic Updates

You can update all basic fields that were initially available during case creation, such as the title, severity, contact, site, team, and description.

4.3 Linked Cases

The Link Cases toggle allows you to associate one case with another — ideal when multiple cases are related or stem from the same root issue.

When enabled, you can select and link relevant cases to group and track interconnected tickets more efficiently.

To link another case:

Link Cases Toggle and Plus Button
The Link Cases toggle enabled with the green "+" button to add linked cases.
Choose Case Popup
The "Choose Case" popup that appears after clicking the plus button, allowing you to search and select cases to link.
Added Linked Case
The linked case displayed after clicking Save, showing the successfully added linked case.

4.4 Supplier Escalation

Enable this option if the case needs to be escalated to a third-party vendor or supplier.

Once toggled on, it indicates escalation beyond the internal support team. Additional fields such as Vendor SR# and RMA# will appear to help track the supplier-side resolution.

Supplier Escalation Section
The Supplier Escalation section with the toggle enabled, showing the Vendor SR# and RMA# fields for tracking supplier-side resolution.

4.5 External Board

External Boards enable secure case escalation between two separate tenants by linking them through configurable permissions. Before a case can be escalated, an approval workflow must be completed to ensure proper authorization and control.

Agents can view escalated cases by applying the relevant board filter in the cases list. Escalated cases are clearly identifiable once the external board is selected.

To escalate or manage a case, agents can update the board assignment directly from the Edit Case modal. Escalation is performed by changing the case's board assignment to the appropriate external board from the case details view.

Board Dropdown in Cases Filters
The board dropdown in the cases filters, allowing agents to filter and view escalated cases by selecting the appropriate external board.
Board Dropdown in Edit Case
The board dropdown in the Edit Case modal, enabling agents to change the board assignment and take action on escalated cases.

5. Navigation Tabs

Located at the top of the panel, these tabs allow you to access different functions related to the case:

Navigation Tabs
The Navigation Tabs located at the top of the panel, showing Info, Notes, Resource Requests, Change Requests, Survey, and Activity tabs.

6. Notes Tab

In the Notes tab, agents can view, search, and manage all case-related notes.

The panel is divided into five sections: All Notes, External Notes, Internal Notes, Attachments, and My Drafts.

Agents can filter by each type, search within notes, and save notes as drafts.

6.1 Add Notes

A. Choose Type:

B. Choose Status:

C. Working Hours:

Specify the time spent on the case (From / To). The system will automatically calculate total hours.

D. Description:

Write a clear message or update relevant to the status.

Note: Editing rights may vary depending on the user's role.

Type Dropdown
The Type dropdown showing options (Internal w/ Email, Internal w/o Email, External, External Close Case, External Cancel Case) after clicking on Add Note.
Status Dropdown
The Status dropdown showing options (Pending Internal, Pending Customer, Workaround Provided).
Working Hours
The Working Hours section showing From/To time fields with automatic calculation of total hours.

6.2 Editing Notes – Rules by Type

External Notes:

Internal Notes / Task Types:

Editing Notes Rules
Editing Notes rules by type - External Notes showing only Worked Hours as editable, and Internal Notes showing all fields (text content, note type, attachments, worked hours) as editable.

6.3 Draft Option

Drafts can be edited before sending or deleted. They are clearly highlighted when the "My Drafts" section is selected.

Draft Option
The "My Drafts" section showing saved drafts that can be edited before sending or deleted, with drafts clearly highlighted.

7. Resources Tab

Request resources directly from the case.

Click “Create New Request” to open the request form.

You can specify:

The request will remain pending approval by the person configured in the Resource Request settings.

Resources Tab
The Resources Tab showing the "Create New Request" button and the request form with fields for intervention type, affected site, contact details, resource team, preferred resource, date of intervention, and action plan.

8. Change Requests

To submit a change request from the case:

9. Resources Overview

The Resources section in Edit Case > Info displays the time logged by each user on the case.

Tracked time is broken down into:

These hours are pulled from the Worked Hours specified in each note.

The color-coded bars provide a quick visual representation of how effort was distributed.

Note: Working hour schedules (IWH/OWH) are configured by the admin in another section of the system.

Resources Overview
The Resources Overview section in Edit Case > Info showing time logged by each user, broken down into IWH (Inside Working Hours), OWH (Outside Working Hours), and Total Hours, with color-coded bars for visual representation.

Cases Settings

Cases Settings Overview
Cases Settings overview showing all configuration options including Define Case Owners, Send Survey to Contact Upon Case Closure, Notify Contact When Case is Assigned, Enable Editing Incident Date, Status Board Configuration, Linked Case Rules, and Linking Affected Assets.

1. Define Case Owners

This section allows admins to define who can own a case by selecting the department, team, and specific agents. Once configured, click Save to apply the changes.

2. Send Survey to Contact Upon Case Closure

When a case is closed, a survey can be automatically sent to the contact via email. This can be configured in two ways:

3. Notify Contact When Case is Assigned

When a case is assigned to an owner, an email notification can be sent to the case contact. You can configure this to:

4. Enable Editing Incident Date

When enabled, agents will be able to manually edit the incident date and time of a case after submission or during review. This field appears in the Edit Case modal based on the configuration:

5. Status Board Configuration

This section handles automatic and manual case board changes based on status or user actions:

6. Linked Case Rules

This configuration controls behavior for parent-child linked cases:

7. Linking Affected Assets

This option enables associating relevant company assets with a case:

8. Make Technology Mandatory

If the flipswitch is enabled, a value for the technology field must be entered before creating the case. Turn it off if you do not want to enter a value.

9. Open Case by Email

This modal allows you to create a configuration where you select one or more companies and define subject keywords.

Reports

This section allows agents to upload and organize reports in a structured folder system. To add a new report:

  1. Select Company: Choose the company to associate with the report.
  2. Main Folder: Pick the top-level category under which the report should be saved.
  3. Sub Folder: Define a year or specific label to group reports further (e.g., “2025”).
  4. Attachments: Use the green “+” button to upload one or more report files. You can also clear all uploaded files using the “Clear All” option.
  5. Click Save to finalize the upload. The report will be listed in the corresponding folder and visible to agents with access permissions.
Reports Page
The Reports page showing the structured folder system with options to select company, main folder, sub folder, upload attachments using the green "+" button, and save reports.

Surveys

The Surveys Tab displays all responses submitted after a case is closed. It shows the case timeline, ownership, feedback, and submission metadata.

You can filter the results by date opened, date closed, company, contact, and survey status. Use the export options to download the displayed data.

The Surveys section also includes a dashboard with its own filters for analyzing survey data and responses.

Surveys Tab
The Surveys Tab showing all responses submitted after case closure, with case timeline, ownership, feedback, and submission metadata, along with filters for date opened, date closed, company, contact, and survey status.
Surveys Dashboard
The Surveys Dashboard showing survey data analysis with dashboard filters and visualizations.
Surveys Dashboard Filters
The Surveys Dashboard with filters applied, showing filtered survey data and response analysis.

Contracts

The Contracts Tab displays a list of active contracts linked to each company. It includes essential metadata like contract number, dates, and service type.

You can filter contracts by start date, end date, or company name to narrow down results.

Contracts Tab
The Contracts Tab displaying a list of active contracts linked to companies, showing contract number, dates, service type, and filters for start date, end date, and company name.

Case Scheduler

Case Scheduler
The Case Scheduler interface showing options to create scheduled cases that repeat automatically, with fields for company/contact, site, severity, schedule, and the ability to add contacts/sites using the green "+" button.

Rules,Routes & Boards

1. Rules

Rules Conditions Overview
Rules Conditions Overview showing how to set one or more conditions for rules based on case properties like severity, time unassigned, and status.
Rules Actions
Rules Actions showing how to define actions to take when rule conditions are met, with options to configure automated responses.
Rules Overview
Rule Overview.

2. Routes

3. Boards

3.1 External Boards

External Boards allow you to link two separate tenants and enable case escalation between them based on configured permissions. This feature includes an approval process that must be completed before a case can be escalated from one tenant to another.

External Boards Table
The External Boards table and section showing linked tenants and the ability to escalate cases between tenants with approval process.
Create External Board Modal
The modal to create an External Board after clicking the "+" button, showing options to link tenants and configure permissions for case escalation.

SLA

1. SLA Configuration

SLA Table Overview
SLA Table Overview showing all existing SLAs with their priority values, Response, Workaround, and Closure times, and available actions (Add, Edit, Copy, Delete).
SLA Configuration
Creating or viewing an SLA configuration showing custom Response, Workaround, and Closure times based on severity (S1 to S4), with options to specify if SLA applies during holidays and associate to Sites and Companies.
Edit SLA Priority
Editing SLA priority from outside the configuration, showing how agents can modify the priority values directly from the table view.

2. Schedules

Schedules
The Schedules interface showing how to create custom schedules by specifying schedule name, working days, and time from/to (in HH:MM format), with options to add, edit, or delete schedules.

3. Dashboard

The Dashboard provides a visual interface for monitoring support team performance and SLA metrics.

It displays key metrics including active cases, response times, resolution times, and hours spent per engineer or customer.

SLA Dashboard Overview
The SLA Dashboard showing key performance metrics, active cases and closed cases.
SLA Dashboard Details
The SLA Dashboard with detailed metrics including response times, resolution times, and hours spent per engineer or customer with IWH/OWH breakdown.
SLA Dashboard Filters
The SLA Dashboard with filters and customizable views showing filtered metrics and performance data based on selected criteria.

Escalation

Escalation Overview

Dashboard

Dashboard Overview

Dashboard Overview
The Dashboard showing filters (Severity, Timeframe, Internal Cases toggle), Active/Overdue/Assigned/Closed Cases per Engineer, Response & Resolution time per case owner, Hours Spent charts, and other performance metrics.

Scheduled Reports

Scheduled Reports Overview

Projects

1. Projects

2. Generate Report

The Generate Report functionality allows agents to filter and export case-related data based on multiple criteria mentioned above.

The Table View dropdown includes two report formats:

Also includes the option to export the filtered report to a downloadable format (typically Excel or CSV).

3. Navigations

Project Settings

1. Project Managers & Email Configuration

1.1 Define Project Managers

This section allows administrators to assign project managers by selecting a specific department, team, and agents. Once configured, these agents will be recognized as project managers within the system.

1.2 New Project Email Configuration

Configure the recipients of the email notification that is sent when a new project is created. Add the desired email addresses in the "To" and "Cc" fields. You can enable or disable this email via the toggle switch.

1.3 Closed Project Email Configuration

Similar to the new project email, this section defines who will be notified via email once a project is marked as closed. Recipients can be configured in both "To" and "Cc" sections, and the feature can be toggled on or off as needed.

2. Project Status, Types & Risks Management

2.1 Project Status Configuration

This section allows administrators to define the various statuses a project can have throughout its lifecycle. You can:

2.2 Risk Management Categories

Admins can define and manage risk categories associated with projects. These categories help classify potential risks and ensure structured mitigation tracking. You can:

2.3 Project Types Configuration

This section allows administrators to define the various types a project can have throughout its lifecycle.

3. Documents Management

Document Types Configuration

Define various types of project documents and mark whether each is required before project closure.

Documents Settings

Toggle whether documents can be added or deleted after a project is marked as closed. This ensures better control over final project documentation integrity.

Task Settings

1. Define Task Assignee

Specify the Department, Team, and Agents to assign responsibility for tasks. This helps ensure clear accountability within the team structure.

2. Define Task Priority

Configure the task priority levels (e.g., Low, Medium, High) to help organize and manage tasks based on urgency and importance. Each level can have a custom name, order, and color.

3. Define Task Status

Configure task statuses to track and manage task progress efficiently. You can define the name, display order, and color for each status.

Contracts Management

Contracts Overview

This page displays all existing contracts in a tabular format with advanced filtering options:

To create a new contract, click the green "+" button and provide the required information:

we have three Contract Type

The Covered technologies and the Types of Cases are configured in the Contracts Settings section.

Surveys

The Surveys Tab displays all responses submitted after a project is closed. It shows the project timeline, ownership, feedback, and submission metadata.

You can filter the results by date opened, date closed, company, contact, and survey status. Use the export options to download the displayed data.

My Workspace

The My Workspace tab provides a personalized view of all projects and cases assigned to you.

Dashboard

Dashboard Overview

Shifts Management

1. Shifts Definition

The Shifts module allows to define working schedules for agents.

Agents can perform the following actions within the Shifts module:

2. Shift Assignments

The Shift Assignments module allows to assign predefined shifts to departments, teams, or specific agents.

Agents can perform the following actions within the Shift Assignments module:

Shift assignments can be filtered by: Department, team, agent.

Note: Even if a specific agent is not directly assigned to a shift, if their department or team is included in the assignment, the shift will still apply to them. When searching for an agent, their associated department or team assignments will be automatically considered.

Holidays

Holidays Overview

The Holidays module allows to define and manage holidays within the system.

Agents can perform the following actions within the Holidays module:

Holidays can be filtered using the following criteria: Name and Year.

Overtime

1. Requests

The Overtime module allows agents to create and manage overtime requests based on work completed outside regular working hours.

Agents can perform the following actions within the Overtime module:

2. Settings

The Settings module allows to configure approval workflows and email notifications related to overtime requests.

Agents can configure the following within the Settings module:

Vacation & Leave

1. Requests

The Vacation / Leave module allows agents to submit and manage leave requests within the system.

Agents can perform the following actions within the Vacation / Leave module:

The module also includes a Dashboard that provides insights into leave data through visualizations such as graphs and tables, allowing administrators to monitor trends and user activity.

2. Settings

The Settings module allows to configure approval workflows and leave balance rules for vacation and leave requests.

Agents can configure the following within the Settings module:

Database

Companies

This section allows you to create and manage companies, define their attributes, configure their flags, and handle related contacts, sites, and integrations.

Create a New Company

Click the green "+" button to add a new company. You must provide:

Edit an Existing Company

When editing a company, the following tabs are available:

Flags determine how the company interacts with different modules (e.g., Vendor/Contractor visibility). Make sure to configure them properly during setup.

Contacts

This section enables you to manage all contacts linked to companies. You can filter, create, and edit contacts easily using the interface shown.

Search and Filter

You can filter contacts by: Company, Name, Email, Phone

Create a New Contact

Click the green "+" button to create a new contact. Required fields are marked with an asterisk (*):

Edit Existing Contact

Click on an existing contact’s row to update their details. You can also enable or disable their portal access directly from the contact table view.

Each contact must be linked to a valid company and team. Case visibility controls what cases the contact can access from the portal.

Sites

This section allows you to manage all sites associated with companies. You can view, filter, and create new sites using the provided interface.

Search and Filter

You can filter sites by: Company, Country, Site Name

Create a New Site

Click the green "+" button to create a new site. Required fields are marked with an asterisk (*):

Edit Existing Site

Click on an existing site's row to update its details. You can modify the name, associated company, location, and description as needed.

Each site must be linked to a valid company. Sites can be referenced in contracts, assets, and support cases for precise location-based tracking.

Technologies

This section allows you to manage the list of technologies used across contracts, assets, and cases. Technologies are centralized here for consistency and reuse throughout the platform.

View and Search

You can browse all existing technologies and filter the list by:

Create a New Technology

Click the green "+" button to create a new technology. Simply enter the desired Technology Name and click Save.

Edit or Copy Technology

Technologies created here are referenced in Contract Configuration and Asset Classification. Ensure proper naming for consistency across modules.

Categories

This section lets you manage asset or service categories used across the platform for classification, filtering, and reporting purposes.

View and Filter

You can view all existing categories. Use the built-in filters to quickly locate a category by name.

Create a New Category

Click the green "+" button to create a new category. Provide a unique Category Name and click Save to add it to the list.

Edit or Copy Category

Categories created here are used in asset tagging and reporting. Maintain consistent naming to ensure accurate classification.

Settings Overview

This section allows you to configure tags that can be linked to companies for categorization or identification purposes.

Enable Company Tag Usage

Manage Company Tags

Below the configuration section, you can: Create, Edit, Delete a Tag

These tags help in classifying companies and can be filtered or reported on based on their tag assignments.

Change Management

Requests Overview

The Change Management module allows agents to create, track, and manage change requests in a structured and controlled manner, ensuring proper approval workflows and full visibility across the organization.

Creating a Change Request

A Change Request can be created in three different ways:

Each change request includes key information such as implementation date, company, change request process, affected technology, site, description, change reason, and service test checklist.

The change request process is configured through the Settings section.

Editing and Resending Change Requests

Reporting

The Change Management module provides reporting capabilities, allowing agents to generate reports on change requests. Reports can be filtered based on relevant criteria and used for tracking, auditing, and operational analysis.

Settings Overview

The Settings section allows administrators to configure two key components related to Change Management.

Change Management Request Process

This configuration defines how a change request is processed within the system. It allows administrators to set up the approval workflow and control how change requests move through different stages.

Email Notification for Approvers Configuration

This configuration controls email notifications sent to approvers.

If the agents listed below are configured as Approvers, they will receive, in addition to the system notification, an email notification prompting them to review and approve change requests.

Asset Management

Assets Overview

The Asset Management module enables agents to manage organizational assets efficiently, providing full visibility, control, and approval.

Agents can perform the following actions within the Asset Management module:

Settings Overview

The Settings section allows administrators to configure key components related to Asset Management.

Asset Configuration

  • Define asset groups based on company structure.
  • Configure vendors associated with assets.
  • Manage asset statuses (e.g. Opened, In Progress, Inactive).
  • Define asset types (e.g. Firewall, Router, VM, Access Point).

Asset Approval Levels

The system supports an Asset Assignment Approval process.

  • When enabled, the approval process is triggered during the asset creation phase.
  • Asset creation or assignment will remain pending until the required approvals are completed.
  • If this option is disabled, assets can be automatically approved without requiring manual approval.

Email Notification for Approvers Configuration

This configuration manages email notifications sent to asset approvers.

If the agents listed are configured as Approvers, they will receive, in addition to the system (bell) notification, an email notification requesting them to review and approve asset-related requests.

Contract Management

Contracts Overview

The Contract Management module enables agents to manage contracts efficiently, providing full visibility, control, and tracking of contractual agreements.

Agents can perform the following actions within the Contract Management module:

Settings Overview

The Settings section allows administrators to configure key components related to Contract Management.

Services Configuration

Currency Configuration

Notify Before Expiry

The system supports a contract expiry notification feature to alert agents before contracts expire.

This configuration allows customization of the email notifications sent for contract expiry.

Case Close Settings

This configuration controls contract selection behavior when closing a case.

Nearly Expiry Days

Define the number of days before contract expiry that is considered as "nearly expiry".

Show Active Contracts Only

Configure whether to show only active contracts when selecting a contract in cases and notes.

Agents & Roles

Agents & Roles Overview

1. Agents

To create an Agent, the following elements must be created before: A department, a team and a role.

Agents can perform the following actions within the module:

Authentication defines how the agent logs into the system:

When an agent’s status is set to Off, they are removed from all dropdown lists across the system and are no longer able to access or log into the portal.

2. Roles

To create a Role, a department must be created before.

Agents can perform the following actions within the role module:

The Roles module provides highly detailed permission control, where each action within every page and module is assigned a specific permission. Administrators can grant access to agents based on their responsibilities by selecting the relevant permission checkboxes. Each role is defined by a name and is associated with a specific department.

3. Departments

To create a Department, you need to define the department name, assign a Head of Department, and choose the department type.

Agents can perform the following actions within the Department module:

4. Teams

To create a Team, a department must be created first.

Agents can perform the following actions within the Team module:

Knowledge Base

Knowledge Base Overview

1.Requests

The Knowledge Base module allows agents to create and share articles based on resolved cases or recurring issues. This helps other agents quickly find solutions and improve efficiency.

Agents can perform the following actions within the Knowledge Base module:

Articles can be filtered for easy access using the following criteria:

The module also includes a Leaderboard, allowing agents to track and identify agents who contribute the most articles to the knowledge base.

2. Settings

In the Settings module, agents can configure the approval levels for knowledge base articles, ensuring that articles follow the required review and approval process before being published.

Education Tracker

Requests Overview

1. Requests

The Requests module allows agents to create and manage various types of requests, including exams, certifications, and training.

Agents can perform the following actions within the Requests module:

2. Entries

The Entries module allows agents to manage the core components used in requests, including exams, certifications, vendors, and training classifications.

Agents can perform the following actions within the Entries module:

3. Settings

The Settings module allows administrators to configure approval levels, notifications, and email templates for requests such as exams and certifications.

Agents can configure the following within the Settings module: