Twilio.Conversations.V2.ConversationService (twilio_elixir v0.1.3)

Copy Markdown View Source

Service for Conversation API operations.

Operations: list, create, fetch, delete

Summary

Functions

Create a new conversation

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

Retrieve a Conversation.

Retrieve a list of Conversations.

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

Functions

create(client, params \\ %{}, opts \\ [])

@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

ParameterTypeDescription
configurationIdstringThe ID of an existing configuration.

Optional Parameters

ParameterTypeDescription
configurationobjectConversation configuration settings.
namestringThe name of the conversation.
participantsarrayOptional list of Participants to create with the Conversation.

delete(client, sid, opts \\ [])

@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(client, sid, opts \\ [])

@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(client, params \\ %{}, opts \\ [])

@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

ParameterTypeDescription
statusarrayFilters for specific statuses
channelIdstringThe resource identifier (such as callSid or messageSid) to filter conversations.
pageSizeintegerMaximum number of items to return in a single response
pageTokenstringA URL-safe, base64-encoded token representing the page of results to return

stream(client, params \\ %{}, opts \\ [])

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

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