tencentcloud-sdk-ccc 3.0.1178 → 3.0.1192

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 06a4e1d9fb0f1db4e3da85e80df9f56333d43e90
-  data.tar.gz: 7fecd5cbc5cbeda8337ff3099a037fb5fcb87db0
+  metadata.gz: deecd5e9b4230deeb0889d754318d1586d4993fb
+  data.tar.gz: fddb38352c4a0b6e92466cbc46ca52a63c3ccb25
 SHA512:
-  metadata.gz: 5f4fd6c47d6c6830d8541be82bba0889c56f3c041406af9ad6c4144556d2ffef65d61e3adef489e95fd4b8b4b1b06b87405b23590cba83f031d56bac03d83729
-  data.tar.gz: be0bf9caff0dac054d95fe94e91b24b51109f5869c3efb963bf96409f4e66783201032549f6c68dbdb5c900d44588c7d85438d9ba807327678bdb78a0ca8232e
+  metadata.gz: 47948d55659b76fb3bf4f1f2a76563fcda52e9fdf37d0b68e82f6a1d0548a840ada4882b35839a46249fc6022c96d1e29d27d919756a2c1b2f20458375cc08b4
+  data.tar.gz: 379b7ac84bdc77313d7602fb8a61ccc1e5ad728fe92326f93c332f2f2e7214af0871b8d84f90574d7a9773951ca23b2b1b20e890d75e57c303615a65c9388765

data/lib/VERSION

@@ -1 +1 @@
-3.0.1178
+3.0.1192

data/lib/v20200210/client.rb

@@ -173,11 +173,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 用于创建**一次性的智能体外呼任务**。与直接调用原始AI模型的模型通话不同，此接口基于您在实例中预配置的、具备完整业务流程的智能体来发起通话，仅限自有电话号码使用，目前开通高级版座席**限时**免费体验。
+        # 用于创建**一次性的智能体外呼通话**。你可以在管理端-智能体管理中，新建语音智能体，进行 [对话流程配置](https://cloud.tencent.com/document/product/679/119796) 。该接口可调用配置完成的智能体发起单次的外呼任务。若需创建批量智能体外呼任务，请参考文档 [创建自动外呼任务](https://cloud.tencent.com/document/product/679/69194)。
 
-        # 若需创建批量智能体外呼任务，请参考文档 [创建自动外呼任务](https://cloud.tencent.com/document/product/679/69194)。
-
-        # 发起通话前，请先确认您的AI模型是否兼容 OpenAI、Azure 或 Minimax 协议，并前往模型服务商网站获取相关鉴权信息。 具体功能说明请参考文档 [腾讯云联络中心AI通话平台](https://cloud.tencent.com/document/product/679/112100)。
+        # 该功能需购买语音智能体通话套餐，并且仅限自有电话号码使用。详情请参考 [语音智能体通话购买指引](https://cloud.tencent.com/document/product/679/125953)。
 
         # @param request: Request instance for CreateAIAgentCall.
         # @type request: :class:`Tencentcloud::ccc::V20200210::CreateAIAgentCallRequest`
@@ -275,7 +273,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建自动外呼任务
+        # 用于**创建批量自动外呼通话**，系统将根据任务配置，自动向指定的**被叫号码列表**发起外呼通话。该接口可调用配置完成的智能体发起批量的外呼任务，你可以在管理端-智能体管理中，新建语音智能体，进行 [对话流程配置](https://cloud.tencent.com/document/product/679/119796)。若需创建单次智能体外呼任务，请参考文档 [创建单次智能体通话](https://cloud.tencent.com/document/product/679/115681)。
+
+        # 该功能需购买语音智能体通话套餐，并且仅限自有电话号码使用。详情请参考 [语音智能体通话购买指引](https://cloud.tencent.com/document/product/679/125953)。
 
         # @param request: Request instance for CreateAutoCalloutTask.
         # @type request: :class:`Tencentcloud::ccc::V20200210::CreateAutoCalloutTaskRequest`
@@ -663,7 +663,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 获取智能体列表
+        # 本接口用于分页查询指定实例（SdkAppId）下已配置的智能体信息列表，包括智能体ID和名称等基本信息。
 
         # @param request: Request instance for DescribeAIAgentInfoList.
         # @type request: :class:`Tencentcloud::ccc::V20200210::DescribeAIAgentInfoListRequest`
@@ -711,7 +711,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 获取 AI 通话内容提取结果。
+        # 本接口用于：在语音智能体通话结束后，通过 Session ID 查询指定会话的 **话后标签** 结果。相关话后标签需提前在管理端完成配置，具体说明请参见 [话后标签](https://cloud.tencent.com/document/product/679/119800) 。
 
         # @param request: Request instance for DescribeAICallExtractResult.
         # @type request: :class:`Tencentcloud::ccc::V20200210::DescribeAICallExtractResultRequest`
