你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Call Connection - Transfer To Participant

参考

服务:: Communication

API 版本:: 2024-09-15

将呼叫转接到参与者。

POST {endpoint}/calling/callConnections/{callConnectionId}:transferToParticipant?api-version=2024-09-15

URI 参数

名称	在	必需	类型	说明
callConnectionId	path	True	string	调用连接 ID。
endpoint	path	True	string url	Azure 通信资源的终结点。
api-version	query	True	string	要调用的 API 版本。

请求头

名称	必需	类型	说明
Authorization	True	string	Azure 通信服务用户访问令牌。
Repeatability-Request-ID		string uuid	如果指定，客户端将指示请求可重复;也就是说，客户端可以使用相同的可重复性-Request-Id 多次发出请求并返回适当的响应，而无需服务器多次执行请求。 Repeatability-Request-Id 的值是表示请求的客户端生成的唯一标识符的不透明字符串。它是版本 4 （随机） UUID。
Repeatability-First-Sent		string date-time-rfc1123	如果指定了 Repeatability-Request-ID 标头，则还必须指定 Repeatability-First-Sent 标头。该值应为首次创建请求的日期和时间，使用 IMF 修复日期形式的 HTTP 日期表示。示例：1994年11月6日 08：49：37 GMT。

请求正文

名称	必需	类型	说明
targetParticipant	True	CommunicationIdentifierModel
customCallingContext		CustomCallingContext	客户用来向目标发送自定义调用上下文
operationCallbackUri		string	设置一个回调 URI，用于替代 CreateCall/AnswerCall 为此操作设置的默认回调 URI。此设置按操作。如果未设置，将使用 CreateCall/AnswerCall 设置的默认回调 URI。
operationContext		string	客户在调用中调用操作时使用，以将请求与响应事件相关联。
sourceCallerIdNumber		PhoneNumberIdentifierModel
transferee		CommunicationIdentifierModel

响应

名称	类型	说明
202 Accepted	TransferCallResponse	该服务已接受传输请求，并开始处理该请求。将在指定的回调 URI 处收到 CallTransferAccepted 或 CallTransferFailed 事件，以更新请求的状态。
Other Status Codes	CommunicationErrorResponse	错误

安全性

Authorization

Azure 通信服务用户访问令牌。

类型: apiKey
在: header

示例

CallConnection_TransferToParticipant

示例请求

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:transferToParticipant?api-version=2024-09-15

{
  "targetParticipant": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "transferee": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_ae9e3307-f56e-44be-8934-80a63f080538"
    }
  },
  "operationCallbackUri": "https://app.contoso.com/callback",
  "operationContext": "trasferring call"
}

示例响应

状态代码:: 202

{
  "operationContext": "trasferring call"
}

定义

名称	说明
CustomCallingContext	将发送到目标的自定义调用上下文
TransferCallResponse	用于传输呼叫的响应有效负载。
TransferToParticipantRequest	用于将呼叫转接到参与者的请求有效负载。

CustomCallingContext

将发送到目标的自定义调用上下文

名称	类型	说明
sipHeaders	object	自定义调用上下文 SIP 标头
voipHeaders	object	自定义调用上下文 VoiP 标头

TransferCallResponse

用于传输呼叫的响应有效负载。

名称	类型	说明
operationContext	string	客户端提供的操作上下文。

TransferToParticipantRequest

用于将呼叫转接到参与者的请求有效负载。

名称	类型	说明
customCallingContext	CustomCallingContext	客户用来向目标发送自定义调用上下文
operationCallbackUri	string	设置一个回调 URI，用于替代 CreateCall/AnswerCall 为此操作设置的默认回调 URI。此设置按操作。如果未设置，将使用 CreateCall/AnswerCall 设置的默认回调 URI。
operationContext	string	客户在调用中调用操作时使用，以将请求与响应事件相关联。
sourceCallerIdNumber	PhoneNumberIdentifierModel
targetParticipant	CommunicationIdentifierModel
transferee	CommunicationIdentifierModel

通过