> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuraltalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 💬 Live Chat

> Complete guide to managing live chat sessions and providing real-time human support

🎥 Refer to the setup video for a step-by-step visual guide:

<div
  style={{
position: "relative",
paddingBottom: "56.25%", // 16:9 aspect ratio
height: 0,
marginTop: "16px",
borderRadius: "14px",
overflow: "hidden",
}}
>
  <iframe
    src="https://www.youtube.com/embed/je7E8NNA3wo?si=nVJKAgtObE4SfvrE"
    title="Live Chat"
    frameBorder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
    allowFullScreen
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  borderRadius: "14px",
}}
  />
</div>

## Overview

The **Live Chat** feature enables your team to manage real-time chat sessions and provide instant human support to users. It allows agents to monitor chat status, filter sessions, and actively respond to users when immediate assistance is required.

This guide explains how to access live chats, filter sessions, and manage live conversations effectively.

## Accessing Live Chat

<Steps>
  <Step title="Open the Dashboard">
    * Log in to your dashboard
    * Navigate to **Live Chat** from the main menu
  </Step>

  <Step title="View Live Chat Sessions">
    * The Live Chat page loads with available chat sessions
    * Sessions are listed based on selected filters and date range
  </Step>
</Steps>

<img src="https://mintcdn.com/neuraltalk/AQvs9ZJbqv8QqisP/images/liveChatDashboard.png?fit=max&auto=format&n=AQvs9ZJbqv8QqisP&q=85&s=861ad001ae22b849f5bcc2e7d9cc2a5d" alt="Live Chat Dashboard" width="1675" height="694" data-path="images/liveChatDashboard.png" />

## Live Chat Overview

The Live Chat is divided into multiple sections to help you manage conversations efficiently.

### Search & Controls

Use the top controls to refresh and search chat sessions.

* **Refresh**: Click **Refresh** to reload the latest live chat sessions and statuses.

* **Search by Session ID**: Quickly locate a specific live chat by entering its unique session ID.

### Status Filters

Filter live chat sessions based on their current status.

* **All Status**: Displays all live chat sessions regardless of state.

* **Pending**: Chats waiting for a human agent to join.

* **Active**: Chats currently being handled by a human agent.

* **Ended**: Chats that have been completed.

* **Cancelled**: Chats that were cancelled before completion.

### Chatbot Filters

If multiple chatbots are enabled, you can filter sessions by chatbot.

* **All Chatbots**: View live chats from all chatbots.

* **Specific Chatbot**: Filter chats by selecting a specific chatbot.

## Date Range Filtering

Filter live chat sessions by time period.

### Quick Date Filters

<CardGroup cols={2}>
  <Card title="Today" icon="calendar">
    View chats from today.
  </Card>

  <Card title="Yesterday" icon="calendar-minus">
    View chats from yesterday.
  </Card>

  <Card title="This Week" icon="calendar-range">
    View chats from the current week.
  </Card>

  <Card title="This Month" icon="calendar">
    View chats from the current month.
  </Card>
</CardGroup>

### Custom Date Range

* **Select Date Range**: Choose **Start Date** and **End Date**.

* **Apply or Clear**:
  * Click **Apply** to filter sessions
  * Click **Clear** to reset filters

## Live Chat Sessions List

The left panel displays all chat sessions based on applied filters.

Each session shows:

* Message preview
* Date and time
* Current status (Pending, Active, Ended, Cancelled)

## Starting a Live Chat

To begin responding to a user:

1. Select a chat session from the list
2. Click on the session to open messaging

If no chat is selected, you’ll see:\
**Select a chat to start messaging**

## Chat Details

The right panel displays chat-related information.

* **Live Messages**: View and respond to messages in real time.

* **Chat Details**: View session details such as status, timestamps, and chatbot information.

## Best Practices

* Regularly refresh to view new pending chats
* Prioritize **Pending** chats to reduce response time
* Use chatbot filters in multi-bot environments
* Review ended chats for training and quality improvement