@@ -735,7 +735,11 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 获取 AI 时延信息
+        # 调用该接口，可以通过 Session ID 查询指定会话在特定时间段内，AI服务的处理时延明细与统计数据，时延信息包括：
+        # - 端到端（ETE）时延：统计从用户语音输入到 AI 返回完整响应的整体耗时。
+        # - 自动语音识别（ASR）时延：统计语音输入被识别为文本所需的处理耗时。
+        # - 大语言模型（LLM）时延：统计 AI 模型生成文本内容的推理耗时。
+        # - 语音合成（TTS）时延：统计文本转换为语音音频的合成耗时。
 
         # @param request: Request instance for DescribeAILatency.
         # @type request: :class:`Tencentcloud::ccc::V20200210::DescribeAILatencyRequest`
@@ -1649,7 +1653,8 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 暂停未完成的自动外呼任务
+        # 用于通过 TaskId **暂停一个正在执行的自动外呼任务**。调用该接口后，任务将被临时中断，不再发起新的外呼请求；已发起的通话不受影响。
+        # 暂停后的任务可通过 [恢复暂停的自动外呼任务](https://cloud.tencent.com/document/product/679/125356) 接口继续执行。如需永久终止任务，请参考 [停止自动外呼任务](https://cloud.tencent.com/document/product/679/69192)。
 
         # @param request: Request instance for PauseAutoCalloutTask.
         # @type request: :class:`Tencentcloud::ccc::V20200210::PauseAutoCalloutTaskRequest`
