What is the Case Checklist module?
The Case Checklist module is a prebuilt component that can be added to a Case Template. It lets you create a custom checklist for agents to follow and complete as they review each Case. You can define logic that governs when it appears.
How do you add a Case Checklist Module?
- Navigate to the Dashboard, and click on Cases > Templates.
- Find and click on the Case template you want to edit, or Create a new template.
- Navigate to the Tab you want to add a Case component to. Click an empty space to view the Component Library.
- In the right toolbar, search for ‘Checklist.’
- Drag and drop the Checklist module into your Case UI and reposition it by dragging it around.
- Click on the Checklist module on the right toolbar you can customize the module.
- Under Settings, you can edit the Title text to change the text displayed on the top of the module.
- Under Settings, add items to the Checklist by clicking the "Add item" button. Learn more about Add item below.
- Under Module Layout, you can change:
- Dynamic height: Module will grow or shrink to fit its contents.
- Visibility: Dynamically control whether the module is hidden. This is a toggle button that lets you set conditions for when the button should be displayed or hidden from view based on your case requirements. You can read more about Visibility configuration below.
- Under Advanced Options > Module Enablement, you can define custom control conditions that determine when the Checklist module is enabled or disabled. Advanced options are typically configured for specific customers by a Persona team member.
- Click the “Delete” button if you want to remove the component from the Case UI.
Add item
When the pop-up appears, provide the following information:
- Item description: A description of what needs to be checked
- Item key: A unique identifier used for updating checklist items through Persona's API
- Required for statuses: Define which case statuses require this item to be checked before proceeding. Cases can only transition to these statuses once this checklist item is marked complete.
- To move an items, click and drag the items to the desired position.
- To add an items, type the name of the desired field into the search bar and select the one you want to add.
- To remove a Field click the toggle button on the right.
Visibility configuration
If you toggle this on you will have two options to customize visibility.
- Basic visibility allows you to set rules on the Checklist module to determine when it will be visible. You can read more about Basic visibility configuration below.
- Advanced visibility allows you to set logic to control when the Checklist module is enabled or disabled based on custom conditions. Advanced options are typically configured for specific customers by a Persona team member.
Basic visibility configuration
Visibility configuration consist of three main components:
- Field: The object that will have a condition linked to it.
- Condition: How the field is compared to the value (e.g., equals, does not equal).
- Value: The value to test against.
Creating visibility configuration
- AND Statements: Combine multiple conditions that must all be true for the rule to pass. Add these using the "Add" button.
- OR Groups: Combine conditions where only one needs to be true for the rule to pass. Create these by clicking "Add OR Group".
How to use visibility configuration
- Click on the Checklist module, and go to Module Layout and toggle the button next to Visibility in the right toolbar.
- Click on “Empty rule” to see Visibility configuration.
- Create a logical rule by filling in the three boxes following Show if, which correspond to an object, its condition, and its value being assessed, respectively. When that logical rule passes, the Checklist module is shown.
- (Optional) Add additional logical rules by clicking either ”Add” (if you want to add 'AND' rules, where all must be passed to continue) or ”Or group” (if you can also nest a group of OR statements within an AND statement).
Plans Explained
Case Checklist module component by plan
Startup Program | Essential Plan | Growth Plan | Enterprise Plan | |
---|---|---|---|---|
Case Checklist module component | Limited | Limited | Available | Available |
Advanced options - Module enablement | Limited | Limited | Limited | Available |
Visibility - Advanced configurations | Limited | Limited | Limited | Available |