共用方式為

Call Connection - Transfer To Participant

  • 參考
服務:
Communication
API 版本:
2024-06-15-preview

將通話轉移給參與者。

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

URI 參數

名稱 位於 必要 類型 Description
callConnectionId
 path True

string

呼叫連線標識碼。
endpoint
 path True

string

url

Azure 通訊資源的端點。
api-version
 query True

string

要叫用的 API 版本。

要求標頭

名稱 必要 類型 Description
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 日期形式表示。 範例：Sun， 1994 年 11 月 6 日 08：49：37 GMT。

要求本文

名稱 必要 類型 Description
targetParticipant True

CommunicationIdentifierModel

customCallingContext

CustomCallingContext

客戶用來將自定義通話內容傳送至目標
operationCallbackUri

string

設定回呼 URI，以覆寫此作業的 CreateCall/AnswerCall 所設定的預設回呼 URI。 此設定是個別動作。 如果未設定，則會使用 CreateCall/AnswerCall 所設定的預設回呼 URI。
operationContext

string

客戶在呼叫中呼叫動作時使用，以將要求與回應事件相互關聯。
sourceCallerIdNumber

PhoneNumberIdentifierModel

transferee

CommunicationIdentifierModel

回應

名稱 類型 Description
202 Accepted

TransferCallResponse

服務已接受傳輸要求，並開始處理它。 您會在指定的回呼 URI 收到 CallTransferAccepted 或 CallTransferFailed 事件，以在要求的狀態更新您。
Other Status Codes

CommunicationErrorResponse

錯誤

安全性

Authorization

Azure 通訊服務用戶存取令牌。

類型: apiKey
位於: header

範例

CallConnection_TransferToParticipant

範例要求

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

{
  "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"
}

定義

名稱 Description
CustomCallingContext

將傳送至目標的自定義呼叫內容
TransferCallResponse

用於傳輸呼叫的響應承載。
TransferToParticipantRequest

將呼叫轉移給參與者的要求承載。

CustomCallingContext

將傳送至目標的自定義呼叫內容

名稱 類型 Description
sipHeaders

object

自訂呼叫內容 SIP 標頭
voipHeaders

object

自定義呼叫內容 VoiP 標頭

TransferCallResponse

用於傳輸呼叫的響應承載。

名稱 類型 Description
operationContext

string

用戶端所提供的作業內容。

TransferToParticipantRequest

將呼叫轉移給參與者的要求承載。

名稱 類型 Description
customCallingContext

CustomCallingContext

客戶用來將自定義通話內容傳送至目標
operationCallbackUri

string

設定回呼 URI，以覆寫此作業的 CreateCall/AnswerCall 所設定的預設回呼 URI。 此設定是個別動作。 如果未設定，則會使用 CreateCall/AnswerCall 所設定的預設回呼 URI。
operationContext

string

客戶在呼叫中呼叫動作時使用，以將要求與回應事件相互關聯。
sourceCallerIdNumber

PhoneNumberIdentifierModel

targetParticipant

CommunicationIdentifierModel

transferee

CommunicationIdentifierModel