你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Answer Call - Answer Call

参考

服务:: Communication

API 版本:: 2025-05-15

使用事件网格中的 IncomingCallContext 接听呼叫。

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

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string (url)	Azure 通信资源的终结点。
api-version	query	True	string	要调用的 API 版本。

请求头

名称	必需	类型	说明
Authorization	True	string	Azure 通信服务用户访问令牌。
Repeatability-Request-ID		string (uuid)	如果指定，客户端将指示请求可重复;也就是说，客户端可以使用相同的可重复性-Request-Id 多次发出请求并返回适当的响应，而无需服务器多次执行请求。 Repeatability-Request-Id 的值是表示请求的客户端生成的唯一标识符的不透明字符串。它是版本 4 （随机） UUID。
Repeatability-First-Sent		string (date-time-rfc1123)	如果指定了 Repeatability-Request-ID 标头，则还必须指定 Repeatability-First-Sent 标头。该值应为首次创建请求的日期和时间，使用 IMF 修复日期形式的 HTTP 日期表示。示例：1994年11月6日 08：49：37 GMT。

请求正文

名称	必需	类型	说明
callbackUri	True	string	回调 URI。
incomingCallContext	True	string	与调用关联的上下文。
answeredBy		CommunicationUserIdentifierModel
callIntelligenceOptions		CallIntelligenceOptions	通话的 AI 选项。
mediaStreamingOptions		MediaStreamingOptions: WebSocketMediaStreamingOptions	媒体流式处理选项。
operationContext		string	用于跟踪呼叫应答的客户集值。
transcriptionOptions		TranscriptionOptions: WebSocketTranscriptionOptions	听录选项。

响应

名称	类型	说明
200 OK	CallConnectionProperties	服务收到 AnswerCall 请求后，返回调用属性的详细信息。连接调用后，将在指定的回调 URI 处收到 CallConnected 事件。
Other Status Codes	CommunicationErrorResponse	错误

安全性

Authorization

Azure 通信服务用户访问令牌。

类型: apiKey
在: header

示例

AnswerCall

示例请求

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

示例响应

状态代码:: 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"
  }
}

定义

名称	说明
AnswerCallRequest	用于应答呼叫的请求有效负载。
AudioFormat	用于编码的音频格式，包括采样率和声道类型。默认值为 Pcm16KMono。
CallConnectionProperties	调用连接的属性
CallConnectionStateModel	调用连接的状态。
CallIntelligenceOptions	通话的 AI 选项。
MediaStreamingAudioChannelType	要流式传输的音频声道类型，例如，未混合音频、混合音频。
MediaStreamingContentType
MediaStreamingSubscription	媒体流式处理订阅对象。
MediaStreamingSubscriptionState	媒体流式处理订阅状态。
StreamingTransportType	定义用于流式处理的传输类型。请注意，可能会引入当前未记录的 future 值。
TranscriptionResultType
TranscriptionSubscription	听录订阅对象。
TranscriptionSubscriptionState	听录订阅状态。
WebSocketMediaStreamingOptions	表示 WebSocket 传输的选项。
WebSocketTranscriptionOptions	表示 WebSocket 传输的选项。

AnswerCallRequest

Object

用于应答呼叫的请求有效负载。

名称	类型	说明
answeredBy	CommunicationUserIdentifierModel
callIntelligenceOptions	CallIntelligenceOptions	通话的 AI 选项。
callbackUri	string	回调 URI。
incomingCallContext	string	与调用关联的上下文。
mediaStreamingOptions	MediaStreamingOptions: WebSocketMediaStreamingOptions	媒体流式处理选项。
operationContext	string	用于跟踪呼叫应答的客户集值。
transcriptionOptions	TranscriptionOptions: WebSocketTranscriptionOptions	听录选项。

AudioFormat

枚举

用于编码的音频格式，包括采样率和声道类型。默认值为 Pcm16KMono。

值	说明
pcm16KMono
pcm24KMono

CallConnectionProperties

Object

调用连接的属性

