elevenlabs_client 0.6.0 → 0.8.0

data/lib/elevenlabs_client/endpoints/agents_platform/conversations.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Endpoints
+    module AgentsPlatform
+      class Conversations
+        def initialize(client)
+          @client = client
+        end
+
+        # GET /v1/convai/conversations
+        # Get all conversations of agents that user owns
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/list
+        #
+        # @param options [Hash] Query parameters
+        # @option options [String] :cursor Used for fetching next page
+        # @option options [String] :agent_id The id of the agent to filter by
+        # @option options [String] :call_successful The result of the success evaluation ("success", "failure", "unknown")
+        # @option options [Integer] :call_start_before_unix Unix timestamp to filter conversations up to this start date
+        # @option options [Integer] :call_start_after_unix Unix timestamp to filter conversations after this start date
+        # @option options [String] :user_id Filter conversations by the user ID who initiated them
+        # @option options [Integer] :page_size How many conversations to return at maximum (1-100, default: 30)
+        # @option options [String] :summary_mode Whether to include transcript summaries ("exclude", "include", default: "exclude")
+        # @return [Hash] List of conversations with pagination info
+        def list(**options)
+          endpoint = "/v1/convai/conversations"
+          query_params = options.compact
+          
+          if query_params.any?
+            query_string = URI.encode_www_form(query_params)
+            endpoint = "#{endpoint}?#{query_string}"
+          end
+          
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/conversations/{conversation_id}
+        # Get the details of a particular conversation
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/get
+        #
+        # @param conversation_id [String] The id of the conversation
+        # @return [Hash] Conversation details including transcript and metadata
+        def get(conversation_id)
+          endpoint = "/v1/convai/conversations/#{conversation_id}"
+          @client.get(endpoint)
+        end
+
+        # DELETE /v1/convai/conversations/{conversation_id}
+        # Delete a particular conversation
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/delete
+        #
+        # @param conversation_id [String] The id of the conversation
+        # @return [Hash] Empty response on success
+        def delete(conversation_id)
+          endpoint = "/v1/convai/conversations/#{conversation_id}"
+          @client.delete(endpoint)
+        end
+
+        # GET /v1/convai/conversations/{conversation_id}/audio
+        # Get the audio recording of a particular conversation
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/audio
+        #
+        # @param conversation_id [String] The id of the conversation
+        # @return [String] Binary audio data
+        def get_audio(conversation_id)
+          endpoint = "/v1/convai/conversations/#{conversation_id}/audio"
+          @client.get_binary(endpoint)
+        end
+
+        # GET /v1/convai/conversation/get-signed-url
+        # Get a signed url to start a conversation with an agent that requires authorization
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/get-signed-url
+        #
+        # @param agent_id [String] The id of the agent
+        # @param options [Hash] Optional parameters
+        # @option options [Boolean] :include_conversation_id Whether to include a conversation_id with the response (default: false)
+        # @return [Hash] Response containing signed_url
+        def get_signed_url(agent_id, **options)
+          endpoint = "/v1/convai/conversation/get-signed-url"
+          query_params = { agent_id: agent_id }.merge(options.compact)
+          
+          query_string = URI.encode_www_form(query_params)
+          endpoint_with_query = "#{endpoint}?#{query_string}"
+          
+          @client.get(endpoint_with_query)
+        end
+
+        # GET /v1/convai/conversation/token
+        # Get a WebRTC session token for real-time communication
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/token
+        #
+        # @param agent_id [String] The id of the agent
+        # @param options [Hash] Optional parameters
+        # @option options [String] :participant_name Optional custom participant name
+        # @return [Hash] Response containing WebRTC token
+        def get_token(agent_id, **options)
+          endpoint = "/v1/convai/conversation/token"
+          query_params = { agent_id: agent_id }.merge(options.compact)
+          
+          query_string = URI.encode_www_form(query_params)
+          endpoint_with_query = "#{endpoint}?#{query_string}"
+          
+          @client.get(endpoint_with_query)
+        end
+
+        # POST /v1/convai/conversations/{conversation_id}/feedback
+        # Send the feedback for the given conversation
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/conversations/feedback
+        #
+        # @param conversation_id [String] The id of the conversation
+        # @param feedback [String] Either 'like' or 'dislike' to indicate the feedback
+        # @return [Hash] Empty response on success
+        def send_feedback(conversation_id, feedback)
+          endpoint = "/v1/convai/conversations/#{conversation_id}/feedback"
+          request_body = { feedback: feedback }
+          @client.post(endpoint, request_body)
+        end
+      end
+    end
+  end
+end

