Call Connection - Transfer To Participant

서비스:

Communication

API 버전:

2024-09-15

참가자에게 통화를 전송합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
callConnectionId	path	True	string	호출 연결 ID입니다.
endpoint	path	True	string url	Azure Communication 리소스의 엔드포인트입니다.
api-version	query	True	string	호출할 API의 버전입니다.

요청 헤더

Name	필수	형식	Description
Authorization	True	string	Azure Communication Services 사용자 액세스 토큰입니다.
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 헤더도 지정해야 합니다. 값은 요청이 처음 생성된 날짜 및 시간이어야 하며, HTTP 날짜의 IMF 수정 형식을 사용하여 표현됩니다. 예: 1994년 11월 6일 일요일 08:49:37 GMT.

요청 본문

Name	필수	형식	Description
targetParticipant	True	CommunicationIdentifierModel
customCallingContext		CustomCallingContext	고객이 대상에 사용자 지정 호출 컨텍스트를 보내는 데 사용
operationCallbackUri		string	이 작업에 대해 CreateCall/AnswerCall에서 설정한 기본 콜백 URI를 재정의하는 콜백 URI를 설정합니다. 이 설정은 작업별로 수행됩니다. 설정되지 않은 경우 CreateCall/AnswerCall에서 설정한 기본 콜백 URI가 사용됩니다.
operationContext		string	응답 이벤트와 요청을 상호 연결하기 위해 중간 호출 작업을 호출할 때 고객이 사용합니다.
sourceCallerIdNumber		PhoneNumberIdentifierModel
transferee		CommunicationIdentifierModel

응답

Name	형식	Description
202 Accepted	TransferCallResponse	서비스에서 전송 요청을 수락하고 처리를 시작합니다. 지정된 콜백 URI에서 CallTransferAccepted 또는 CallTransferFailed 이벤트를 수신하여 요청 상태를 업데이트합니다.
Other Status Codes	CommunicationErrorResponse	오류

보안

Authorization

Azure Communication Services 사용자 액세스 토큰입니다.

형식: apiKey
In(다음 안에): 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"
}

정의

Name	Description
CustomCallingContext	대상에 전송될 사용자 지정 호출 컨텍스트
TransferCallResponse	호출을 전송하기 위한 응답 페이로드입니다.
TransferToParticipantRequest	참가자에게 통화를 전송하기 위한 요청 페이로드입니다.

CustomCallingContext

대상에 전송될 사용자 지정 호출 컨텍스트

Name	형식	Description
sipHeaders	object	사용자 지정 호출 컨텍스트 SIP 헤더
voipHeaders	object	사용자 지정 호출 컨텍스트 VoiP 헤더

TransferCallResponse

호출을 전송하기 위한 응답 페이로드입니다.

Name	형식	Description
operationContext	string	클라이언트에서 제공하는 작업 컨텍스트입니다.

TransferToParticipantRequest

참가자에게 통화를 전송하기 위한 요청 페이로드입니다.

Name	형식	Description
customCallingContext	CustomCallingContext	고객이 대상에 사용자 지정 호출 컨텍스트를 보내는 데 사용
operationCallbackUri	string	이 작업에 대해 CreateCall/AnswerCall에서 설정한 기본 콜백 URI를 재정의하는 콜백 URI를 설정합니다. 이 설정은 작업별로 수행됩니다. 설정되지 않은 경우 CreateCall/AnswerCall에서 설정한 기본 콜백 URI가 사용됩니다.
operationContext	string	응답 이벤트와 요청을 상호 연결하기 위해 중간 호출 작업을 호출할 때 고객이 사용합니다.
sourceCallerIdNumber	PhoneNumberIdentifierModel
targetParticipant	CommunicationIdentifierModel
transferee	CommunicationIdentifierModel