Compartir a través de

Redirect Call - Redirect Call

Servicio:
Communication
Versión de la API:
2026-03-12

Redirigir una llamada.

POST {endpoint}/calling/callConnections:redirect?api-version=2026-03-12

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string (url)

El punto final del recurso Azure Communication Service.
api-version
 query True

string

Versión de la API para invocar.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Authorization True

string

Un token de acceso de usuario de Azure Communication Services.
Repeatability-Request-ID

string (uuid)

Si se especifica, el cliente indica que la solicitud es repetible; es decir, que el cliente puede realizar la solicitud varias veces con la mismaRequest-Id de repetibilidad 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 (aleatorio) de la versión 4.
Repeatability-First-Sent

string (date-time-rfc1123)

Si se especifica el encabezado Repeatability-Request-ID, también se debe especificar el encabezado Repeatability-First-Sent. 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: Dom, 06 Nov 1994 08:49:37 GMT.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
incomingCallContext True

string

El contexto asociado con la llamada.
target True

CommunicationIdentifierModel

Respuestas

Nombre Tipo Description
204 No Content

El servicio ha redirigido la llamada al punto de conexión especificado.
Other Status Codes

CommunicationErrorResponse

Error

Seguridad

Authorization

Un token de acceso de usuario de Azure Communication Services.

Tipo: apiKey
En: header

Ejemplos

RedirectCall

Solicitud de ejemplo

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2026-03-12

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

RedirectCallRequest

Objeto

La carga útil de la solicitud para redirigir la llamada.

Nombre Tipo Description
incomingCallContext

string

El contexto asociado con la llamada.
target

CommunicationIdentifierModel