# ASP.NET Core Chat Overview

> Starting with version 2025.3.825, the Chat component has been completely redesigned. The API is updated accordingly to support the newly introduced features.

The Telerik UI Chat TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI Chat widget. To add the component to your ASP.NET Core app, you can use either.

The Chat component delivers a modern conversational interface designed to enhance user interaction and communication within web applications. It facilitates seamless communication between users, chatbots, and AI-powered systems through an intuitive and highly customizable interface. The component offers extensive functionality, including message threading, file attachments, user avatars, quick action suggestions, and comprehensive accessibility support. Built with flexibility in mind, it enables easy integration with various messaging services, machine learning models, and custom business workflows to meet diverse application requirements.

* [Demo page for the Chat](https://demos.telerik.com/aspnet-core/chat/index)

## Initializing the Chat

The following example demonstrates how to define a Chat.

```Razor HtmlHelper
    @(Html.Kendo().Chat()
        // The name of the Chat is mandatory.
        // It specifies the "id" and the "name" attributes of the widget.
        .Name("chat")
        .Height("600px")
        .Width("400px")
        .AuthorId("1")
    )
```

```Razor TagHelper
@addTagHelper *, Kendo.Mvc

<kendo-chat name="chat"
    width="400"
    height="600"
    author-id="1">
</kendo-chat>
```

## Basic Configuration

The following example demonstrates how to define header items, predefined suggestions, and configure attachments and message actions.

```Razor HtmlHelper
@(Html.Kendo().Chat()
    .Name("chat")
    .HeaderItems(items => {
        items.Add().Type(AppBarItemType.ContentItem).Template("<strong>Customer Support Chat</strong>");
        items.Add().Type(AppBarItemType.Spacer);
        items.Add().Type(AppBarItemType.ContentItem).Template("<button>Export</button>");
    })
    .FileActions(actions =>
    {
        actions.Add().Name("download").Text("Download").Icon("download");
    })
    .MessageToolbarActions(actions =>
    {
        actions.Add().Name("settings").Icon("gear");
        actions.Add().Name("share").Icon("share");
    })
    .MessageActions(actions =>
    {
        actions.Add().Name("copy").Text("Copy").Icon("copy");
        actions.Add().Name("pin").Text("Pin").Icon("pin");
        actions.Add().Name("delete").Text("Delete").Icon("trash");
    })
    .Suggestions(suggestions => {
        suggestions.Add().Text("Analyse a file");
        suggestions.Add().Text("Generate a cover letter");
    })
)
```

```Razor TagHelper
@addTagHelper *, Kendo.Mvc

<kendo-chat name="chat">
    <header-items>
        <header-item type="AppBarItemType.ContentItem" template="<strong>Customer Support Chat</strong>"/>
        <header-item type="AppBarItemType.Spacer"/>
        <header-item type="AppBarItemType.ContentItem" template="<button>Export</button>"/>
    </header-items>
    <file-actions>
        <file-action name="download" text="Download" icon="download" />
    </file-actions>
    <message-toolbar-actions>
        <message-toolbar-action name="settings" icon="gear" />
        <message-toolbar-action name="share" icon="share" />
    </message-toolbar-actions>
    <message-actions>
        <message-action name="copy" text="Copy" icon="copy" />
        <message-action name="pin" text="Pin" icon="pin" />
        <message-action name="delete" text="Delete" icon="trash" />
    </message-actions>
    <suggestions>
        <suggestion text="Analyse a file" />
        <suggestion text="Generate a cover letter" />
    </suggestions>
</kendo-chat>
```

## Functionality and Features

| Feature                                                                                                                                   | Description                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Data Binding](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/binding/overview)                 | Bind the Chat to either a local data collection or to data retrieved from a remote endpoint.                                                                                                                                                                  |
| [AI Integration](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/ai-integration)                 | Configure the Chat to interact with a large language model through a streaming AI chat service.                                                                                                                                                               |
| [Tools](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/tools)                                   | Utilize the available context menu actions and toolbar commands.                                                                                                                                                                                              |
| [File Uploads and Media](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/file-uploads-and-media) | Enable file uploads, media sharing, and speech-to-text functionality of the Chat component.                                                                                                                                                                   |
| [Adornments](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/adornments)                         | Configure start, end, and top PromptBox adornments to place custom controls around the input area.                                                                                                                                                            |
| [AutoScroll Threshold](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/autoscroll-threshold)     | Configure the bottom-zone threshold that controls when incoming messages auto-scroll into view.                                                                                                                                                               |
| [Quick Actions](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/suggestions)                     | Define quick response suggestions that appear above the message box.                                                                                                                                                                                          |
| [Templates](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/templates)                           | Use template options to customize the rendering of the messages, attachments, quick actions, and more.                                                                                                                                                        |
| [Peer-to-Peer Chat](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/signalr-p-to-p)              | Create a peer-to-peer Chat application using SignalR.                                                                                                                                                                                                         |
| [Events](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/events)                                 | Subscribe to the available client-side events to implement any custom logic.                                                                                                                                                                                  |
| [Accessibility](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/accessibility/overview)          | The Chat is accessible for screen readers, supports WAI-ARIA attributes, and delivers [keyboard shortcuts](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/accessibility/keyboard-navigation) for faster navigation. |

## Next Steps

* [Getting Started with the Chat](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/getting-started)

* [Basic Usage of the Chat for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/chat/)

* [Chat in Razor Pages](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/conversational-ui/chat/binding/razor-page)

## See Also

* [Using the API of the Chat (Demo)](https://demos.telerik.com/aspnet-core/chat/api)

* [Server-Side API of the Chat HtmlHelper](https://www.telerik.com/aspnet-core-ui/documentation/api/chat)

* [Server-Side API of the Chat TagHelper](https://www.telerik.com/aspnet-core-ui/documentation/api/taghelpers/chat)

* [Client-Side API of the Chat](https://docs.telerik.com/kendo-ui/api/ui/chat)
