telnyx 5.170.0 → 5.173.0

data/lib/telnyx/resources/ai/assistants/deleted.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Assistants
+        # Configure AI assistant specifications
+        class Deleted
+          # List the organization's soft-deleted assistants in the Recently Deleted list.
+          #
+          # Each entry includes `deleted_at` and `permanently_deleted_at`, the point after
+          # which the assistant is erased automatically and can no longer be restored.
+          #
+          # @overload list(page_number: nil, page_size: nil, request_options: {})
+          #
+          # @param page_number [Integer] Page number to retrieve (1-based).
+          #
+          # @param page_size [Integer] Number of items to return per page.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Assistants::DeletedAssistant>]
+          #
+          # @see Telnyx::Models::AI::Assistants::DeletedListParams
+          def list(params = {})
+            parsed, options = Telnyx::AI::Assistants::DeletedListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "ai/assistants/deleted",
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              page: Telnyx::Internal::DefaultFlatPagination,
+              model: Telnyx::AI::Assistants::DeletedAssistant,
+              options: options
+            )
+          end
+
+          # Retrieve a soft-deleted assistant from the Recently Deleted list by
+          # `assistant_id`, including its `deleted_at` and `permanently_deleted_at`
+          # timestamps. This is a read-only view; the assistant cannot be modified while it
+          # remains deleted.
+          #
+          # @overload get(assistant_id, request_options: {})
+          #
+          # @param assistant_id [String] Unique identifier of the assistant.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::AI::Assistants::DeletedAssistant]
+          #
+          # @see Telnyx::Models::AI::Assistants::DeletedGetParams
+          def get(assistant_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["ai/assistants/%1$s/deleted", assistant_id],
+              model: Telnyx::AI::Assistants::DeletedAssistant,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/assistants/versions.rb

@@ -43,7 +43,7 @@ module Telnyx
           # Updates the configuration of a specific assistant version. Can not update main
           # version
           #
-          # @overload update(version_id, assistant_id:, a2a_agents: nil, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+          # @overload update(version_id, assistant_id:, a2a_agents: nil, avatar_settings: nil, conversation_flow: nil, delegation_settings: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, websocket_settings: nil, widget_settings: nil, request_options: {})
           #
           # @param version_id [String] Path param: Unique identifier of the version.
           #
@@ -51,8 +51,12 @@ module Telnyx
           #
           # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] Body param: A2A agents this assistant can delegate to. Tools are not stored here
           #
+          # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+          #
           # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Body param: Conversation flow as supplied by API clients (create / update).
           #
+          # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Body param: Splits the conversation between a frontend model that talks to the c
+          #
           # @param description [String] Body param
           #
           # @param dynamic_variables [Hash{Symbol=>Object}] Body param: Map of dynamic variables and their default values
@@ -99,7 +103,7 @@ module Telnyx
           #
           # @param tool_ids [Array<String>] Body param: IDs of shared tools to attach to the assistant. New integrations sho
           #
-          # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
+          # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
           #
           # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
           #
@@ -107,6 +111,8 @@ module Telnyx
           #
           # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings] Body param
           #
+          # @param websocket_settings [Telnyx::Models::AI::WebsocketSettings] Body param: Streams conversation and telephony events to a WebSocket server you
+          #
           # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -130,7 +136,10 @@ module Telnyx
           end
 
           # Retrieves all versions of a specific assistant with complete configuration and
-          # metadata
+          # metadata. An assistant keeps at most 10 versions, including the main version.
+          # When an update takes it past that limit, the oldest versions are permanently
+          # deleted. The main version and any version referenced by a traffic distribution
+          # rule are never deleted this way.
           #
           # @overload list(assistant_id, request_options: {})
           #

data/lib/telnyx/resources/ai/assistants.rb

@@ -33,13 +33,17 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Assistants::Instructions]
         attr_reader :instructions
 
+        # Configure AI assistant specifications
+        # @return [Telnyx::Resources::AI::Assistants::Deleted]
+        attr_reader :deleted
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
         # Creates a new AI assistant from the provided configuration, including its model,
         # instructions, and attached tools, and returns the created assistant.
         #
