Message Auditor

Rocket.Chat's Message Auditor feature allows authorized users to audit messages and read conversations across a workspace. This can help organizations monitor internal communication and ensure appropriate behavior, especially in customer-facing scenarios.

To access the Audit Messages Panel, a user must:

Have the auditor role.
Be granted the Can Audit permission.

What can an Auditor do?

Auditors have the ability to:

Review messages in private rooms.
Review messages by specific users.
Review direct messages between users.
Inspect omnichannel conversations (e.g., customer support).
Check audit history using the Message Audit Logs.

Accessing the Audit Messages Panel

To access the panel:

Go to Administration > Audit > Messages.
Use the available tabs:
- Rooms: Search messages by channel.
- Users: Search messages by user.
- Direct Messages: Review private conversations.
- Omnichannel: View customer-agent interactions.

If you cannot access the panel, contact your workspace administrator to assign message auditing permissions to your account.

Search and review messages

You can search and filter messages using various fields:

Message – Enter keywords to filter content (leave blank to see all messages).
Date range – Set a custom start/end date or choose from presets like Today, Last Week, etc.
Channel Name – Enter the name of a specific room or channel.
Export PDF – Click to export filtered messages as a PDF document.

Searching by rooms/channel

To search for a specific message in a channel or room:

Enter a keyword or phrase in the Message field. Leave it empty to retrieve all messages.
Set the start and end dates to narrow results to a specific time period. Use the ⋮ (three-dots icon) to select preset ranges like Today, Last Week, etc.
Select the channel or room from the Channel Name drop-down menu.
Click Apply to display the filtered messages.
(Optional) Click Export PDF to download the results

Searching by users or direct messages

To search for messages sent by specific users:

Enter keywords or phrase in the Message field. Leave it empty to retrieve all messages.
Set the start and end dates to narrow results to a specific time period. Use the ⋮ (three-dots icon) to select preset ranges like Today, Last Week, etc.
In the Users field, type and select one or more users from the list.
Click Apply to display messages from the selected users that match the search criteria.
(Optional) Click Export PDF to download the results.

Searching by Omnichannel

Use the Omnichannel tab to search for conversations between agents and visitors:

Enter keywords or phrases in the Message field. Leave it empty to retrieve all messages.
Set the start and end dates to narrow results to a specific time period. Use the ⋮ (three-dots icon) to select preset ranges like Today, Last Week, etc.
In the Visitor field, enter the name of the contact or visitor.
In the Agent field, enter the name of the agent who handled the conversation.
Click Apply to view the matching Omnichannel conversations.
(Optional) Click Export PDF to download the results.

Assign auditing permissions

To access the Audit Messages feature, users must have a role with the appropriate auditing permission.

As a workspace administrator, you can assign Auditor permission to any role by enabling the Can Audit setting.

To assign message auditing permissions:

Navigate to Administration > Workspace > Permissions.
Under the role you want to grant access to, enable the Can Audit permission checkbox.

Once assigned, users with this permission can view and use the Audit Messages Panel.

In the following sub-sections, you can find more information about modifying your search results and checking the audit logs.