data/lib/elevenlabs_client/endpoints/agents_platform/knowledge_base.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Endpoints
+    module AgentsPlatform
+      class KnowledgeBase
+        def initialize(client)
+          @client = client
+        end
+
+        # GET /v1/convai/knowledge-base
+        # Get a list of available knowledge base documents
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/list
+        #
+        # @param options [Hash] Query parameters
+        # @option options [Integer] :page_size How many documents to return at maximum (1-100, default: 30)
+        # @option options [String] :search Filter documents whose names start with this string
+        # @option options [Boolean] :show_only_owned_documents Return only documents owned by you (default: false)
+        # @option options [Array<String>] :types Filter by document types ("file", "url", "text")
+        # @option options [String] :sort_direction Sort direction ("asc" or "desc")
+        # @option options [String] :sort_by Sort field ("name", "created_at", "updated_at", "size")
+        # @option options [Boolean] :use_typesense Use typesense DB for search (deprecated, default: false)
+        # @option options [String] :cursor Used for fetching next page
+        # @return [Hash] List of knowledge base documents with pagination info
+        def list(**options)
+          endpoint = "/v1/convai/knowledge-base"
+          query_params = options.compact
+          
+          if query_params.any?
+            query_string = URI.encode_www_form(query_params)
+            endpoint = "#{endpoint}?#{query_string}"
+          end
+          
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/knowledge-base/{documentation_id}
+        # Get details about a specific documentation making up the agent's knowledge base
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param agent_id [String] Optional agent ID for context
+        # @return [Hash] Knowledge base document details
+        def get(documentation_id, agent_id: nil)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}"
+          
+          if agent_id
+            endpoint = "#{endpoint}?agent_id=#{agent_id}"
+          end
+          
+          @client.get(endpoint)
+        end
+
+        # PATCH /v1/convai/knowledge-base/{documentation_id}
+        # Update the name of a document
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/update
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param name [String] A custom, human-readable name for the document
+        # @return [Hash] Updated knowledge base document details
+        def update(documentation_id, name:)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}"
+          request_body = { name: name }
+          @client.patch(endpoint, request_body)
+        end
+
+        # DELETE /v1/convai/knowledge-base/{documentation_id}
+        # Delete a document from the knowledge base
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/delete
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param force [Boolean] Delete regardless of agent dependencies (default: false)
+        # @return [Hash] Empty response on success
+        def delete(documentation_id, force: false)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}"
+          
+          if force
+            endpoint = "#{endpoint}?force=true"
+          end
+          
+          @client.delete(endpoint)
+        end
+
+        # POST /v1/convai/knowledge-base/url
+        # Create a knowledge base document generated by scraping the given webpage
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/create-url
+        #
+        # @param url [String] URL to a page of documentation
+        # @param name [String] Optional custom name for the document
+        # @return [Hash] Created document with ID and name
+        def create_from_url(url, name: nil)
+          endpoint = "/v1/convai/knowledge-base/url"
+          request_body = { url: url }
+          request_body[:name] = name if name
+          @client.post(endpoint, request_body)
+        end
+
+        # POST /v1/convai/knowledge-base/text
+        # Create a knowledge base document containing the provided text
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/create-text
+        #
+        # @param text [String] Text content to be added to the knowledge base
+        # @param name [String] Optional custom name for the document
+        # @return [Hash] Created document with ID and name
+        def create_from_text(text, name: nil)
+          endpoint = "/v1/convai/knowledge-base/text"
+          request_body = { text: text }
+          request_body[:name] = name if name
+          @client.post(endpoint, request_body)
+        end
+
+        # POST /v1/convai/knowledge-base/file
+        # Create a knowledge base document generated from the uploaded file
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/create-file
+        #
+        # @param file_io [IO] File IO object to upload
+        # @param filename [String] Original filename
+        # @param name [String] Optional custom name for the document
+        # @return [Hash] Created document with ID and name
+        def create_from_file(file_io:, filename:, name: nil)
+          endpoint = "/v1/convai/knowledge-base/file"
+          
+          payload = {
+            "file" => @client.file_part(file_io, filename)
+          }
+          payload["name"] = name if name
+          
+          @client.post_multipart(endpoint, payload)
+        end
+
+        # POST /v1/convai/knowledge-base/{documentation_id}/rag-index
+        # Trigger or get status of RAG indexing for a document
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/compute-rag-index
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param model [String] RAG model to use ("e5_mistral_7b_instruct" or "multilingual_e5_large_instruct")
+        # @return [Hash] RAG index status and progress
+        def compute_rag_index(documentation_id, model:)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/rag-index"
+          request_body = { model: model }
+          @client.post(endpoint, request_body)
+        end
+
+        # GET /v1/convai/knowledge-base/{documentation_id}/rag-index
+        # Get information about all RAG indexes of the specified document
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-rag-index
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @return [Hash] List of RAG indexes for the document
+        def get_rag_index(documentation_id)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/rag-index"
+          @client.get(endpoint)
+        end
+
+        # DELETE /v1/convai/knowledge-base/{documentation_id}/rag-index/{rag_index_id}
+        # Delete RAG index for the knowledge base document
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/delete-rag-index
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param rag_index_id [String] The id of RAG index of document
+        # @return [Hash] Deleted RAG index information
+        def delete_rag_index(documentation_id, rag_index_id)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/rag-index/#{rag_index_id}"
+          @client.delete(endpoint)
+        end
+
+        # GET /v1/convai/knowledge-base/rag-index
+        # Get total size and other information of RAG indexes used by knowledge base documents
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-rag-index-overview
+        #
+        # @return [Hash] RAG index overview with usage statistics
+        def get_rag_index_overview
+          endpoint = "/v1/convai/knowledge-base/rag-index"
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/knowledge-base/{documentation_id}/dependent-agents
+        # Get a list of agents depending on this knowledge base document
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-dependent-agents
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param options [Hash] Query parameters
+        # @option options [String] :cursor Used for fetching next page
+        # @option options [Integer] :page_size How many agents to return at maximum (1-100, default: 30)
+        # @return [Hash] List of dependent agents with pagination info
+        def get_dependent_agents(documentation_id, **options)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/dependent-agents"
+          query_params = options.compact
+          
+          if query_params.any?
+            query_string = URI.encode_www_form(query_params)
+            endpoint = "#{endpoint}?#{query_string}"
+          end
+          
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/knowledge-base/{documentation_id}/content
+        # Get the entire content of a document from the knowledge base
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-content
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @return [String] Streaming document content
+        def get_content(documentation_id)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/content"
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/knowledge-base/{documentation_id}/chunk/{chunk_id}
+        # Get details about a specific documentation part used by RAG
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-chunk
+        #
+        # @param documentation_id [String] The id of a document from the knowledge base
+        # @param chunk_id [String] The id of a document RAG chunk
+        # @return [Hash] Chunk details with ID, name, and content
+        def get_chunk(documentation_id, chunk_id)
+          endpoint = "/v1/convai/knowledge-base/#{documentation_id}/chunk/#{chunk_id}"
+          @client.get(endpoint)
+        end
+
+        # GET /v1/convai/agent/{agent_id}/knowledge-base/size
+        # Returns the number of pages in the agent's knowledge base
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/knowledge-base/get-size
+        #
+        # @param agent_id [String] The agent ID
+        # @return [Hash] Knowledge base size information
+        def get_agent_knowledge_base_size(agent_id)
+          endpoint = "/v1/convai/agent/#{agent_id}/knowledge-base/size"
+          @client.get(endpoint)
+        end
+      end
+    end
+  end
+end

