PreConnections

Answer a call using the IncomingCallContext from Event Grid.

post/calling/callConnections:answer

Request

  • Base URL
    https://contoso.communication.azure.com
  • Auth
    API key in header Authorization

Query parameters

api-versionstring required

Version of the API to invoke.

Headers

Repeatability-Request-IDstring uuid

If specified, the client directs that the request is repeatable; that is, that the client can make the request multiple times with the same Repeatability-Request-Id and get back an appropriate response without the server executing the request multiple times. The value of the Repeatability-Request-Id is an opaque string representing a client-generated unique identifier for the request. It is a version 4 (random) UUID.

Repeatability-First-Sentstring date-time-rfc1123

If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be specified. The value should be the date and time at which the request was first created, expressed using the IMF-fixdate form of HTTP-date. Example: Sun, 06 Nov 1994 08:49:37 GMT.

Request body

incomingCallContextstring required

The context associated with the call.

callbackUristring required

The callback uri.

operationContextstring

A customer set value used to track the answering of a call.

Response

Returns details of the call properties once the AnswerCall request is received by service. You will receive CallConnected event at your specified callback URI, once the call is connected.

callConnectionIdstring

The call connection id.

serverCallIdstring

The server call id.

callConnectionState'unknown' | 'connecting' | 'connected' | 'transferring' | 'transferAccepted' | 'disconnecting' | 'disconnected'

The states of a call connection.

callbackUristring

The callback URI.

sourceDisplayNamestring

Display name of the call if dialing out to a pstn number.

correlationIdstring

The correlation ID.

Changes

  • 2022-04-07-previewd4d02a642780Revision changes
    • info

      api operation id ServerCalling_AnswerCall removed and replaced with AnswerCall