DocsICP FilingConsole
官方文档
首页

MuteCall

更新时间：
复制 MD 格式
产品详情
我的收藏

You can invoke MuteCall to mute the call associated with a specified call ID under a specified instance. This operation can only be invoked by an agent who is in a talking state, and the agent can only mute themselves. After the agent mutes themselves, the customer will no longer hear the agent's voice.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example
InstanceId

string

Yes

Instance ID.

ccc-test
UserId

string

No

The agent ID to be muted.

agent@ccc-test
DeviceId

string

No

Device ID. This parameter is meaningless and can be filled with any value.

device
JobId

string

Yes

The call ID.

job-6581536084722****
ChannelId

string

No

The ID of the voice channel to be muted. This parameter is optional and defaults to empty. If it is empty, the voice channel of the agent corresponding to UserId will be muted.

ch:user:1318888****->8001****:1609253204816:job-6581536084722****

Response elements

Element

Type

Description

Example

object

Code

string

Response code.

OK
HttpStatusCode

integer

HTTP status code.

200
Message

string

Response message.

无
RequestId

string

Request ID.

A275B008-A25B-494D-AB53-93CE253815B6
Params

array

List of response parameters.

string

Response parameter.

无
Data

object

Data.

CallContext

object

Call context environment.

CallType

string

Call type.

Valid values:

  • INBOUND :

    Inbound

  • BARGE :

    Barge-in

  • CONSULTANT :

    Consultation

  • CONFERENCE :

    Conference

  • MONITOR :

    Listener

  • INTERNAL :

    Internal Call

  • OUTBOUND :

    Outbound

  • INTERCEPT :

    Intercept

  • BACK2BACK :

    Back-to-Back Call

  • PREDICTIVE :

    Predictive Outbound

  • COACH :

    Coaching

OUTBOUND
InstanceId

string

Instance ID.

ccc-test
JobId

string

Call ID.

job-6581536084722****
ChannelContexts

array<object>

List of call channels.

object

Call channel.

Index

integer

An auto-increment ID generated by the system. Customers do not need to concern themselves with it.

1
ReleaseInitiator

string

The party that initiated the release of the call channel, indicating who hung up first.

无
ChannelState

string

The status of the call channel.

Valid values:

  • CREATED :

    Created

  • ANSWERED :

    Answered

  • RELEASED :

    Released

  • RETIRED :

    Out Of Effect

  • EARLY_MEDIA :

    Early Media

  • NONE :

    Initial Status

  • RINGING :

    Ringing

ANSWERED
Destination

string

The callee of the call channel.

8001****
UserId

string

The agent ID associated with the channel. This field is empty for a customer's channel.

agent@ccc-test
ChannelFlags

string

Channel flags.

Valid values:

  • COACHING :

    Coaching

  • MONITORING :

    Monitoring

  • MONITORED :

    Monitored

  • COACHED :

    Coached

  • HOLD :

    Hold

  • MUTED :

    Muted

[MUTED]
Timestamp

integer

The UNIX timestamp of the most recent status change of the channel, in milliseconds.

1609253212511
ReleaseReason

string

The release reason for the channel, indicating why the current channel was disconnected. The value comes from the response codes defined in the SIP protocol. Customers should refer to the SIP protocol to analyze the disconnection reason.

无
CallType

string

The call type of the channel.

Valid values:

  • INBOUND :

    Inbound

  • BARGE :

    Barge-in

  • CONSULTANT :

    Consultation

  • CONFERENCE :

    Conference

  • MONITOR :

    Listener

  • INTERNAL :

    Internal Call

  • OUTBOUND :

    Outbound

  • INTERCEPT :

    Intercept

  • BACK2BACK :

    Back-to-Back Call

  • PREDICTIVE :

    Predictive Outbound

  • COACH :

    Coaching

OUTBOUND
JobId

string

The call ID.

job-6581536084722****
ChannelId

string

The channel ID.

ch:user:1318888****->8001****:1609253204816:job-6581536084722****
UserExtension

string

The extension number of the agent associated with the channel.

8001****
Originator

string

The originator of the channel.

1318888****
SkillGroupId

string

The skill group ID associated with the channel. In inbound scenarios, the associated skill group ID is determined by the skill group configured in the IVR transfer-to-agent module. In outbound scenarios, the associated skill group ID is the first skill group that the agent signed into.

