tencentcloud-sdk-ccc 3.0.1089 → 3.0.1093

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f18cb5898e81755106cdb29bc10730fd14b7c5d2
-  data.tar.gz: 8041917555121b98abb77b57ae01d64a69c97d87
+  metadata.gz: 35852628e28341bfe93d19a3453caf3cc26f2c9d
+  data.tar.gz: 6ed478bafb0bced6afbc3f383e7ece6ce2d6944d
 SHA512:
-  metadata.gz: d5df1b92389deba5da2ca2d7c8c1b969cfc9f55c5a8f1de8680d9c3580e62c5ee7191ed97a71767684658f0b9f260d9edbc2be4a9480327cd1f007b541271882
-  data.tar.gz: adac530a93a8e763f360b37cbd56928f2ed93a852e47a57f5498e105769b8e0613373f2e6c9eb5a5de29eb542349f34246b66f54cc285b4453c6103c742765ed
+  metadata.gz: bcc6517373040ad035fbf487945dabf095114ea9f5361346735293a6e2e5d0fe4987ba4108c3306f8f9fea9ff3a8e74e0e8d350a8bba6bd3ee8bb30400674ab7
+  data.tar.gz: 4d73949ce7270c9c4201887c0e631c548d687c6ac7d63bffb4a55dd0c567fa41eafc43a77f96e2d30becb79270c19c4fa2c29361da873d048ead5e5263106bd2

data/lib/VERSION

@@ -1 +1 @@
-3.0.1089
+3.0.1093

data/lib/v20200210/client.rb

