Contoso Live Chat App

A simple live chat application designed as mock live agent handover scenarios with Copilot Studio. This application simulates a live chat support system that can receive conversations from Copilot Studio and send messages back.

Project Structure

ContosoLiveChatApp/
├── Controllers/
│   └── ChatController.cs          # API endpoints for chat operations (used by Copilot Studio agent)
├── Models/
│   └── ChatMessage.cs             # Chat message data model
├── Services/
│   ├── ChatStorageService.cs      # Conversation-based message storage
│   └── WebhookService.cs          # Outgoing webhook sender (send messages to Copilot Studio agent)
├── wwwroot/
│   └── index.html                 # Chat UI with conversation management
├── Program.cs                     # Application entry point
├── appsettings.json              # Configuration (webhook URL)

Configuration

Configure the webhook URL in appsettings.json:

{
  "WebhookSettings": {
    "OutgoingWebhookUrl": "http://localhost:5001/api/livechat/messages"
  }
}

This endpoint points to the Copilot Studio agent skill URL. The default configuration assumes the HandoverToLiveAgentSample is running on port 5001.

Running the Application

Navigate to the project directory:

cd CopilotStudioSamples\HandoverToLiveAgent\ContosoLiveChatApp

Restore dependencies and run:
```
dotnet run
```
Open your browser and navigate to:
```
http://localhost:5000
```

API Endpoints

Method	Endpoint	Description
`POST`	`/api/chat/start`	Start a new conversation, returns `conversationId`
`GET`	`/api/chat/messages?conversationId={id}`	Get messages for a conversation
`POST`	`/api/chat/send`	Send message to Copilot Studio via webhook
`POST`	`/api/chat/receive`	Receive message from Copilot Studio
`POST`	`/api/chat/end`	End conversation and clear from memory

Architecture

API Flow

sequenceDiagram
    participant CS as Copilot Studio
    participant API as Chat API
    participant Storage as ChatStorageService
    participant UI as Live Chat UI
    
    CS->>API: POST /api/chat/start
    API-->>CS: conversationId
    
    Note over API,Storage: Conversation Active
    
    CS->>API: POST /api/chat/receive (from MCS)
    API->>Storage: Store message
    Storage-->>UI: Display message
    
    UI->>API: POST /api/chat/send (message)
    API->>Storage: Store message
    API->>CS: Forward via webhook (to MCS)
    CS-->>UI: Message delivered
    
    Note over CS,UI: Messages exchanged...
    
    CS->>API: POST /api/chat/end
    API->>Storage: Clear conversation
    API-->>CS: Conversation ended