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	Идентификатор подключения вызова.
endpoint	path	True	string url	Конечная точка ресурса связи Azure.
api-version	query	True	string	Версия API для вызова.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Authorization	True	string	Маркер доступа пользователей служб коммуникации Azure.
Repeatability-Request-ID		string uuid	Если задано, клиент указывает, что запрос повторяется; т. е. клиент может несколько раз выполнять запрос с одной и той же повторяемостью,Request-Id и возвращать соответствующий ответ без выполнения запроса несколько раз. Значение повторяемостиRequest-Id является непрозрачной строкой, представляющей созданный клиентом уникальный идентификатор запроса. Это UUID версии 4 (случайный).
Repeatability-First-Sent		string date-time-rfc1123	Если задано значение "Повторяемость-Request-ID заголовка", необходимо также указать заголовок "Повторяемость-First-Sent". Значение должно быть датой и временем создания запроса, выраженным с помощью формы HTTP-даты, исправленной МВФ. Пример: Sun, 06 ноября 1994 08:49:37 GMT.

Текст запроса

Имя	Обязательно	Тип	Описание
targetParticipant	True	CommunicationIdentifierModel
customCallingContext		CustomCallingContext	Используется клиентом для отправки пользовательского контекста вызова целевым объектам
operationCallbackUri		string	Задайте URI обратного вызова, который переопределяет URI обратного вызова по умолчанию, заданный createCall/AnswerCall для этой операции. Эта настройка выполняется для каждого действия. Если это не задано, будет использоваться универсальный код ресурса (URI) обратного вызова по умолчанию, заданный createCall/AnswerCall.
operationContext		string	Используется клиентами при вызове действий среднего вызова для сопоставления запроса с событием ответа.
sourceCallerIdNumber		PhoneNumberIdentifierModel
transferee		CommunicationIdentifierModel

Ответы

Имя	Тип	Описание
202 Accepted	TransferCallResponse	Служба приняла запрос на передачу и начнет обработку. Вы получите событие CallTransferAccepted или CallTransferFailed по указанному URI обратного вызова, чтобы обновить состояние запроса.
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 обратного вызова, который переопределяет URI обратного вызова по умолчанию, заданный createCall/AnswerCall для этой операции. Эта настройка выполняется для каждого действия. Если это не задано, будет использоваться универсальный код ресурса (URI) обратного вызова по умолчанию, заданный createCall/AnswerCall.
operationContext	string	Используется клиентами при вызове действий среднего вызова для сопоставления запроса с событием ответа.
sourceCallerIdNumber	PhoneNumberIdentifierModel
targetParticipant	CommunicationIdentifierModel
transferee	CommunicationIdentifierModel

Поделиться через