名称	类型	说明
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	调用连接 ID。
callConnectionState	CallConnectionStateModel	调用连接的状态。
callbackUri	string	回调 URI。
correlationId	string	相关 ID。
mediaStreamingSubscription	MediaStreamingSubscription	呼叫的媒体流订阅的状态
serverCallId	string	服务器调用 ID。
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	拨打 pstn 号码时，呼叫的显示名称。
targets	CommunicationIdentifierModel[]	调用的目标。
transcriptionSubscription	TranscriptionSubscription	听录订阅。

CallConnectionStateModel

枚举

调用连接的状态。

值	说明
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

CallIntelligenceOptions

Object

通话的 AI 选项。

名称	类型	说明
cognitiveServicesEndpoint	string	分配给此调用的认知服务资源的标识符。

MediaStreamingAudioChannelType

枚举

要流式传输的音频声道类型，例如，未混合音频、混合音频。

值	说明
mixed
unmixed

MediaStreamingContentType

枚举

值	说明
audio

MediaStreamingSubscription

Object

媒体流式处理订阅对象。

名称	类型	说明
id	string	订阅 ID。
state	MediaStreamingSubscriptionState	媒体流式处理订阅状态。
subscribedContentTypes	MediaStreamingContentType[]	订阅的媒体流内容类型。

MediaStreamingSubscriptionState

枚举

媒体流式处理订阅状态。

值	说明
active
disabled
inactive

StreamingTransportType

枚举

定义用于流式处理的传输类型。请注意，可能会引入当前未记录的 future 值。

值	说明
websocket

TranscriptionResultType

枚举

值	说明
final
intermediate

TranscriptionSubscription

Object

听录订阅对象。

名称	类型	说明
id	string	订阅 ID。
locale	string	指定用于转录的区域设置，例如 en-CA 或 en-AU。
state	TranscriptionSubscriptionState	听录订阅状态。
subscribedResultTypes	TranscriptionResultType[]	订阅的听录结果类型。

TranscriptionSubscriptionState

枚举

听录订阅状态。

值	说明
active
disabled
inactive

WebSocketMediaStreamingOptions

Object

表示 WebSocket 传输的选项。

名称	类型	说明
audioChannelType	MediaStreamingAudioChannelType	要流式传输的音频声道类型，例如，未混合音频、混合音频。
audioFormat	AudioFormat	用于编码的音频格式，包括采样率和声道类型。默认值为 Pcm16KMono。
contentType	MediaStreamingContentType
enableBidirectional	boolean	一个值，该值指示是否启用了双向流式处理。
enableDtmfTones	boolean	一个值，指示是否流式传输 DTMF 音调。
startMediaStreaming	boolean	一个值，该值指示是否应在应答呼叫后立即开始媒体流。
transportType	string: websocket	定义用于流式处理的传输类型。请注意，可能会引入当前未记录的 future 值。
transportUrl	string	媒体流的传输 URL。

WebSocketTranscriptionOptions

Object

表示 WebSocket 传输的选项。

名称	类型	说明
enableIntermediateResults	boolean	为转录的语音启用中间结果。
locale	string	指定用于转录的区域设置，例如 en-CA 或 en-AU。
speechModelEndpointId	string	GUID 格式的已部署自定义模型的 ID。 GUID 由 Azure Speech Studio 生成，例如 a259c255-1cdw-4ed7-a693-dd58563b6f6a。
startTranscription	boolean	指示是否应在应答呼叫后立即开始听录。
transportType	string: websocket	定义用于流式处理的传输类型。请注意，可能会引入当前未记录的 future 值。
transportUrl	string	用于实时转录传输的 URL。

通过

Answer Call - Answer Call

URI 参数

请求头

请求正文

响应

安全性

Authorization

示例

AnswerCall

示例请求

示例响应

定义

AnswerCallRequest

AudioFormat

CallConnectionProperties

CallConnectionStateModel

CallIntelligenceOptions

MediaStreamingAudioChannelType

MediaStreamingContentType

MediaStreamingSubscription

MediaStreamingSubscriptionState

StreamingTransportType

TranscriptionResultType

TranscriptionSubscription

TranscriptionSubscriptionState

WebSocketMediaStreamingOptions

WebSocketTranscriptionOptions