エージェント - グローバル

エージェント API は、エージェントの在席状況とチャネルの可用性を取得または設定するためのメソッドを提供します。

エージェント API は、sn_awa 名前空間内で提供されます。

以下が必要です。

• 高度な作業アサインプラグイン (com.glide.awa)
• ロール：awa_integration_user または admin

Agent - get(文字列 user_sys_id)

sys_id によってエージェントを取得します。

表 : 1. パラメーター

名前	タイプ	説明
user_sys_id	文字列	sys_user テーブルに記載されているユーザーの sys_id。

表 : 2. 返される内容

タイプ	説明
ブーリアン	ユーザーが存在する場合は true、それ以外の場合は false。

var agent = sn_awa.Agent.get("<user_sys_id>");
var presence  = agent.getPresence();

Agent – getPresence()

指定されたエージェントの現在の在席状況とチャネルの可用性を取得します。

表 : 3. パラメーター

名前	タイプ	説明
なし

表 : 4. 返される内容

タイプ	説明
オブジェクト	在席状況 sys_id、在席状況名、チャネル情報。それ以外の場合はエラーメッセージ。

var agent = sn_awa.Agent.get("<user_sys_id>");
        var presence  = agent.getPresence();

Agent – setPresence(オブジェクト setRequest)

指定されたエージェントの在席状況を設定し、その状況でのエージェントのチャネルの可用性を設定します。

表 : 5. パラメーター

名前	タイプ	説明
setRequest	オブジェクト	setRequest.sys_id および setRequest.channels
setRequest.sys_id	文字列	AWA 在席状況 [awa_presence_state] テーブルからのpresence_sys_id。
setRequest.channel	名前/値ペア	オプション。 sys_id:awa_service_channelテーブルからのChannel_sys_id。 available:このチャネルの作業を受け取るためのエージェントの対応可能性 (true または false)。

表 : 6. 戻り値

タイプ	説明
ブーリアン	成功した場合は true、それ以外の場合は false。

var agent = sn_awa.Agent.get("<user_sys_id>");
var presence = agent.setPresence({
    sys_id: <presence_sys_id>,
    channels: [{
        sys_id: "<channel_sys_id>",
        available: true // or false
    }]
});