-        # @overload create(instructions:, name:, a2a_agents: nil, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, idempotency_key: nil, request_options: {})
+        # @overload create(instructions:, name:, a2a_agents: nil, avatar_settings: nil, conversation_flow: nil, delegation_settings: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, websocket_settings: nil, widget_settings: nil, idempotency_key: nil, request_options: {})
         #
         # @param instructions [String] Body param: System instructions for the assistant. These may be templated with [
         #
@@ -47,8 +51,12 @@ module Telnyx
         #
         # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] Body param: A2A agents this assistant can delegate to. Tools are not stored here
         #
+        # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+        #
         # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Body param: Conversation flow as supplied by API clients (create / update).
         #
+        # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Body param: Splits the conversation between a frontend model that talks to the c
+        #
         # @param description [String] Body param
         #
         # @param dynamic_variables [Hash{Symbol=>Object}] Body param: Map of dynamic variables and their default values
@@ -91,12 +99,14 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] Body param: IDs of shared tools to attach to the assistant. New integrations sho
         #
-        # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
+        # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Body param: Deprecated for new integrations. Inline tool definitions available t
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
         #
         # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings] Body param
         #
+        # @param websocket_settings [Telnyx::Models::AI::WebsocketSettings] Body param: Streams conversation and telephony events to a WebSocket server you
+        #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Body param: Configuration settings for the assistant's web widget.
         #
         # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
@@ -155,16 +165,23 @@ module Telnyx
         #
         # Updates the specified AI assistant's attributes and returns the updated
         # assistant. The request can also control how the change is promoted across
-        # assistant versions.
+        # assistant versions. Every update saves a new version, and an assistant keeps at
+        # most 10 versions: once it has more, the oldest versions are permanently deleted,
+        # except the main version and any version referenced by a traffic distribution
+        # rule.
         #
-        # @overload update(assistant_id, a2a_agents: nil, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @overload update(assistant_id, a2a_agents: nil, avatar_settings: nil, conversation_flow: nil, delegation_settings: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, websocket_settings: nil, widget_settings: nil, request_options: {})
         #
         # @param assistant_id [String] Unique identifier of the assistant.
         #
         # @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
         #
+        # @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #
         # @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
+        # @param delegation_settings [Telnyx::Models::AI::DelegationSettings] Splits the conversation between a frontend model that talks to the caller and a
+        #
         # @param description [String]
         #
         # @param dynamic_variables [Hash{Symbol=>Object}] Map of dynamic variables and their default values
@@ -213,7 +230,7 @@ module Telnyx
         #
         # @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
+        # @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         # @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
@@ -221,6 +238,8 @@ module Telnyx
         #
         # @param voice_settings [Telnyx::Models::AI::InferenceEmbeddingVoiceSettings]
         #
+        # @param websocket_settings [Telnyx::Models::AI::WebsocketSettings] Streams conversation and telephony events to a WebSocket server you host, and ac
+        #
         # @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -257,23 +276,45 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AssistantDeleteParams} for more details.
+        #
         # Delete an AI Assistant by `assistant_id`.
         #
-        # @overload delete(assistant_id, request_options: {})
+        # By default this performs a soft delete: the assistant moves to the Recently
+        # Deleted list and stays restorable for 30 days, after which it is permanently
+        # deleted automatically. The assistant's versions and TeXML application are
+        # preserved during the retention window.
+        #
+        # Pass `hard_delete=true` to skip the retention window and permanently delete the
+        # assistant immediately. A hard delete erases the assistant and all of its
+        # versions, and deletes its TeXML application unless phone numbers are still
+        # assigned to it. It does not delete conversations, recordings, shared tools the
+        # assistant referenced, or knowledge-base embeddings.
+        #
+        # Deletion fails with `400` if other assistants reference this one through a
+        # handoff tool or a conversation-flow edge — remove those references first.
+        #
+        # @overload delete(assistant_id, hard_delete: nil, request_options: {})
         #
         # @param assistant_id [String] Unique identifier of the assistant.
         #