@@ -149,6 +149,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 提供服务端控制机器人的功能
+
+        # @param request: Request instance for ControlAIConversation.
+        # @type request: :class:`Tencentcloud::ccc::V20200210::ControlAIConversationRequest`
+        # @rtype: :class:`Tencentcloud::ccc::V20200210::ControlAIConversationResponse`
+        def ControlAIConversation(request)
+          body = send_request('ControlAIConversation', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ControlAIConversationResponse.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
+
         # 用于调用AI模型发起外呼通话，仅限自有电话号码使用，目前开通高级版座席**限时**免费体验。
 
         # 发起通话前，请先确认您的AI模型是否兼容 OpenAI、Azure 或 Minimax 协议，并前往模型服务商网站获取相关鉴权信息。 具体功能说明请参考文档 [腾讯云联络中心AI通话平台](https://cloud.tencent.com/document/product/679/112100)。

data/lib/v20200210/models.rb

@@ -355,8 +355,8 @@ module TencentCloud
 
         attr_accessor :User, :Message, :Timestamp, :Start, :End
         extend Gem::Deprecate
-        deprecate :Timestamp, :none, 2025, 6
-        deprecate :Timestamp=, :none, 2025, 6
+        deprecate :Timestamp, :none, 2025, 7
+        deprecate :Timestamp=, :none, 2025, 7
 
         def initialize(user=nil, message=nil, timestamp=nil, start=nil, _end=nil)
           @User = user
@@ -573,8 +573,8 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :StaffEmail, :SkillGroupList, :StaffSkillGroupList
         extend Gem::Deprecate
-        deprecate :SkillGroupList, :none, 2025, 6
-        deprecate :SkillGroupList=, :none, 2025, 6
+        deprecate :SkillGroupList, :none, 2025, 7
+        deprecate :SkillGroupList=, :none, 2025, 7
 
         def initialize(sdkappid=nil, staffemail=nil, skillgrouplist=nil, staffskillgrouplist=nil)
           @SdkAppId = sdkappid
@@ -978,6 +978,55 @@ module TencentCloud
         end
       end
 
+      # ControlAIConversation请求参数结构体
+      class ControlAIConversationRequest < TencentCloud::Common::AbstractModel
+        # @param SessionId: 会话 ID
+        # @type SessionId: String
+        # @param SdkAppId: 应用 ID（必填），可以查看 https://console.cloud.tencent.com/ccc
+        # @type SdkAppId: Integer
+        # @param Command: 控制命令，目前支持命令如下：
+
+        # - ServerPushText，服务端发送文本给AI机器人，AI机器人会播报该文本
+        # @type Command: String
+        # @param ServerPushText: 服务端发送播报文本命令，当Command为ServerPushText时必填
+        # @type ServerPushText: :class:`Tencentcloud::Ccc.v20200210.models.ServerPushText`
+
+        attr_accessor :SessionId, :SdkAppId, :Command, :ServerPushText
+
+        def initialize(sessionid=nil, sdkappid=nil, command=nil, serverpushtext=nil)
+          @SessionId = sessionid
+          @SdkAppId = sdkappid
+          @Command = command
+          @ServerPushText = serverpushtext
+        end
+
+        def deserialize(params)
+          @SessionId = params['SessionId']
+          @SdkAppId = params['SdkAppId']
+          @Command = params['Command']
+          unless params['ServerPushText'].nil?
+            @ServerPushText = ServerPushText.new
+            @ServerPushText.deserialize(params['ServerPushText'])
+          end
+        end
+      end
+
+      # ControlAIConversation返回参数结构体
+      class ControlAIConversationResponse < 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
+
       # CreateAIAgentCall请求参数结构体
       class CreateAIAgentCallRequest < TencentCloud::Common::AbstractModel
         # @param SdkAppId: 应用 ID（必填），可以查看 https://console.cloud.tencent.com/ccc
@@ -999,8 +1048,8 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :AIAgentId, :Callee, :Callers, :PromptVariables, :Variables
         extend Gem::Deprecate
-        deprecate :PromptVariables, :none, 2025, 6
-        deprecate :PromptVariables=, :none, 2025, 6
+        deprecate :PromptVariables, :none, 2025, 7
+        deprecate :PromptVariables=, :none, 2025, 7
 
         def initialize(sdkappid=nil, aiagentid=nil, callee=nil, callers=nil, promptvariables=nil, variables=nil)
           @SdkAppId = sdkappid
@@ -1288,8 +1337,8 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :Callee, :LLMType, :APIKey, :APIUrl, :SystemPrompt, :Model, :VoiceType, :Callers, :WelcomeMessage, :WelcomeType, :WelcomeMessagePriority, :MaxDuration, :Languages, :InterruptMode, :InterruptSpeechDuration, :EndFunctionEnable, :EndFunctionDesc, :TransferFunctionEnable, :TransferItems, :NotifyDuration, :NotifyMessage, :NotifyMaxCount, :CustomTTSConfig, :PromptVariables, :VadSilenceTime, :ExtractConfig, :Temperature, :Variables
         extend Gem::Deprecate
-        deprecate :PromptVariables, :none, 2025, 6
-        deprecate :PromptVariables=, :none, 2025, 6
+        deprecate :PromptVariables, :none, 2025, 7
+        deprecate :PromptVariables=, :none, 2025, 7
 
         def initialize(sdkappid=nil, callee=nil, llmtype=nil, apikey=nil, apiurl=nil, systemprompt=nil, model=nil, voicetype=nil, callers=nil, welcomemessage=nil, welcometype=nil, welcomemessagepriority=nil, maxduration=nil, languages=nil, interruptmode=nil, interruptspeechduration=nil, endfunctionenable=nil, endfunctiondesc=nil, transferfunctionenable=nil, transferitems=nil, notifyduration=nil, notifymessage=nil, notifymaxcount=nil, customttsconfig=nil, promptvariables=nil, vadsilencetime=nil, extractconfig=nil, temperature=nil, variables=nil)
           @SdkAppId = sdkappid
@@ -1699,8 +1748,8 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :UserId, :Callee, :Caller, :Callers, :IsForceUseMobile, :Uui, :UUI
         extend Gem::Deprecate
-        deprecate :Uui, :none, 2025, 6
-        deprecate :Uui=, :none, 2025, 6
+        deprecate :Uui, :none, 2025, 7
+        deprecate :Uui=, :none, 2025, 7
 
         def initialize(sdkappid=nil, userid=nil, callee=nil, caller=nil, callers=nil, isforceusemobile=nil, uui=nil)
           @SdkAppId = sdkappid
@@ -3043,10 +3092,10 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :InstanceId, :CdrId, :Limit, :Offset, :Order, :SessionId
         extend Gem::Deprecate
-        deprecate :InstanceId, :none, 2025, 6
-        deprecate :InstanceId=, :none, 2025, 6
-        deprecate :CdrId, :none, 2025, 6
-        deprecate :CdrId=, :none, 2025, 6
+        deprecate :InstanceId, :none, 2025, 7
+        deprecate :InstanceId=, :none, 2025, 7
+        deprecate :CdrId, :none, 2025, 7
+        deprecate :CdrId=, :none, 2025, 7
 
         def initialize(sdkappid=nil, instanceid=nil, cdrid=nil, limit=nil, offset=nil, order=nil, sessionid=nil)
           @SdkAppId = sdkappid
@@ -3372,8 +3421,8 @@ module TencentCloud
 
         attr_accessor :StartTimestamp, :EndTimestamp, :InstanceId, :SdkAppId, :Limit, :Offset, :Type
         extend Gem::Deprecate
-        deprecate :InstanceId, :none, 2025, 6
-        deprecate :InstanceId=, :none, 2025, 6
+        deprecate :InstanceId, :none, 2025, 7
+        deprecate :InstanceId=, :none, 2025, 7
 
         def initialize(starttimestamp=nil, endtimestamp=nil, instanceid=nil, sdkappid=nil, limit=nil, offset=nil, type=nil)
           @StartTimestamp = starttimestamp
@@ -3410,8 +3459,8 @@ module TencentCloud
 
         attr_accessor :TotalCount, :IMCdrs, :IMCdrList, :RequestId
         extend Gem::Deprecate
-        deprecate :IMCdrs, :none, 2025, 6
-        deprecate :IMCdrs=, :none, 2025, 6
+        deprecate :IMCdrs, :none, 2025, 7
+        deprecate :IMCdrs=, :none, 2025, 7
 
         def initialize(totalcount=nil, imcdrs=nil, imcdrlist=nil, requestid=nil)
           @TotalCount = totalcount
@@ -3903,8 +3952,8 @@ module TencentCloud
 
         attr_accessor :TotalCount, :TelCdrs, :TelCdrList, :RequestId
         extend Gem::Deprecate
-        deprecate :TelCdrs, :none, 2025, 6
-        deprecate :TelCdrs=, :none, 2025, 6
+        deprecate :TelCdrs, :none, 2025, 7
+        deprecate :TelCdrs=, :none, 2025, 7
 
         def initialize(totalcount=nil, telcdrs=nil, telcdrlist=nil, requestid=nil)
           @TotalCount = totalcount
@@ -4169,8 +4218,8 @@ module TencentCloud
 
         attr_accessor :TelCallOutCount, :TelCallInCount, :SeatUsedCount, :VoipCallInCount, :VOIPCallInCount, :AsrOfflineCount, :AsrRealtimeCount, :RequestId
         extend Gem::Deprecate
-        deprecate :VoipCallInCount, :none, 2025, 6
-        deprecate :VoipCallInCount=, :none, 2025, 6
+        deprecate :VoipCallInCount, :none, 2025, 7
+        deprecate :VoipCallInCount=, :none, 2025, 7
 
         def initialize(telcalloutcount=nil, telcallincount=nil, seatusedcount=nil, voipcallincount=nil, asrofflinecount=nil, asrrealtimecount=nil, requestid=nil)
           @TelCallOutCount = telcalloutcount
@@ -4218,8 +4267,8 @@ module TencentCloud
 
         attr_accessor :StartTimeStamp, :EndTimeStamp, :InstanceId, :Limit, :Offset, :SdkAppId, :PageSize, :PageNumber, :Phones, :SessionIds
         extend Gem::Deprecate
-        deprecate :InstanceId, :none, 2025, 6
-        deprecate :InstanceId=, :none, 2025, 6
+        deprecate :InstanceId, :none, 2025, 7
+        deprecate :InstanceId=, :none, 2025, 7
 
         def initialize(starttimestamp=nil, endtimestamp=nil, instanceid=nil, limit=nil, offset=nil, sdkappid=nil, pagesize=nil, pagenumber=nil, phones=nil, sessionids=nil)
           @StartTimeStamp = starttimestamp
@@ -4261,8 +4310,8 @@ module TencentCloud
 
         attr_accessor :TotalCount, :TelCdrs, :TelCdrList, :RequestId
         extend Gem::Deprecate
-        deprecate :TelCdrs, :none, 2025, 6
-        deprecate :TelCdrs=, :none, 2025, 6
+        deprecate :TelCdrs, :none, 2025, 7
+        deprecate :TelCdrs=, :none, 2025, 7
 
         def initialize(totalcount=nil, telcdrs=nil, telcdrlist=nil, requestid=nil)
           @TotalCount = totalcount
@@ -5046,10 +5095,12 @@ module TencentCloud
         # @type UseMobileAccept: Integer
         # @param ExtensionNumber: 座席分机号（1 到 8 打头，4 - 6 位）
         # @type ExtensionNumber: String
+        # @param ForwardingConfig: 呼叫转移配置
+        # @type ForwardingConfig: :class:`Tencentcloud::Ccc.v20200210.models.ForwardingConfig`
 
-        attr_accessor :SdkAppId, :Email, :Name, :Phone, :Nick, :StaffNo, :SkillGroupIds, :UseMobileCallOut, :UseMobileAccept, :ExtensionNumber
+        attr_accessor :SdkAppId, :Email, :Name, :Phone, :Nick, :StaffNo, :SkillGroupIds, :UseMobileCallOut, :UseMobileAccept, :ExtensionNumber, :ForwardingConfig
 
-        def initialize(sdkappid=nil, email=nil, name=nil, phone=nil, nick=nil, staffno=nil, skillgroupids=nil, usemobilecallout=nil, usemobileaccept=nil, extensionnumber=nil)
+        def initialize(sdkappid=nil, email=nil, name=nil, phone=nil, nick=nil, staffno=nil, skillgroupids=nil, usemobilecallout=nil, usemobileaccept=nil, extensionnumber=nil, forwardingconfig=nil)
           @SdkAppId = sdkappid
           @Email = email
           @Name = name
@@ -5060,6 +5111,7 @@ module TencentCloud
           @UseMobileCallOut = usemobilecallout
           @UseMobileAccept = usemobileaccept
           @ExtensionNumber = extensionnumber
+          @ForwardingConfig = forwardingconfig
         end
 
         def deserialize(params)
@@ -5073,6 +5125,10 @@ module TencentCloud
           @UseMobileCallOut = params['UseMobileCallOut']
           @UseMobileAccept = params['UseMobileAccept']
           @ExtensionNumber = params['ExtensionNumber']
+          unless params['ForwardingConfig'].nil?
+            @ForwardingConfig = ForwardingConfig.new
+            @ForwardingConfig.deserialize(params['ForwardingConfig'])
+          end
         end
       end
 
@@ -5693,6 +5749,52 @@ module TencentCloud
         end
       end
 
+      # 服务端控制AI对话机器人播报指定文本
+      class ServerPushText < TencentCloud::Common::AbstractModel
+        # @param Text: 服务端推送播报文本
+        # @type Text: String
+        # @param Interrupt: 是否允许该文本打断机器人说话
+        # @type Interrupt: Boolean
+        # @param StopAfterPlay: 播报完文本后，是否自动关闭对话任务
+        # @type StopAfterPlay: Boolean
+        # @param Audio: 服务端推送播报音频
+        #     格式说明：音频必须为单声道，采样率必须跟对应TTS的采样率保持一致，编码为Base64字符串。
+        #     输入规则：当提供Audio字段时，将不接受Text字段的输入。系统将直接播放Audio字段中的音频内容。
+        # @type Audio: String
+        # @param DropMode: 默认为0，仅在Interrupt为false时有效
+        # - 0表示当前有交互发生时，会丢弃Interrupt为false的消息
+        # - 1表示当前有交互发生时，不会丢弃Interrupt为false的消息，而是缓存下来，等待当前交互结束后，再去处理
+
+        # 注意：DropMode为1时，允许缓存多个消息，如果后续出现了打断，缓存的消息会被清空
+        # @type DropMode: Integer
+        # @param Priority: ServerPushText消息的优先级，0表示可被打断，1表示不会被打断。**目前仅支持传入0，如果需要传入1，请提工单联系我们添加权限。**
+        # 注意：在接收到Priority=1的消息后，后续其他任何消息都会被忽略（包括Priority=1的消息），直到Priority=1的消息处理结束。该字段可与Interrupt、DropMode字段配合使用。
+        # 例子：
+        # - Priority=1、Interrupt=true，会打断现有交互，立刻播报，播报过程中不会被打断
+        # - Priority=1、Interrupt=false、DropMode=1，会等待当前交互结束，再进行播报，播报过程中不会被打断
+        # @type Priority: Integer
+
+        attr_accessor :Text, :Interrupt, :StopAfterPlay, :Audio, :DropMode, :Priority
+
+        def initialize(text=nil, interrupt=nil, stopafterplay=nil, audio=nil, dropmode=nil, priority=nil)
+          @Text = text
+          @Interrupt = interrupt
+          @StopAfterPlay = stopafterplay
+          @Audio = audio
+          @DropMode = dropmode
+          @Priority = priority
+        end
+
+        def deserialize(params)
+          @Text = params['Text']
+          @Interrupt = params['Interrupt']
+          @StopAfterPlay = params['StopAfterPlay']
+          @Audio = params['Audio']
+          @DropMode = params['DropMode']
+          @Priority = params['Priority']
+        end
+      end
+
       # 技能组信息
       class SkillGroupInfoItem < TencentCloud::Common::AbstractModel
         # @param SkillGroupId: 技能组ID
@@ -5826,10 +5928,10 @@ module TencentCloud
 
         attr_accessor :Name, :Mail, :Phone, :Nick, :StaffNumber, :RoleId, :RoleIdList, :RoleList, :SkillGroupList, :LastModifyTimestamp, :ExtensionNumber, :ForwardingConfig
         extend Gem::Deprecate
-        deprecate :RoleId, :none, 2025, 6
-        deprecate :RoleId=, :none, 2025, 6
-        deprecate :RoleIdList, :none, 2025, 6
-        deprecate :RoleIdList=, :none, 2025, 6
+        deprecate :RoleId, :none, 2025, 7
+        deprecate :RoleId=, :none, 2025, 7
+        deprecate :RoleIdList, :none, 2025, 7
+        deprecate :RoleIdList=, :none, 2025, 7
 
         def initialize(name=nil, mail=nil, phone=nil, nick=nil, staffnumber=nil, roleid=nil, roleidlist=nil, rolelist=nil, skillgrouplist=nil, lastmodifytimestamp=nil, extensionnumber=nil, forwardingconfig=nil)
           @Name = name
@@ -6233,8 +6335,8 @@ module TencentCloud
 
         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
         extend Gem::Deprecate
-        deprecate :Uui, :none, 2025, 6
-        deprecate :Uui=, :none, 2025, 6
+        deprecate :Uui, :none, 2025, 7
+        deprecate :Uui=, :none, 2025, 7
 
         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)
           @Caller = caller

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ccc
 version: !ruby/object:Gem::Version
-  version: 3.0.1089
+  version: 3.0.1093
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-06-25 00:00:00.000000000 Z
+date: 2025-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common