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

# Chat agents

> Run a customer conversation with incremental responses over HTTP.

## Overview

Connect your own chat interface to a Voiceflow agent. Create a session, send customer messages as actions and render the returned traces. HTTP Streaming (SSE) lets the interface update while the agent generates its response.

Use this path for text conversations with messages, cards and choices. For microphone input, agent audio and live interruption handling, use [Voice](/docs/api-reference/agent-runtime/voice).

## Start a chat conversation

### 1. Create a session

Obtain your [project ID](/docs/cookbook/find-your-project) and [API credential](/docs/api-reference/authentication). On your server, call [Create a session](/docs/api-reference/v4interact/start-session-specific-environment#rest-session) for a chosen Environment, or use the project's traffic split. Retain the returned `sessionKey`; keep the project credential out of browser code.

### 2. Send an action

Use the session key to authenticate [Sending actions](/docs/api-reference/v4interact/interact-non-stream#streaming-action). Send `launch` once, then `text` for later customer messages. Streaming requests can also set session variables.

### 3. Render the response

Parse complete [SSE events](/docs/api-reference/agent-runtime/chat/responses) and dispatch each trace to its interface handler. Wait for the SSE event named `end` before considering delivery complete.

## Implementation references

<a id="chat-agent-apis-reference" />

- [**Sessions**](/docs/api-reference/v4interact/start-session-specific-environment) — identity, Environment routing, creation operations and continued conversations.
- [**Sending actions**](/docs/api-reference/v4interact/interact-non-stream) — Streaming requests and the non-streaming HTTP alternative.
- [**Handling responses**](/docs/api-reference/agent-runtime/chat/responses) — SSE framing, messages, controls and exact trace payloads.
- [**Events and diagnostics**](/docs/api-reference/agent-runtime/chat/events) — generated-text events, tool activity, logs and custom actions.
- [**Errors and recovery**](/docs/api-reference/agent-runtime/chat/recovery) — interrupted delivery and safe action recovery.
- [**Human agent hand-off**](/docs/api-reference/agent-runtime/chat/handoff) — Socket.IO updates, message relay and Custom Handoff callback contracts.

## Build and manage the agent

Use [Platform APIs](/docs/api-reference/api-overview) to configure the agent, its Knowledge and tools, and publish changes. For spoken conversations, use [Voice agents](/docs/api-reference/agent-runtime/voice).
