Answer Call - Answer Call

Riferimento

Servizio:: Communication

Versione API:: 2025-05-15

Rispondere a una chiamata usando IncomingCallContext da Griglia di eventi.

POST {endpoint}/calling/callConnections:answer?api-version=2025-05-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (url)	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di accesso utente di Servizi di comunicazione di Azure.
Repeatability-Request-ID		string (uuid)	Se specificato, il client indirizza che la richiesta è ripetibile; ovvero, che il client può effettuare la richiesta più volte con la stessa ripetibilità-Request-Id e ottenere una risposta appropriata senza che il server eseeseguono la richiesta più volte. Il valore di Repeatability-Request-Id è una stringa opaca che rappresenta un identificatore univoco generato dal client per la richiesta. Si tratta di un UUID versione 4 (casuale).
Repeatability-First-Sent		string (date-time-rfc1123)	Se viene specificata l'intestazione Repeatability-Request-ID, è necessario specificare anche l'intestazione Repeatability-First-Sent. Il valore deve essere la data e l'ora in cui la richiesta è stata creata per la prima volta, espressa utilizzando il formato IMF-fixdate di HTTP-date. Esempio: Sun, 06 Novembre 1994 08:49:37 GMT.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
callbackUri	True	string	URI di callback.
incomingCallContext	True	string	Contesto associato alla chiamata.
answeredBy		CommunicationUserIdentifierModel
callIntelligenceOptions		CallIntelligenceOptions	Opzioni di intelligenza artificiale per la chiamata.
mediaStreamingOptions		MediaStreamingOptions: WebSocketMediaStreamingOptions	Opzioni di streaming multimediale.
operationContext		string	Valore impostato dal cliente usato per tenere traccia della risposta di una chiamata.
transcriptionOptions		TranscriptionOptions: WebSocketTranscriptionOptions	Opzioni di trascrizione.

Risposte

Nome	Tipo	Descrizione
200 OK	CallConnectionProperties	Restituisce i dettagli delle proprietà della chiamata dopo che la richiesta AnswerCall viene ricevuta dal servizio. Quando la chiamata è connessa, si riceverà l'evento CallConnected all'URI di callback specificato.
Other Status Codes	CommunicationErrorResponse	Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

AnswerCall

Esempio di richiesta

HTTP

POST https://contoso.communications.azure.com/calling/callConnections:answer?api-version=2025-05-15

{
  "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",
  "callbackUri": "https://app.contoso.com/callback",
  "operationContext": "operationContext",
  "callIntelligenceOptions": {
    "cognitiveServicesEndpoint": "string"
  },
  "answeredBy": {
    "id": "+11234567890"
  },
  "mediaStreamingOptions": {
    "audioChannelType": "mixed",
    "transportUrl": "string",
    "transportType": "websocket",
    "contentType": "audio",
    "startMediaStreaming": true,
    "enableBidirectional": true,
    "audioFormat": "pcm16KMono"
  },
  "transcriptionOptions": {
    "locale": "en-US",
    "transportUrl": "string",
    "transportType": "websocket",
    "speechModelEndpointId": "string",
    "startTranscription": true,
    "enableIntermediateResults": true
  }
}

Risposta di esempio

Codice di stato:: 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"
      }
    }
  ],
  "callConnectionState": "connected",
  "callbackUri": "https://app.contoso.com/callback",
  "mediaStreamingSubscription": {
    "id": "23dea47f-b081-4107-9a5c-4300819d2caa",
    "state": "active",
    "subscribedContentTypes": [
      "audio"
    ]
  },
  "transcriptionSubscription": {
    "id": "45dea47f-b081-4107-9a5c-4300819d2caa",
    "state": "active",
    "subscribedResultTypes": [
      "final"
    ]
  },
  "answeredFor": {
    "value": "+11234567890"
  }
}

Definizioni

