getConversations (会話の取得)

Customer Service 用オムニチャネルには、Dynamics 365 Customer Service Enterprise の機能を拡張する一連の機能が用意されていて、組織はデジタル メッセージング チャネルを通して顧客と即座につながり、やり取りできるようになります。 Customer Service 用オムニチャネルにアクセスする際は、追加のライセンスが必要です。 詳細については、Dynamics 365 Customer Service 価格の概要 と Dynamics 365 Customer Service 価格プラン ページを参照してください。

この関数は、エージェントの会話 (msdyn_ocliveworkitem) レコードのリストを取得するために使用できます。

構文

Microsoft.Omnichannel.getConversations(input, correlationId);

パラメーター

パラメーター タイプ Description
入力 String JSON 入力。 次の形式があります。
{attributes, agentID, status, orderBy, createdBeforeDays}
、ここで:
  • attributesは、エンティティ属性名を含む文字列の配列です。
  • agentId は、エージェントの一意の識別子を含む文字列です。
  • status は、カンマ区切りの値を持つ文字列の配列です。
  • orderBy は、次の形式のオブジェクトの配列です。
    [{ attributeName: "<Attribute_Name>" descending:<ブール値>}]
  • createdBeforeDaysは、会話が作成されてからの日数です

agentIdは唯一の必須入力変数であり、残りはオプションです。
correlationId String Optional. テレメトリ ログの一意の識別子。

戻り値

操作の結果に基づいて、解決済みまたは拒否されたプロミスを返します。

注

呼び出し元が入力で属性を渡さなくても、関数は次の既定の属性を持つレコードを返します。

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • ステータスコード
  • 作成日

Example

次のコード スニペットは、指定されたエージェント ID の現在待機中の会話をフェッチします。

var input = { 
    "attributes": [
        "msdyn_title",
        "msdyn_channel"
        ],
    "agentId": "2b330c52-6844-4d36-8e05-03c78c9681dc",
    "status": [3], 
    "orderBy": [
        { 
            "attributeName": "createdon",
            "descending": true
        }
    ]
};
Microsoft.Omnichannel.getConversations(input).then(result => {
    console.log("result is as:", result); 
    }, (error) => {
        console.log("error is as:", error); 
    }
);

ライブ チャット リファレンス
オムニチャネル JavaScript API リファレンス
getConversationId です。
会話へのリンク
unlinkFromConversation (会話からリンク解除)
open会話
メッセージへの会話の送信

  • Last updated on