Server Calling - Redirect Call

Servicio:

Communication

Versión de la API:

2022-04-07-preview

Redirigir una llamada.

POST {endpoint}/calling/callConnections:redirect?api-version=2022-04-07-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (url)	Punto de conexión del recurso de Comunicación de Azure.
api-version	query	True	string	Versión de la API que se va a invocar.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Repeatability-Request-ID		string (uuid)	Si se especifica, el cliente dirige que se puede repetir la solicitud; es decir, que el cliente puede realizar la solicitud varias veces con la misma repetibilidad:Request-Id y obtener una respuesta adecuada sin que el servidor ejecute la solicitud varias veces. El valor de repeatability-Request-Id es una cadena opaca que representa un identificador único generado por el cliente para la solicitud. Es un UUID de la versión 4 (aleatorio).
Repeatability-First-Sent		string	Si se especifica repeatability-Request-ID encabezado, también se debe especificar repeatability-First-Sent encabezado. El valor debe ser la fecha y hora en que se creó la solicitud por primera vez, expresada mediante el formato IMF-fixdate de HTTP-date. Ejemplo: Sun, 06 nov 1994 08:49:37 GMT.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
incomingCallContext	True	string	Contexto asociado a la llamada.
target	True	CommunicationIdentifierModel	Identidad de destino a la que redirigir la llamada.

Respuestas

Nombre	Tipo	Description
204 No Content		Devuelve la respuesta de llamada de redirección.
Other Status Codes	CommunicationErrorResponse	Error

Ejemplos

Redirect a call.

Solicitud de ejemplo

HTTP

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2022-04-07-preview

{
  "target": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
    }
  },
  "incomingCallContext": "H4sIAAAAAAAEAMVVS2/bOBD+LzrspaElPiSSBoJFNnvYoNi0aHaBtpcFRQ5t1rIokLRTJ8h/X1J2soHRQ4A9lAdZ4ry+mflm/FhpNQy3PjnrtErOj9XysbLBb8uvM9WyEkul49J2ioEiGhlKADHVKiR7oVDXUGo5tkpa8k8zH9yglhuKuLQNkqLpEMZUNSZLNFfVRWVcnAZ1uFVbyP53EQLOtzCaybsx3ZSgnZFKKk4QgLGIybZFfU8oolIZzFrWGk6yzaDG1U6tYLaBMd9MKiSn3aROjjSRoAUHhG1PEDMdIGFlg4yRUmhChWQsm62dMdl+adUQ4aIKEP0u6KPft6RePV1Uyf/PmmmT5VijnlmMpD7VDLg4r9m4G4azgjWng37weD5nBTt6OS8YlcRyBhpJwD1iggFSbccQJVRJANW1gp4XLCc/uHETS/4qJaXX2dE6pSku61pNbgETMrBfxM1hgsUIqVzWe1Lrqda6iBBpmsXx9ZWW1vUe19aHDZja9pqBMRyBpQyxriVIgNBIGa11D9wy2tWE1Q7np6iPOH51lyXtLRinrsZ4D6FwQmdY28LEKfhV7nX8+XCfkZwAB/gGOv18WEccJ1A7M/0V1BgnHwq0/JmBYSoWEi84XTC+pIyLuszCXPBrPyYY0zPTsv57OBSOxJxoXjXzV3WzJs1D/+X22gy/36m762/vhk8PV5eXOWAm5gZKqDZ5/PCdc2L/vvmjbynGh3fhPus8lVIZFzLI7PBj8BNkOsPMRBc/nURXw+DvIbM7hR3MJnmWdNE6Itt7p2Gr3HAHKblxVcyfsp724x5CnPfizbh36WVDvpaUNIMfhplbb+1Xtp87hhfPr687lq/qB4HD9ec1vN98+OzhQ9Rfp26zKq34BS47ygVtBZdNS3AjMCnb0MU/d0NyH/NEH15WmYu/BZ+7q2L6b1oN9LvVS3se5z+B4w6lWIOSHOl5+rmiSJoOI9b0jZZATMPUD7bsm5ZGjrsKfjfNcb+faPH0LyoNW7KCBgAA"
}

Respuesta de muestra

status code:

204

Definiciones

Nombre	Description
CommunicationCloudEnvironmentModel
CommunicationError
CommunicationErrorResponse	Respuesta de error de Communication Services
CommunicationIdentifierModel
CommunicationIdentifierModelKind	Tipo de CommunicationIdentifierModel.
CommunicationUserIdentifierModel
MicrosoftTeamsUserIdentifierModel
PhoneNumberIdentifierModel
RedirectCallRequest	Carga de solicitud para redirigir la llamada.

CommunicationCloudEnvironmentModel

Enumeración

Valor	Description
dod
gcch
public

CommunicationError

Object

Nombre	Tipo	Description
code	string
details	CommunicationError[]
innererror	CommunicationError
message	string
target	string

CommunicationErrorResponse

Object

Respuesta de error de Communication Services

Nombre	Tipo	Description
error	CommunicationError

CommunicationIdentifierModel

Object

Nombre	Tipo	Description
communicationUser	CommunicationUserIdentifierModel	El usuario de comunicación.
kind	CommunicationIdentifierModelKind	Tipo de CommunicationIdentifierModel.
microsoftTeamsUser	MicrosoftTeamsUserIdentifierModel	Usuario de Microsoft Teams.
phoneNumber	PhoneNumberIdentifierModel	Número de teléfono.
rawId	string	Identificador completo del identificador.

CommunicationIdentifierModelKind

Enumeración

Tipo de CommunicationIdentifierModel.

Valor	Description
communicationUser
microsoftTeamsUser
phoneNumber
unknown

CommunicationUserIdentifierModel

Object

Nombre	Tipo	Description
id	string

MicrosoftTeamsUserIdentifierModel

Object

Nombre	Tipo	Description
cloud	CommunicationCloudEnvironmentModel
isAnonymous	boolean
userId	string

PhoneNumberIdentifierModel

Object

Nombre	Tipo	Description
value	string

RedirectCallRequest

Object

Carga de solicitud para redirigir la llamada.

Nombre	Tipo	Description
incomingCallContext	string	Contexto asociado a la llamada.
target	CommunicationIdentifierModel	Identidad de destino a la que redirigir la llamada.