+        # @param hard_delete [Boolean] Permanently delete the assistant immediately instead of soft-deleting it to the
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::AssistantDeleteResponse]
         #
         # @see Telnyx::Models::AI::AssistantDeleteParams
         def delete(assistant_id, params = {})
+          parsed, options = Telnyx::AI::AssistantDeleteParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
           @client.request(
             method: :delete,
             path: ["ai/assistants/%1$s", assistant_id],
+            query: query,
             model: Telnyx::Models::AI::AssistantDeleteResponse,
-            options: params[:request_options]
+            options: options
           )
         end
 
@@ -399,6 +440,30 @@ module Telnyx
           )
         end
 
+        # Restore a soft-deleted assistant from the Recently Deleted list.
+        #
+        # The assistant becomes fully active again with its versions and TeXML application
+        # as they were at deletion time. Restoring does not re-enable numbers or
+        # connections that were released separately after the deletion.
+        #
+        # @overload restore(assistant_id, request_options: {})
+        #
+        # @param assistant_id [String] Unique identifier of the assistant.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::InferenceEmbedding]
+        #
+        # @see Telnyx::Models::AI::AssistantRestoreParams
+        def restore(assistant_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["ai/assistants/%1$s/restore", assistant_id],
+            model: Telnyx::AI::InferenceEmbedding,
+            options: params[:request_options]
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::AssistantSendSMSParams} for more details.
         #
