Call Connection - Get Call

Servicio:

Communication

Versión de la API:

2025-05-15

Obtenga las propiedades detalladas de una llamada en curso.

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2025-05-15

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
callConnectionId	path	True	string	Identificador de conexión de llamada.
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
Authorization	True	string	Un token de acceso de usuario de Azure Communication Services.

Respuestas

Nombre	Tipo	Description
200 OK	CallConnectionProperties	Devuelve los detalles de las propiedades de la llamada.
Other Status Codes	CommunicationErrorResponse	Error

Seguridad

Authorization

Un token de acceso de usuario de Azure Communication Services.

Tipo: apiKey
En: header

Ejemplos

CallConnection_GetCall

Solicitud de ejemplo

HTTP

GET https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c?api-version=2025-05-15

Respuesta de muestra

status code:

200

{
  "callConnectionId": "18dea47f-b081-4107-9a5c-4300819d2c6c",
  "serverCallId": "aHR0cHM6Ly9jb252ZXJzYXRpb251cmwvdGVzdA",
  "sourceCallerIdNumber": {
    "value": "+18440123456"
  },
  "source": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "targets": [
    {
      "kind": "communicationUser",
      "communicationUser": {
        "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
      }
    },
    {
      "kind": "phoneNumber",
      "phoneNumber": {
        "value": "+14250123456"
      }
    }
  ],
  "callConnectionState": "connected",
  "callbackUri": "https://app.contoso.com/callback"
}

Definiciones

Nombre	Description
CallConnectionProperties	Propiedades de una conexión de llamada
CallConnectionStateModel	Estado de la conexión de llamada.
MediaStreamingContentType
MediaStreamingSubscription	Objeto de suscripción de streaming multimedia.
MediaStreamingSubscriptionState	Estado de la suscripción de streaming multimedia.
TranscriptionResultType
TranscriptionSubscription	Objeto de suscripción de transcripción.
TranscriptionSubscriptionState	Estado de la suscripción de transcripción.

CallConnectionProperties

Object

Propiedades de una conexión de llamada

Nombre	Tipo	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	Identificador de conexión de llamada.
callConnectionState	CallConnectionStateModel	Estado de la conexión de llamada.
callbackUri	string	Identificador URI de devolución de llamada.
correlationId	string	Identificador de correlación.
mediaStreamingSubscription	MediaStreamingSubscription	Estado de la suscripción de streaming multimedia para la llamada
serverCallId	string	Identificador de llamada del servidor.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Nombre para mostrar de la llamada si se llama a un número rtc.
targets	CommunicationIdentifierModel[]	Destinos de la llamada.
transcriptionSubscription	TranscriptionSubscription	Suscripción de transcripción.

CallConnectionStateModel

Enumeración

Estado de la conexión de llamada.

Valor	Description
unknown
connecting
connected
transferring
transferAccepted
disconnecting
disconnected

MediaStreamingContentType

Enumeración

Valor	Description
audio

MediaStreamingSubscription

Object

Objeto de suscripción de streaming multimedia.

Nombre	Tipo	Description
id	string	Identificador de suscripción.
state	MediaStreamingSubscriptionState	Estado de la suscripción de streaming multimedia.
subscribedContentTypes	MediaStreamingContentType[]	Tipos de contenido de streaming multimedia suscritos.

MediaStreamingSubscriptionState

Enumeración

Estado de la suscripción de streaming multimedia.

Valor	Description
disabled
inactive
active

TranscriptionResultType

Enumeración

Valor	Description
final
intermediate

TranscriptionSubscription

Object

Objeto de suscripción de transcripción.

Nombre	Tipo	Description
id	string	Identificador de suscripción.
locale	string	Especifica la configuración regional utilizada para la transcripción, por ejemplo, en-CA o en-AU.
state	TranscriptionSubscriptionState	Estado de la suscripción de transcripción.
subscribedResultTypes	TranscriptionResultType[]	Tipos de resultados de transcripción suscritos.

TranscriptionSubscriptionState

Enumeración

Estado de la suscripción de transcripción.

Valor	Description
disabled
inactive
active