data/lib/elevenlabs_client/endpoints/agents_platform/llm_usage.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Endpoints
+    module AgentsPlatform
+      # LLM Usage endpoint - refactored for better maintainability
+      class LlmUsage
+        def initialize(client)
+          @client = client
+        end
+
+        # POST /v1/convai/llm-usage/calculate
+        # Returns a list of LLM models and the expected cost for using them based on the provided values
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/llm-usage/calculate
+        #
+        # @param prompt_length [Integer] Length of the prompt in characters (required)
+        # @param number_of_pages [Integer] Pages of content in PDF documents or URLs in the agent's knowledge base (required)
+        # @param rag_enabled [Boolean] Whether RAG is enabled (required)
+        # @return [Hash] JSON response containing list of LLM models with pricing information
+        def calculate(prompt_length:, number_of_pages:, rag_enabled:)
+          validate_required!(:prompt_length, prompt_length)
+          validate_required!(:number_of_pages, number_of_pages) 
+          validate_required!(:rag_enabled, rag_enabled)
+
+          body = {
+            prompt_length: prompt_length,
+            number_of_pages: number_of_pages,
+            rag_enabled: rag_enabled
+          }
+
+          @client.post("/v1/convai/llm-usage/calculate", body)
+        end
+
+        # Convenience alias
+        alias_method :calculate_usage, :calculate
+
+        private
+
+        attr_reader :client
+
+        # Parameter validation that handles boolean values properly
+        def validate_required!(param_name, value)
+          if value.nil?
+            raise ArgumentError, "#{param_name} is required"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/elevenlabs_client/endpoints/agents_platform/mcp_servers.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Endpoints
+    module AgentsPlatform
+      # MCP Servers endpoint - refactored for better maintainability
+      class McpServers
+        def initialize(client)
+          @client = client
+        end
+
+        # POST /v1/convai/mcp-servers
+        # Create a new MCP server configuration in the workspace
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/create
+        #
+        # @param config [Hash] Configuration details for the MCP Server (required)
+        # @option config [String] :url MCP server URL
+        # @option config [String] :name MCP server name
+        # @option config [String] :approval_policy Approval policy ("auto_approve_all", "require_approval_all", "require_approval_per_tool")
+        # @option config [Array] :tool_approval_hashes Tool approval configurations
+        # @option config [String] :transport Transport method (default: "SSE")
+        # @option config [Hash] :secret_token Secret token configuration
+        # @option config [Hash] :request_headers Request headers
+        # @option config [String] :description MCP server description
+        # @return [Hash] JSON response containing created MCP server details
+        def create(config:)
+          validate_required!(:config, config)
+          raise ArgumentError, "config cannot be empty" if config.empty?
+
+          body = { config: config }
+
+          @client.post("/v1/convai/mcp-servers", body)
+        end
+
+        # GET /v1/convai/mcp-servers
+        # Retrieve all MCP server configurations available in the workspace
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/list
+        #
+        # @return [Hash] JSON response containing list of MCP servers
+        def list
+          @client.get("/v1/convai/mcp-servers")
+        end
+
+        # GET /v1/convai/mcp-servers/:mcp_server_id
+        # Retrieve a specific MCP server configuration from the workspace
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/get
+        #
+        # @param mcp_server_id [String] ID of the MCP Server (required)
+        # @return [Hash] JSON response containing MCP server details
+        def get(mcp_server_id)
+          validate_required!(:mcp_server_id, mcp_server_id)
+
+          @client.get("/v1/convai/mcp-servers/#{mcp_server_id}")
+        end
+
+        # PATCH /v1/convai/mcp-servers/:mcp_server_id/approval-policy
+        # Update the approval policy configuration for an MCP server
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/update-approval-policy
+        #
+        # @param mcp_server_id [String] ID of the MCP Server (required)
+        # @param approval_policy [String] The approval mode to set for the MCP server (required)
+        #   - "auto_approve_all": Automatically approve all tools
+        #   - "require_approval_all": Require approval for all tools
+        #   - "require_approval_per_tool": Require approval per individual tool
+        # @return [Hash] JSON response containing updated MCP server details
+        def update_approval_policy(mcp_server_id, approval_policy:)
+          validate_required!(:mcp_server_id, mcp_server_id)
+          validate_required!(:approval_policy, approval_policy)
+
+          valid_policies = %w[auto_approve_all require_approval_all require_approval_per_tool]
+          unless valid_policies.include?(approval_policy.to_s)
+            raise ArgumentError, "approval_policy must be one of: #{valid_policies.join(', ')}"
+          end
+
+          body = { approval_policy: approval_policy }
+
+          @client.patch("/v1/convai/mcp-servers/#{mcp_server_id}/approval-policy", body)
+        end
+
+        # POST /v1/convai/mcp-servers/:mcp_server_id/tool-approvals
+        # Add approval for a specific MCP tool when using per-tool approval mode
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/create-tool-approval
+        #
+        # @param mcp_server_id [String] ID of the MCP Server (required)
+        # @param tool_name [String] The name of the MCP tool (required)
+        # @param tool_description [String] The description of the MCP tool (required)
+        # @param options [Hash] Optional parameters
+        # @option options [Hash] :input_schema The input schema of the MCP tool
+        # @option options [String] :approval_policy Tool-level approval policy ("auto_approved", "requires_approval")
+        # @return [Hash] JSON response containing updated MCP server details
+        def create_tool_approval(mcp_server_id, tool_name:, tool_description:, **options)
+          validate_required!(:mcp_server_id, mcp_server_id)
+          validate_required!(:tool_name, tool_name)
+          validate_required!(:tool_description, tool_description)
+
+          body = {
+            tool_name: tool_name,
+            tool_description: tool_description
+          }.merge(options.compact)
+
+          @client.post("/v1/convai/mcp-servers/#{mcp_server_id}/tool-approvals", body)
+        end
+
+        # DELETE /v1/convai/mcp-servers/:mcp_server_id/tool-approvals/:tool_name
+        # Remove approval for a specific MCP tool when using per-tool approval mode
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/mcp-servers/delete-tool-approval
+        #
+        # @param mcp_server_id [String] ID of the MCP Server (required)
+        # @param tool_name [String] Name of the MCP tool to remove approval for (required)
+        # @return [Hash] JSON response containing updated MCP server details
+        def delete_tool_approval(mcp_server_id, tool_name)
+          validate_required!(:mcp_server_id, mcp_server_id)
+          validate_required!(:tool_name, tool_name)
+
+          @client.delete("/v1/convai/mcp-servers/#{mcp_server_id}/tool-approvals/#{tool_name}")
+        end
+
+        # Convenience method aliases
+        alias_method :servers, :list
+        alias_method :get_server, :get
+        alias_method :update_policy, :update_approval_policy
+        alias_method :approve_tool, :create_tool_approval
+        alias_method :remove_tool_approval, :delete_tool_approval
+
+        private
+
+        attr_reader :client
+
+        # Parameter validation
+        def validate_required!(param_name, value)
+          if value.nil? || (value.respond_to?(:empty?) && value.empty?) || 
+             (value.is_a?(String) && value.strip.empty?)
+            raise ArgumentError, "#{param_name} is required"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/elevenlabs_client/endpoints/agents_platform/outbound_calling.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Endpoints
+    module AgentsPlatform
+      class OutboundCalling
+        def initialize(client)
+          @client = client
+        end
+
+        # POST /v1/convai/sip-trunk/outbound-call
+        # Handle an outbound call via SIP trunk
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/sip-trunk/outbound-call
+        #
+        # @param agent_id [String] The agent ID to use for the call
+        # @param agent_phone_number_id [String] The phone number ID to call from
+        # @param to_number [String] The phone number to call
+        # @param options [Hash] Optional parameters
+        # @option options [Hash] :conversation_initiation_client_data Additional data for conversation initiation
+        # @return [Hash] JSON response containing success status, message, conversation_id, and sip_call_id
+        def sip_trunk_call(agent_id:, agent_phone_number_id:, to_number:, **options)
+          endpoint = "/v1/convai/sip-trunk/outbound-call"
+          request_body = {
+            agent_id: agent_id,
+            agent_phone_number_id: agent_phone_number_id,
+            to_number: to_number
+          }.merge(options)
+          
+          @client.post(endpoint, request_body)
+        end
+
+        # POST /v1/convai/twilio/outbound-call
+        # Handle an outbound call via Twilio
+        # Documentation: https://elevenlabs.io/docs/api-reference/convai/twilio/outbound-call
+        #
+        # @param agent_id [String] The agent ID to use for the call
+        # @param agent_phone_number_id [String] The phone number ID to call from
+        # @param to_number [String] The phone number to call
+        # @param options [Hash] Optional parameters
+        # @option options [Hash] :conversation_initiation_client_data Additional data for conversation initiation
+        # @return [Hash] JSON response containing success status, message, conversation_id, and callSid
+        def twilio_call(agent_id:, agent_phone_number_id:, to_number:, **options)
+          endpoint = "/v1/convai/twilio/outbound-call"
+          request_body = {
+            agent_id: agent_id,
+            agent_phone_number_id: agent_phone_number_id,
+            to_number: to_number
+          }.merge(options)
+          
+          @client.post(endpoint, request_body)
+        end
+      end
+    end
+  end
+end