@@ -448,6 +513,57 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AssistantWhatsappParams} for more details.
+        #
+        # Start a WhatsApp conversation with a customer from the business side. This
+        # endpoint:
+        #
+        # 1. Validates that `from` is a WhatsApp number on your account whose messaging
+        #    profile has this assistant configured
+        # 2. Creates a new `whatsapp_chat` conversation with the provided metadata
+        # 3. Asks the assistant to pick one of its approved WhatsApp templates and fill
+        #    its variables from `content`
+        # 4. Sends the template from `from` to `to`
+        # 5. Returns the conversation ID and the message ID
+        #
+        # When the customer replies, the reply is routed to the same conversation and the
+        # assistant answers within the 24-hour customer service window. The assistant
+        # needs a `whatsapp_template` tool with at least one approved template, data
+        # retention enabled and PII redaction disabled.
+        #
+        # @overload whatsapp(assistant_id, content:, from:, to:, conversation_metadata: nil, idempotency_key: nil, request_options: {})
+        #
+        # @param assistant_id [String] Path param: Unique identifier of the assistant. Must be the assistant configured
+        #
+        # @param content [String] Body param: Instruction for the assistant, including the values for the template
+        #
+        # @param from [String] Body param: WhatsApp number on your account to send from, in E.164 format. Its m
+        #
+        # @param to [String] Body param: Customer to message, as an E.164 phone number or a WhatsApp business
+        #
+        # @param conversation_metadata [Hash{Symbol=>String, Integer, Boolean}] Body param: Metadata stored on the conversation. Keys starting with `telnyx_` an
+        #
+        # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AssistantWhatsappResponse]
+        #
+        # @see Telnyx::Models::AI::AssistantWhatsappParams
+        def whatsapp(assistant_id, params)
+          parsed, options = Telnyx::AI::AssistantWhatsappParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
+          @client.request(
+            method: :post,
+            path: ["ai/assistants/%1$s/chat/whatsapp", assistant_id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Telnyx::Models::AI::AssistantWhatsappResponse,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Telnyx::Client]
@@ -460,6 +576,7 @@ module Telnyx
           @versions = Telnyx::Resources::AI::Assistants::Versions.new(client: client)
           @tags = Telnyx::Resources::AI::Assistants::Tags.new(client: client)
           @instructions = Telnyx::Resources::AI::Assistants::Instructions.new(client: client)
+          @deleted = Telnyx::Resources::AI::Assistants::Deleted.new(client: client)
         end
       end
     end

data/lib/telnyx/resources/ai/avatars.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      # Create and manage real-time AI avatars
+      class Avatars
+        # Uploads an image, validates its file type, size, safe decoding, and resolution,
+        # stores it in Telnyx-managed private storage, and creates an avatar owned by the
+        # authenticated organization. Creating an avatar does not update an AI Assistant;
+        # use the returned ID separately wherever the avatar is consumed. The avatar image
+        # is stored independently from the rendering model and background, which are
+        # selected where the avatar is consumed. Supported image types are JPEG, PNG, and
+        # WebP. Images may be up to 10 MiB, must be between 256 and 8192 pixels on each
+        # side, and may contain at most 40 megapixels. A per-organization custom-avatar
+        # quota applies; the create request returns an error when the quota is reached.
+        # For best results, use a 16:9 landscape image, preferably 1920 by 1080 pixels and
+        # at least 1280 by 720 pixels. Show one centered, front-facing person from the
+        # shoulders up, keep the full head and hair visible with space around it, and use
+        # a sharp, evenly lit image with unobstructed eyes and mouth. Use a transparent
+        # PNG or WebP when the avatar will be combined with a selectable background. These
+        # composition recommendations are not enforced in the first release; the first
+        # release does not validate the number of faces, pose, or image content.
+        #
+        # @overload create(image_file:, name:, request_options: {})
+        #
+        # @param image_file [Pathname, StringIO, IO, String, Telnyx::FilePart] JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        # @param name [String] Customer-facing name of the custom avatar.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarCreateParams
+        def create(params)
+          parsed, options = Telnyx::AI::AvatarCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "ai/avatars",
+            headers: {"content-type" => "multipart/form-data"},
+            body: parsed,
+            model: Telnyx::AI::AvatarResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AvatarRetrieveParams} for more details.
+        #
+        # Returns a Telnyx stock avatar or a custom avatar owned by the authenticated
+        # organization. A custom avatar belonging to another organization is returned as
+        # not found.
+        #
+        # @overload retrieve(avatar_id, request_options: {})
+        #
+        # @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarRetrieveParams
+        def retrieve(avatar_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["ai/avatars/%1$s", avatar_id],
+            model: Telnyx::AI::AvatarResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::AI::AvatarUpdateParams} for more details.
+        #
+        # Updates the customer-facing name of a custom avatar owned by the authenticated
+        # organization. Stock avatars cannot be modified. To replace the image, create a
+        # new custom avatar so existing references keep their original content.
+        #
+        # @overload update(avatar_id, name:, request_options: {})
+        #
+        # @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        # @param name [String] New customer-facing name of the custom avatar.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::AI::AvatarResponse]
+        #
+        # @see Telnyx::Models::AI::AvatarUpdateParams
+        def update(avatar_id, params)
+          parsed, options = Telnyx::AI::AvatarUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["ai/avatars/%1$s", avatar_id],
+            body: parsed,
+            model: Telnyx::AI::AvatarResponse,
+            options: options
+          )
+        end
+
+        # Returns a paginated list of the Telnyx stock avatars and custom avatars
+        # available to the authenticated organization. Custom avatars owned by other
+        # organizations are never returned. The `image_url` value is suitable for
+        # displaying a thumbnail and may be refreshed by listing or retrieving the avatar
+        # again. `suggested_voice_id` recommends a compatible Telnyx voice for stock
+        # avatars and is an empty string for custom avatars; it does not change an AI
+        # Assistant's voice automatically.
+        #
+        # @overload list(filter_avatar_type: nil, filter_id: nil, filter_name: nil, page_number: nil, page_size: nil, request_options: {})
+        #
+        # @param filter_avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Return only stock or custom avatars.
+        #
+        # @param filter_id [String] Return the avatar with this exact ID.
+        #
+        # @param filter_name [String] Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        # @param page_number [Integer] Page number to retrieve, starting at 1.
+        #
+        # @param page_size [Integer] Number of avatars to return per page.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Avatar>]
+        #
+        # @see Telnyx::Models::AI::AvatarListParams
+        def list(params = {})
+          parsed, options = Telnyx::AI::AvatarListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "ai/avatars",
+            query: query.transform_keys(
+              filter_avatar_type: "filter[avatar_type]",
+              filter_id: "filter[id]",
+              filter_name: "filter[name]",
+              page_number: "page[number]",
+              page_size: "page[size]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::AI::Avatar,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/conversations.rb

@@ -109,7 +109,7 @@ module Telnyx
         # can filter on any field in the metadata JSON object. For example, to filter by a
         # custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.
         #
-        # @overload list(id: nil, created_at: nil, last_message_at: nil, limit: nil, metadata_assistant_id: nil, metadata_call_control_id: nil, metadata_telnyx_agent_target: nil, metadata_telnyx_conversation_channel: nil, metadata_telnyx_end_user_target: nil, name: nil, or_: nil, order: nil, request_options: {})
+        # @overload list(id: nil, created_at: nil, last_message_at: nil, limit: nil, metadata_assistant_id: nil, metadata_assistant_version_id: nil, metadata_call_control_id: nil, metadata_telnyx_agent_target: nil, metadata_telnyx_conversation_channel: nil, metadata_telnyx_end_user_target: nil, name: nil, or_: nil, order: nil, request_options: {})
         #
         # @param id [String] Filter by conversation ID (e.g. id=eq.123)
         #
@@ -121,6 +121,8 @@ module Telnyx
         #
         # @param metadata_assistant_id [String] Filter by assistant ID (e.g., `metadata->assistant_id=eq.assistant-123`)
         #
+        # @param metadata_assistant_version_id [String] Filter by assistant version ID (e.g., `metadata->assistant_version_id=eq.2025081
+        #
         # @param metadata_call_control_id [String] Filter by call control ID (e.g., `metadata->call_control_id=eq.v3:123`)
         #
         # @param metadata_telnyx_agent_target [String] Filter by the phone number, SIP URI, or other identifier for the agent (e.g., `m
@@ -148,6 +150,7 @@ module Telnyx
             path: "ai/conversations",
             query: query.transform_keys(
               metadata_assistant_id: "metadata->assistant_id",
+              metadata_assistant_version_id: "metadata->assistant_version_id",
               metadata_call_control_id: "metadata->call_control_id",
               metadata_telnyx_agent_target: "metadata->telnyx_agent_target",
               metadata_telnyx_conversation_channel: "metadata->telnyx_conversation_channel",

data/lib/telnyx/resources/ai/memory/namespaces/profiles.rb

@@ -123,6 +123,47 @@ module Telnyx
               )
             end
 
+            # Some parameter documentations has been truncated, see
+            # {Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewParams} for more details.
+            #
+            # Try a candidate note on one profile and see how that profile's summary would
+            # read under it, without saving the note and without touching the stored summary.
+            # Composes the same source query the apply path
+            # (`PATCH /ai/memory/namespaces/{namespace}/settings`) would use, so a preview
+            # cannot drift from what saving the note would produce. Reads the candidate alone
+            # -- the namespace's current instructions and the profile's stored summary are
+            # neither read nor replaced. Bounded at 120 seconds: the summary is generated on
+            # the spot rather than read from a stored one. Nothing about the request is
+            # stored.
+            #
+            # @overload preview(profile_id, namespace:, instructions: nil, request_options: {})
+            #
+            # @param profile_id [String] Path param: The profile: your identifier for the user, caller or agent this memo
+            #
+            # @param namespace [String] Path param: The namespace. `default` exists for every organization.
+            #
+            # @param instructions [String, nil] Body param: The candidate note to try. `null`, empty, or whitespace-only preview
+            #
+            # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewResponse]
+            #
+            # @see Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewParams
+            def preview(profile_id, params)
+              parsed, options = Telnyx::AI::Memory::Namespaces::ProfilePreviewParams.dump_request(params)
+              namespace =
+                parsed.delete(:namespace) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              @client.request(
+                method: :post,
+                path: ["ai/memory/namespaces/%1$s/profiles/%2$s/summary/preview", namespace, profile_id],
+                body: parsed,
+                model: Telnyx::Models::AI::Memory::Namespaces::ProfilePreviewResponse,
+                options: options
+              )
+            end
+
             # Ranked memories for a question. Matching runs over the profile's memories and
             # returns them in rank order with a relevance `score`; the score is null where the
             # deployment's reranker is a passthrough, in which case order is the only signal.