skillgroup@ccc-test
UserContext

object

Agent context environment.

Extension

string

Agent extension number.

8001****
Heartbeat

integer

The time when the last heartbeat was received from the agent, in UNIX timestamp format, in milliseconds.

1609253205896
WorkMode

string

Work mode.

Valid values:

  • ON_SITE :

    On-site mode

  • OFF_SITE :

    Off-site mode

  • OFFICE_PHONE :

    Office phone mode

ON_SITE
DeviceId

string

Device ID, which is the identity ID of a browser-based Web Real-Time Communication (WebRTC) softphone or a physical phone device. Only one type of device can be registered at a time.

ACC-YUNBS-1.0.10-****
UserId

string

Agent ID.

agent@ccc-test
Reserved

integer

The time when the agent was most recently reserved. Being reserved means an incoming call will soon be assigned to the agent, in UNIX timestamp format, in milliseconds.

1609253204811
BreakCode

string

Break status code, which can be either system-defined or customer-defined. System-defined break codes include: Warm-up (temporary break state after the agent is published and before becoming idle), RingingTimeout (break caused by agent ringing timeout), and RejectCall (break caused by agent call rejection). There are no restrictions on customer-defined status codes; customers can define them according to their business needs.

Valid values:

  • RingingTimeout :

    Break caused by agent ringing timeout

  • RejectCall :

    Break caused by agent call rejection

  • Warm-up :

    Temporary break state after the agent is published and before becoming idle

Warm-up
InstanceId

string

Instance ID.

ccc-test
OutboundScenario

boolean

Indicates whether the agent is in outbound-only mode.

false
Mobile

string

The agent's personal phone number.

1390000****
JobId

string

Call ID.

job-6581536084722****
UserState

string

Agent status.

Valid values:

  • READY :

    Idle

  • WORKING :

    Post-processing

  • DIALING :

    Dialing

  • BREAK :

    Break

  • OFFLINE :

    Offline

  • TALKING :

    Talking

  • RINGING :

    Ringing

TALKING
SignedSkillGroupIdList

array

List of skill group IDs that the agent has signed into.

string

Skill group ID.

skillgroup1@ccc-test

Examples

Success response

JSON format

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "A275B008-A25B-494D-AB53-93CE253815B6",
  "Params": [
    "无"
  ],
  "Data": {
    "CallContext": {
      "CallType": "OUTBOUND",
      "InstanceId": "ccc-test",
      "JobId": "job-6581536084722****",
      "ChannelContexts": [
        {
          "Index": 1,
          "ReleaseInitiator": "无",
          "ChannelState": "ANSWERED",
          "Destination": "8001****",
          "UserId": "agent@ccc-test",
          "ChannelFlags": "[MUTED]",
          "Timestamp": 1609253212511,
          "ReleaseReason": "无",
          "CallType": "OUTBOUND",
          "JobId": "job-6581536084722****",
          "ChannelId": "ch:user:1318888****->8001****:1609253204816:job-6581536084722****",
          "UserExtension": "8001****",
          "Originator": "1318888****",
          "SkillGroupId": "skillgroup@ccc-test"
        }
      ]
    },
    "UserContext": {
      "Extension": "8001****",
      "Heartbeat": 1609253205896,
      "WorkMode": "ON_SITE",
      "DeviceId": "ACC-YUNBS-1.0.10-****",
      "UserId": "agent@ccc-test",
      "Reserved": 1609253204811,
      "BreakCode": "Warm-up",
      "InstanceId": "ccc-test",
      "OutboundScenario": false,
      "Mobile": "1390000****",
      "JobId": "job-6581536084722****",
      "UserState": "TALKING",
      "SignedSkillGroupIdList": [
        "skillgroup1@ccc-test"
      ]
    }
  }
}

Error codes

HTTP status code

Error code

Error message

Description
400 Parameter.Blank The parameter %s may not be null or blank.
400 InvalidOperation.ChannelState The operation is not allowed. Channel stats (%s) does not meet expectations (%s).
400 InvalidOperation.UserState The operation is not allowed. User state (%s) does not meet expectations (%s).
500 InternalService.CTI An internal CTI service error occurred. %s
404 NotExists.ChannelId The specified channel %s does not exist in call %s.
404 NotExists.InstanceId The specified instance %s does not exist.
404 NotExists.JobId The call %s does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.