# Chat History (1-on-1)

### Overview

The **Private Chat History** feature in MangoApps allows network administrators to view and export one-on-one chat conversations between two users. This ensures organizations can maintain visibility, security, and compliance for direct user communications.

<figure><img src="/files/sb7r1cuRudPT4V0LYdEk" alt="" width="563"><figcaption></figcaption></figure>

***

### Key Capabilities

**View One-on-One Chats**\
Admins can access private chats between any two users (including employees, admins, and guest accounts) directly from the **Admin Portal**.

**Filter by Date Range**\
Select from preset options (Today, Yesterday, Last 7 Days, Last 30 Days) or choose a **Custom Date Range** to narrow results.

**Detailed Chat Display**\
Chats appear in a familiar conversation-style layout, including:

* Message sender name
* Date and timestamp
* Full message text
* Attachments (links only, files are not displayed)
* Reactions and important/read receipt tags

**Export to CSV**\
Admins can export up to **10,000 chat messages** in CSV format for offline review or compliance reporting. The export includes user details, timestamps, and message content.

***

### Viewing Chat History

Use the **User Selection** fields to choose the two participants.

* Begin typing a name and select from the dropdown.
* Both fields must contain different users.

Select a **Date Range** from the dropdown or set custom “From” and “To” dates.

Click **Submit** to load the filtered chat results.

If no messages match the filters, an empty state will appear with the message: “No chats match the selected criteria. Please adjust the filters to view available chats.”

***

### Compliance and Permissions

* This feature is available **only to network/domain admins**.
* Access must be **enabled by your Customer Success Manager (CSM) or Technical Account Manager (TAM)**.
* Admins can view and export messages, but cannot open file attachments.

***

### Example Use Cases

* **Compliance Audits**: Ensure private communications meet industry regulations.
* **Investigations**: Review message trails between specific users during HR or security inquiries.
* **Data Retention**: Export records to meet organizational or legal record-keeping requirements.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/admin-guide/module-settings/chats/chat-history-1-on-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.