Nome	Descrizione
AnswerCallRequest	Payload della richiesta per rispondere alla chiamata.
AudioFormat	Il formato audio utilizzato per la codifica, inclusa la frequenza di campionamento e il tipo di canale. Il valore predefinito è Pcm16KMono.
CallConnectionProperties	Proprietà di una connessione di chiamata
CallConnectionStateModel	Stato della connessione di chiamata.
CallIntelligenceOptions	Opzioni di intelligenza artificiale per la chiamata.
MediaStreamingAudioChannelType	Il tipo di canale audio da trasmettere, ad esempio audio non mixato, audio misto.
MediaStreamingContentType
MediaStreamingSubscription	Oggetto Sottoscrizione streaming multimediale.
MediaStreamingSubscriptionState	Stato della sottoscrizione di streaming multimediale.
StreamingTransportType	Definisce il tipo di trasporto utilizzato per lo streaming. Si noti che potrebbero essere introdotti valori futuri che non sono attualmente documentati.
TranscriptionResultType
TranscriptionSubscription	Oggetto Subscription di trascrizione.
TranscriptionSubscriptionState	Stato della sottoscrizione di trascrizione.
WebSocketMediaStreamingOptions	Rappresenta le opzioni per il trasporto WebSocket.
WebSocketTranscriptionOptions	Rappresenta le opzioni per il trasporto WebSocket.

AnswerCallRequest

Object

Payload della richiesta per rispondere alla chiamata.

Nome	Tipo	Descrizione
answeredBy	CommunicationUserIdentifierModel
callIntelligenceOptions	CallIntelligenceOptions	Opzioni di intelligenza artificiale per la chiamata.
callbackUri	string	URI di callback.
incomingCallContext	string	Contesto associato alla chiamata.
mediaStreamingOptions	MediaStreamingOptions: WebSocketMediaStreamingOptions	Opzioni di streaming multimediale.
operationContext	string	Valore impostato dal cliente usato per tenere traccia della risposta di una chiamata.
transcriptionOptions	TranscriptionOptions: WebSocketTranscriptionOptions	Opzioni di trascrizione.

AudioFormat

Enumerazione

Il formato audio utilizzato per la codifica, inclusa la frequenza di campionamento e il tipo di canale. Il valore predefinito è Pcm16KMono.

Valore	Descrizione
pcm16KMono
pcm24KMono

CallConnectionProperties

Object

Proprietà di una connessione di chiamata

Nome	Tipo	Descrizione
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	ID connessione di chiamata.
callConnectionState	CallConnectionStateModel	Stato della connessione di chiamata.
callbackUri	string	URI di callback.
correlationId	string	L'ID di correlazione.
mediaStreamingSubscription	MediaStreamingSubscription	Stato della sottoscrizione di streaming multimediale per la chiamata
serverCallId	string	ID chiamata server.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Nome visualizzato della chiamata se si effettua la chiamata a un numero pstn.
targets	CommunicationIdentifierModel[]	Destinazioni della chiamata.
transcriptionSubscription	TranscriptionSubscription	Sottoscrizione di trascrizione.

CallConnectionStateModel

Enumerazione

Stato della connessione di chiamata.

Valore	Descrizione
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

CallIntelligenceOptions

Object

Opzioni di intelligenza artificiale per la chiamata.

Nome	Tipo	Descrizione
cognitiveServicesEndpoint	string	Identificatore della risorsa di Servizi cognitivi assegnata a questa chiamata.

MediaStreamingAudioChannelType

Enumerazione

Il tipo di canale audio da trasmettere, ad esempio audio non mixato, audio misto.

Valore	Descrizione
mixed
unmixed

MediaStreamingContentType

Enumerazione

Valore	Descrizione
audio

MediaStreamingSubscription

Object

Oggetto Sottoscrizione streaming multimediale.

