CCaaS_GetRepresentativeAvailabilityForConversation

CCaaS_GetRepresentativeAvailabilityForConversation API を使用して、有効な会話 ID を使用してアクティブな会話中にキューとサービス担当者の可用性を取得します。

たとえば、IVR または AI エージェントとチャットしている顧客がサービス担当者にエスカレーションを要求すると、AI エージェントはこの API を呼び出してサービス担当者の可用性を判断し、応答に基づいて会話をルーティングします。

リクエストの詳細

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

Method

POST

バージョン

1.0

リクエストヘッダー

氏名 説明
Authorization 必須。 Contact Center インスタンスにおける API 呼び出し元の Microsoft Entra ID ベアラートークン。 API 承認用のセットアップ トークンの詳細

サンプル要求本文

説明 要求のサンプル
アクティブな会話のキューと担当者の可用性を判断します。 curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
ルートからキューへのルールでさらに多くのコンテキスト項目が必要な会話のキューと代表的な可用性を決定します。 curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
ルールはコンテキスト項目アンケート (種類: テキスト、値: インド) に基づきます。 curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

Note

  • 要求本文では、 CustomContextItems はルートからキューへの規則で使用されるコンテキスト項目を含む文字列です。 コンテキスト項目のサンプル リスト:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable は、コンテキスト項目が画面に表示されるかどうかを示します。 この値は True または False です。

  • datatype 指定できるのは Text = 192350000 または Integer = 192350001

応答

成功した場合、このメソッドは 200 OK 応答コードを返します。 このメソッドは、次の状態コードも返します。

HTTP 状態 説明
400 悪いリクエスト(入力パラメータが誤り)
401 無許可
404 リソースが見つかりません
429 レート制限(リクエストが多すぎる)
405 APIは許可されていません
500 サーバー内部エラー

応答値

氏名 タイプ 説明
queueId String ルーティング規則の構成と、ルーティング規則の一部であるエンティティ値やコンテキストなどの入力データに基づいて要求がルーティングされるターゲット キュー。
isQueueAvailable ブール値 キューが稼働時間内の場合は TRUE を表示します。 キューが稼働時間外である場合には FALSE になります。
次の運用時間の開始時刻 DateTime 現在、キューが稼働時間外である場合、その稼働時間の開始時刻 (UTC)。 営業時間中に 01-01-0001 を返します。
次の稼働時間の終了時刻 DateTime 現在稼働時間外の場合、キューの営業時間が終了する時刻 (UTC)。 営業時間中に 01-01-0001 を返します。
次の遷移時間 DateTime キューが営業時間外の場合に再び動作する時刻 (UTC)。 営業時間中は、キューが動作不能になったときに表示されます。
キュー内の位置 数 待機中の顧客が同じキュー内で他のユーザーの後ろにいる位置。
エージェントが利用可能か ブール値 表示：
  • キュー内のサービス担当者が現在、ワークストリームのルーティングと割り当て規則に基づいて要求を受け取れる場合は TRUE。
  • サービス担当者が要求を受け取ることができない場合は FALSE。
平均待ち時間 数 ターゲット キュー内の顧客の平均待機時間 (分)。
平均待ち時間 (秒単位) AverageWaitTimeInSeconds 数値 ターゲット キュー内の顧客の平均待機時間 (秒単位)。
キューにある利用可能な専門家の数 数値 ターゲット キュー内の会話を受け入れるために現在使用できるサービス担当者の数。

サンプル応答

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

代表的な可用性 API を使用する
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on