@@ -1697,6 +1702,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 对与座席通话中的会话，进行放音
+
+        # @param request: Request instance for PlaySoundCall.
+        # @type request: :class:`Tencentcloud::ccc::V20200210::PlaySoundCallRequest`
+        # @rtype: :class:`Tencentcloud::ccc::V20200210::PlaySoundCallResponse`
+        def PlaySoundCall(request)
+          body = send_request('PlaySoundCall', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = PlaySoundCallResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 重置话机注册密码
 
         # @param request: Request instance for ResetExtensionPassword.
@@ -1745,7 +1774,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 暂停未完成的自动外呼任务
+        # 用于通过 TaskId **恢复一个已被暂停的自动外呼任务**。该接口适用于在调用 [暂停自动外呼任务](https://cloud.tencent.com/document/product/679/125357) 后，需继续执行剩余外呼计划的场景。调用成功后，任务将从暂停状态恢复，重新发起未完成的外呼请求。
 
         # @param request: Request instance for ResumeAutoCalloutTask.
         # @type request: :class:`Tencentcloud::ccc::V20200210::ResumeAutoCalloutTaskRequest`

data/lib/v20200210/models.rb

@@ -5996,6 +5996,50 @@ module TencentCloud
         end
       end
 
+      # PlaySoundCall请求参数结构体
+      class PlaySoundCallRequest < TencentCloud::Common::AbstractModel
+        # @param SdkAppId: 应用 ID（必填），可以查看 https://console.cloud.tencent.com/ccc
+        # @type SdkAppId: Integer
+        # @param SessionId: 会话ID
+        # @type SessionId: String
+        # @param FileId: 音频文件 ID，参见管理端-电话客服-放音文件管理
+        # @type FileId: Integer
+        # @param PlayTimes: 放音次数，默认 1 次
+        # @type PlayTimes: Integer
+
+        attr_accessor :SdkAppId, :SessionId, :FileId, :PlayTimes
+
+        def initialize(sdkappid=nil, sessionid=nil, fileid=nil, playtimes=nil)
+          @SdkAppId = sdkappid
+          @SessionId = sessionid
+          @FileId = fileid
+          @PlayTimes = playtimes
+        end
+
+        def deserialize(params)
+          @SdkAppId = params['SdkAppId']
+          @SessionId = params['SessionId']
+          @FileId = params['FileId']
+          @PlayTimes = params['PlayTimes']
+        end
+      end
+
+      # PlaySoundCall返回参数结构体
+      class PlaySoundCallResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ResetExtensionPassword请求参数结构体
       class ResetExtensionPasswordRequest < TencentCloud::Common::AbstractModel
         # @param SdkAppId: 应用 ID（必填），可以查看 https://console.cloud.tencent.com/ccc
@@ -7075,13 +7119,17 @@ module TencentCloud
         # @type VoicemailRecordURL: Array
         # @param VoicemailAsrURL: 通话中语音留言ASR文本信息地址
         # @type VoicemailAsrURL: Array
+        # @param AIAgentId: 如果是智能体相关通话，这里是智能体 ID
+        # @type AIAgentId: Integer
+        # @param AIAgentName: 如果是智能体相关通话，这里是智能体名称
+        # @type AIAgentName: String
 
-        attr_accessor :Caller, :Callee, :Time, :Direction, :CallType, :Duration, :RecordURL, :RecordId, :SeatUser, :EndStatus, :SkillGroup, :CallerLocation, :IVRDuration, :RingTimestamp, :AcceptTimestamp, :EndedTimestamp, :IVRKeyPressed, :HungUpSide, :ServeParticipants, :SkillGroupId, :EndStatusString, :StartTimestamp, :QueuedTimestamp, :PostIVRKeyPressed, :QueuedSkillGroupId, :SessionId, :ProtectedCaller, :ProtectedCallee, :Uui, :UUI, :IVRKeyPressedEx, :AsrUrl, :AsrStatus, :CustomRecordURL, :Remark, :QueuedSkillGroupName, :VoicemailRecordURL, :VoicemailAsrURL
+        attr_accessor :Caller, :Callee, :Time, :Direction, :CallType, :Duration, :RecordURL, :RecordId, :SeatUser, :EndStatus, :SkillGroup, :CallerLocation, :IVRDuration, :RingTimestamp, :AcceptTimestamp, :EndedTimestamp, :IVRKeyPressed, :HungUpSide, :ServeParticipants, :SkillGroupId, :EndStatusString, :StartTimestamp, :QueuedTimestamp, :PostIVRKeyPressed, :QueuedSkillGroupId, :SessionId, :ProtectedCaller, :ProtectedCallee, :Uui, :UUI, :IVRKeyPressedEx, :AsrUrl, :AsrStatus, :CustomRecordURL, :Remark, :QueuedSkillGroupName, :VoicemailRecordURL, :VoicemailAsrURL, :AIAgentId, :AIAgentName
         extend Gem::Deprecate
         deprecate :Uui, :none, 2025, 12
         deprecate :Uui=, :none, 2025, 12
 
-        def initialize(caller=nil, callee=nil, time=nil, direction=nil, calltype=nil, duration=nil, recordurl=nil, recordid=nil, seatuser=nil, endstatus=nil, skillgroup=nil, callerlocation=nil, ivrduration=nil, ringtimestamp=nil, accepttimestamp=nil, endedtimestamp=nil, ivrkeypressed=nil, hungupside=nil, serveparticipants=nil, skillgroupid=nil, endstatusstring=nil, starttimestamp=nil, queuedtimestamp=nil, postivrkeypressed=nil, queuedskillgroupid=nil, sessionid=nil, protectedcaller=nil, protectedcallee=nil, uui=nil, ivrkeypressedex=nil, asrurl=nil, asrstatus=nil, customrecordurl=nil, remark=nil, queuedskillgroupname=nil, voicemailrecordurl=nil, voicemailasrurl=nil)
+        def initialize(caller=nil, callee=nil, time=nil, direction=nil, calltype=nil, duration=nil, recordurl=nil, recordid=nil, seatuser=nil, endstatus=nil, skillgroup=nil, callerlocation=nil, ivrduration=nil, ringtimestamp=nil, accepttimestamp=nil, endedtimestamp=nil, ivrkeypressed=nil, hungupside=nil, serveparticipants=nil, skillgroupid=nil, endstatusstring=nil, starttimestamp=nil, queuedtimestamp=nil, postivrkeypressed=nil, queuedskillgroupid=nil, sessionid=nil, protectedcaller=nil, protectedcallee=nil, uui=nil, ivrkeypressedex=nil, asrurl=nil, asrstatus=nil, customrecordurl=nil, remark=nil, queuedskillgroupname=nil, voicemailrecordurl=nil, voicemailasrurl=nil, aiagentid=nil, aiagentname=nil)
           @Caller = caller
           @Callee = callee
           @Time = time
@@ -7119,6 +7167,8 @@ module TencentCloud
           @QueuedSkillGroupName = queuedskillgroupname
           @VoicemailRecordURL = voicemailrecordurl
           @VoicemailAsrURL = voicemailasrurl
+          @AIAgentId = aiagentid
+          @AIAgentName = aiagentname
         end
 
         def deserialize(params)
@@ -7183,6 +7233,8 @@ module TencentCloud
           @QueuedSkillGroupName = params['QueuedSkillGroupName']
           @VoicemailRecordURL = params['VoicemailRecordURL']
           @VoicemailAsrURL = params['VoicemailAsrURL']
+          @AIAgentId = params['AIAgentId']
+          @AIAgentName = params['AIAgentName']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ccc
 version: !ruby/object:Gem::Version
-  version: 3.0.1178
+  version: 3.0.1192
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-08 00:00:00.000000000 Z
+date: 2025-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,8 +33,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20200210/models.rb
 - lib/v20200210/client.rb
+- lib/v20200210/models.rb
 - lib/tencentcloud-sdk-ccc.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby