Skip to main content

Read Receipts

To ensure accountability and provide a clear audit trail, the Case Status integration with Litify includes a Read Receipt system. This automation tracks exactly when a message was seen and by whom, distinguishing between your clients and your internal staff.

By recording these interactions, your firm gains visibility into client engagement and ensures that critical updates are being acknowledged by the legal team.


How Read Receipts Work

The Case Status - Message Read Receipt flow is a background process that monitors updates to the Case Status Message object. Whenever the system detects that a message has been opened, it creates a permanent record in the Message Read (CS_Message_Read__c) object.

Key Features of the System

  • Identity Resolution: The flow automatically identifies if the reader is a Client (based on the linked Party record) or a Staff Member (by matching the name against your Salesforce User list).

  • Duplicate Prevention: To keep your data clean, the system performs an "Idempotency Check." It will only create one receipt per person per message. If a client opens the same message five times, only the first "read" is recorded.

  • Error Transparency: If a staff member reads a message but their name doesn't perfectly match a Salesforce User, the system creates a log entry so your Admin can resolve the discrepancy.

NOTE:

To mark a message as read in Case Status, it must be opened in the Case Status Communicator Interface, or the Litify interface. Messages can be manually marked as read from app.casestatus.com.


Execution Paths

When a message is updated with read information, the flow branches into two paths:

Path A: Client Reads

  1. Verifies the reader is a Client.

  2. Checks for an existing receipt for that specific Client + Message pair.

  3. If no receipt exists, it creates one, stamping the CS_Read_Time__c.

Path B: Staff Reads

  1. Verifies the reader is a Staff member.

  2. Searches for a Salesforce User whose name matches the Read_By__c field.

  3. Checks for an existing receipt for that specific Staff Member + Message pair.

  4. If no receipt exists, it creates one.


Testing & Quality Assurance

Administrators can verify the health of the Read Receipt system using the following test cases:

Scenario

Action

Expected Result

First Client Read

Update a message with Read_At__c and Reader_Type__c = "Client".

A new CS_Message_Read__c record is created.

Duplicate Client Read

Perform the same update again on the same message.

No new record is created (duplicate prevented).

Staff Read (Match)

Update a message with a Read_By__c value that matches a Salesforce User Name.

A new receipt is created and linked to that User's ID.

Staff Read (No Match)

Update with a Read_By__c value that does not exist in Salesforce.

No receipt created; error logged in the Case_Status_Log_Error object.


Administrative Guardrails

  • User Name Consistency: Because staff receipts rely on a Name Match, ensure your Salesforce User names match the display names used in the Case Status platform.

  • Audit Trail: These receipts are stored in a related list on the Message record, providing a complete history for compliance and client service reviews.

  • Security: The flow requires "Read" access to User records and "Create" access to the Message Read object for the integration user.

Did this answer your question?