Nome	Tipo	Descrizione
id	string	ID sottoscrizione.
state	MediaStreamingSubscriptionState	Stato della sottoscrizione di streaming multimediale.
subscribedContentTypes	MediaStreamingContentType[]	Tipi di contenuto di streaming multimediale sottoscritti.

MediaStreamingSubscriptionState

Enumerazione

Stato della sottoscrizione di streaming multimediale.

Valore	Descrizione
active
disabled
inactive

StreamingTransportType

Enumerazione

Definisce il tipo di trasporto utilizzato per lo streaming. Si noti che potrebbero essere introdotti valori futuri che non sono attualmente documentati.

Valore	Descrizione
websocket

TranscriptionResultType

Enumerazione

Valore	Descrizione
final
intermediate

TranscriptionSubscription

Object

Oggetto Subscription di trascrizione.

Nome	Tipo	Descrizione
id	string	ID sottoscrizione.
locale	string	Specifica le impostazioni locali utilizzate per la trascrizione, ad esempio en-CA o en-AU.
state	TranscriptionSubscriptionState	Stato della sottoscrizione di trascrizione.
subscribedResultTypes	TranscriptionResultType[]	Tipi di risultati di trascrizione sottoscritti.

TranscriptionSubscriptionState

Enumerazione

Stato della sottoscrizione di trascrizione.

Valore	Descrizione
active
disabled
inactive

WebSocketMediaStreamingOptions

Object

Rappresenta le opzioni per il trasporto WebSocket.

Nome	Tipo	Descrizione
audioChannelType	MediaStreamingAudioChannelType	Il tipo di canale audio da trasmettere, ad esempio audio non mixato, audio misto.
audioFormat	AudioFormat	Il formato audio utilizzato per la codifica, inclusa la frequenza di campionamento e il tipo di canale. Il valore predefinito è Pcm16KMono.
contentType	MediaStreamingContentType
enableBidirectional	boolean	Valore che indica se il flusso bidirezionale è abilitato.
enableDtmfTones	boolean	Un valore che indica se trasmettere i toni DTMF.
startMediaStreaming	boolean	Valore che indica se il flusso multimediale deve iniziare immediatamente dopo la risposta alla chiamata.
transportType	string: websocket	Definisce il tipo di trasporto utilizzato per lo streaming. Si noti che potrebbero essere introdotti valori futuri che non sono attualmente documentati.
transportUrl	string	URL di trasporto per lo streaming multimediale.

WebSocketTranscriptionOptions

Object

Rappresenta le opzioni per il trasporto WebSocket.

Nome	Tipo	Descrizione
enableIntermediateResults	boolean	Abilita i risultati intermedi per il parlato trascritto.
locale	string	Specifica le impostazioni locali utilizzate per la trascrizione, ad esempio en-CA o en-AU.
speechModelEndpointId	string	ID del modello personalizzato distribuito in formato GUID. Il GUID viene generato da Azure Speech Studio, ad esempio a259c255-1cdw-4ed7-a693-dd58563b6f6a.
startTranscription	boolean	Indica se la trascrizione deve iniziare immediatamente dopo la risposta alla chiamata.
transportType	string: websocket	Definisce il tipo di trasporto utilizzato per lo streaming. Si noti che potrebbero essere introdotti valori futuri che non sono attualmente documentati.
transportUrl	string	URL utilizzato per il trasporto della trascrizione in tempo reale.

Condividi tramite

Answer Call - Answer Call

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

Authorization

Esempio

AnswerCall

Esempio di richiesta

Risposta di esempio

Definizioni

AnswerCallRequest

AudioFormat

CallConnectionProperties

CallConnectionStateModel

CallIntelligenceOptions

MediaStreamingAudioChannelType

MediaStreamingContentType

MediaStreamingSubscription

MediaStreamingSubscriptionState

StreamingTransportType

TranscriptionResultType

TranscriptionSubscription

TranscriptionSubscriptionState

WebSocketMediaStreamingOptions

WebSocketTranscriptionOptions