Compartilhar via

Redirect Call - Redirect Call

Serviço:
Communication
Versão da API:
2026-03-12

Redirecionar uma chamada.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
 path True

string (url)

O endpoint do recurso Azure Communication Service.
api-version
 query True

string

Versão da API para invocar.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
Authorization True

string

Um token de acesso de usuário dos Serviços de Comunicação do Azure.
Repeatability-Request-ID

string (uuid)

Se especificado, o cliente direciona que a solicitação seja repetível; ou seja, que o cliente pode fazer a solicitação várias vezes com o mesmoRequest-Id de repetibilidade e obter uma resposta apropriada sem que o servidor execute a solicitação várias vezes. O valor doRequest-Id Repeatability- é uma cadeia de caracteres opaca que representa um identificador exclusivo gerado pelo cliente para a solicitação. É um UUID versão 4 (aleatório).
Repeatability-First-Sent

string (date-time-rfc1123)

Se o cabeçalho Repeatability-Request-ID for especificado, o cabeçalho Repeatability-First-Sent também deverá ser especificado. O valor deve ser a data e a hora em que a solicitação foi criada pela primeira vez, expressa usando a forma IMF-fixdate de HTTP-date. Exemplo: Sun, 06 Nov 1994 08:49:37 GMT.

Corpo da solicitação

Nome Obrigatório Tipo Description
incomingCallContext True

string

O contexto associado à chamada.
target True

CommunicationIdentifierModel

Respostas

Nome Tipo Description
204 No Content

O serviço redirecionou a chamada para o ponto de extremidade especificado.
Other Status Codes

CommunicationErrorResponse

Erro

Segurança

Authorization

Um token de acesso de usuário dos Serviços de Comunicação do Azure.

Tipo: apiKey
Em: header

Exemplos

RedirectCall

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
204

Definições

RedirectCallRequest

Objeto

A carga útil da solicitação para redirecionar a chamada.

Nome Tipo Description
incomingCallContext

string

O contexto associado à chamada.
target

CommunicationIdentifierModel