# Conversations

The Conversations API is the core interface for managing AI-powered interactions on the Amigo platform.

## Overview

Conversations are the primary way users interact with Amigo agents. Each conversation maintains context, manages state, and handles the flow of messages between users and the AI.

## API Endpoints

### Conversation Management

* [**Create**](/developer-guide/classic-api/core-api/conversations/conversations-create.md): `POST /conversations`, initialize new conversations with agents
* [**Starters**](/developer-guide/classic-api/core-api/conversations/conversations-starters.md): `POST /conversation/conversation_starter`, generate contextual conversation starters
* [**Interact**](/developer-guide/classic-api/core-api/conversations/conversations-interact.md): `POST /conversations/{id}/messages`, send messages and receive AI responses
* [**Events**](/developer-guide/classic-api/core-api/conversations/conversations-events.md): `GET /conversations/{id}/events`, stream real-time conversation events
* [**Lifecycle**](/developer-guide/classic-api/core-api/conversations/conversations-lifecycle.md): `PATCH /conversations/{id}`, manage conversation states and completion
* [**Voice**](/developer-guide/classic-api/core-api/conversations/conversations-voice.md): `POST /conversations/{id}/voice`, enable voice interactions
* [**Real-time Voice**](/developer-guide/classic-api/core-api/conversations/conversations-realtime.md): `WSS /conversation/converse_realtime`, WebSocket endpoint for real-time voice conversations

## Key Features

* **Contextual Memory**: conversations keep context across multiple interactions.
* **Multi-modal Support**: text, voice, and structured data inputs.
* **Real-time Streaming**: server-sent events for live updates.
* **WebSocket Support**: low-latency bidirectional communication for real-time voice.
* **Voice Activity Detection**: automatic speech detection in real-time mode.
* **State Management**: track and control conversation flow.
* **Voice Integration**: voice-to-text and text-to-voice.
* **Automatic Audio Fillers**: handles perceived latency during voice interactions.

## Common Use Cases

1. **Customer Support**: automated support conversations with context awareness.
2. **Virtual Assistants**: personal AI assistants with memory and learning.
3. **Interactive Workflows**: guide users through complex processes.
4. **Voice Interfaces**: natural language voice interactions.

## Quick Start

```javascript
// Create a new conversation
const conversation = await amigo.conversations.create({
  agent_id: "agent_123",
  user_id: "user_456"
});

// Send a message
const response = await amigo.conversations.interact(conversation.id, {
  message: "Hello, I need help with my order"
});

// Listen for events
const events = amigo.conversations.events(conversation.id);
events.on('message', (data) => {
  console.log('New message:', data);
});
```

## Related Documentation

* [Authentication](/developer-guide/getting-started/authentication.md)
* [SDK Reference](/developer-guide/classic-api/sdks.md)
* [Conversation History](/developer-guide/classic-api/core-api/conversations/conversation-history.md)


---

# 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://docs.amigo.ai/developer-guide/classic-api/core-api/conversations.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.