# `Twilio.Conversations.V2.ConversationService`
[🔗](https://github.com/jeffhuen/twilio_elixir/blob/main/lib/twilio/conversations/v2/conversation_service.ex#L2)

Service for Conversation API operations.

Operations: `list`, `create`, `fetch`, `delete`

# `create`

```elixir
@spec create(Twilio.Client.t(), map(), keyword()) ::
  {:ok, Twilio.Resources.Conversations.V2.Conversation.t()}
  | {:ok, map(), map()}
  | :ok
  | {:error, Twilio.Error.t()}
```

Create a new conversation

Operation: `CreateConversationWithConfig` | Tags: ConversationsV2Conversation

## Required Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `configurationId` | string | The ID of an existing configuration. |
## Optional Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `configuration` | object | Conversation configuration settings. |
| `name` | string | The name of the conversation. |
| `participants` | array | Optional list of Participants to create with the Conversation. |

# `delete`

```elixir
@spec delete(Twilio.Client.t(), String.t(), keyword()) ::
  {:ok, map()} | {:ok, map(), map()} | :ok | {:error, Twilio.Error.t()}
```

Asynchronously delete a conversation and all associated data.
Returns 202 Accepted with an Operation-Id for status tracking via GET /v2/ControlPlane/Operations/{operationId}.

Operation: `DeleteConversationAsync` | Tags: ConversationsV2Conversation

# `fetch`

```elixir
@spec fetch(Twilio.Client.t(), String.t(), keyword()) ::
  {:ok, Twilio.Resources.Conversations.V2.Conversation.t()}
  | {:ok, map(), map()}
  | :ok
  | {:error, Twilio.Error.t()}
```

Retrieve a Conversation.

Operation: `FetchConversation` | Tags: ConversationsV2Conversation

# `list`

```elixir
@spec list(Twilio.Client.t(), map(), keyword()) ::
  {:ok, Twilio.Page.t()}
  | {:ok, map(), map()}
  | :ok
  | {:error, Twilio.Error.t()}
```

Retrieve a list of Conversations.

Operation: `ListConversationByAccount` | Tags: ConversationsV2Conversation

## Query Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `status` | array | Filters for specific statuses |
| `channelId` | string | The resource identifier (such as callSid or messageSid) to filter conversations. |
| `pageSize` | integer | Maximum number of items to return in a single response |
| `pageToken` | string | A URL-safe, base64-encoded token representing the page of results to return |

# `stream`

```elixir
@spec stream(Twilio.Client.t(), map(), keyword()) :: Enumerable.t()
```

Stream: Retrieve a list of Conversations. (lazy auto-pagination).

---

*Consult [api-reference.md](api-reference.md) for complete listing*