Answer Call - Answer Call

リファレンス

サービス:: Communication

API バージョン:: 2024-09-15

Event Grid から IncomingCallContext を使用して呼び出しに応答します。

POST {endpoint}/calling/callConnections:answer?api-version=2024-09-15

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (url)	Azure Communication リソースのエンドポイント。
api-version	query	True	string	呼び出す API のバージョン。

要求ヘッダー

名前	必須	型	説明
Authorization	True	string	Azure Communication Services ユーザーアクセストークン。
Repeatability-Request-ID		string (uuid)	指定した場合、クライアントは要求が繰り返し可能であることを指示します。つまり、クライアントは同じ Repeatability -Request-Id で要求を複数回行い、サーバーが要求を複数回実行せずに適切な応答を返すことができます。 Repeatability-Request-Id の値は、クライアントによって生成された要求の一意識別子を表す不透明な文字列です。これはバージョン 4 (ランダム) UUID です。
Repeatability-First-Sent		string (date-time-rfc1123)	Repeatability-Request-ID ヘッダーを指定する場合は、Repeatability-First-Sent ヘッダーも指定する必要があります。値は、要求が最初に作成された日時で、HTTP 日付の IMF-fixdate 形式を使用して表されます。例: Sun, 06 Nov 1994 08:49:37 GMT.

要求本文

名前	必須	型	説明
callbackUri	True	string	コールバック URI。
incomingCallContext	True	string	呼び出しに関連付けられているコンテキスト。
answeredBy		CommunicationUserIdentifierModel
callIntelligenceOptions		CallIntelligenceOptions	通話の AI オプション。
operationContext		string	通話の応答を追跡するために使用される顧客セット値。

応答

名前	型	説明
200 OK	CallConnectionProperties	AnswerCall 要求がサービスによって受信されると、呼び出しプロパティの詳細を返します。呼び出しが接続されると、指定したコールバック URI で CallConnected イベントを受信します。
Other Status Codes	CommunicationErrorResponse	エラー

セキュリティ

Authorization

Azure Communication Services ユーザーアクセストークン。

型: apiKey
/: header

例

AnswerCall

要求のサンプル

HTTP

POST https://contoso.communications.azure.com/calling/callConnections:answer?api-version=2024-09-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"
}

応答のサンプル

状態コード:: 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"
}

定義

名前	説明
AnswerCallRequest	呼び出しに応答するための要求ペイロード。
CallConnectionProperties	呼び出し接続のプロパティ
CallConnectionStateModel	呼び出し接続の状態。
CallIntelligenceOptions	通話の AI オプション。

AnswerCallRequest

Object

呼び出しに応答するための要求ペイロード。

名前	型	説明
answeredBy	CommunicationUserIdentifierModel
callIntelligenceOptions	CallIntelligenceOptions	通話の AI オプション。
callbackUri	string	コールバック URI。
incomingCallContext	string	呼び出しに関連付けられているコンテキスト。
operationContext	string	通話の応答を追跡するために使用される顧客セット値。

CallConnectionProperties

Object

呼び出し接続のプロパティ

名前	型	説明
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	呼び出し接続 ID。
callConnectionState	CallConnectionStateModel	呼び出し接続の状態。
callbackUri	string	コールバック URI。
correlationId	string	関連付け ID。
serverCallId	string	サーバー呼び出し ID。
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	pstn 番号にダイヤルアウトする場合の通話の表示名。
targets	CommunicationIdentifierModel[]	呼び出しのターゲット。

CallConnectionStateModel

列挙

呼び出し接続の状態。

値	説明
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

CallIntelligenceOptions

Object

通話の AI オプション。

名前	型	説明
cognitiveServicesEndpoint	string	この呼び出しに割り当てられている Cognitive Service リソースの識別子。

次の方法で共有

Answer Call - Answer Call

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

Authorization

例

AnswerCall

要求のサンプル

応答のサンプル

定義

AnswerCallRequest

CallConnectionProperties

CallConnectionStateModel

CallIntelligenceOptions