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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • エージェント API は、エージェントの在席状況とチャネルの可用性を取得または設定するためのメソッドを提供します。

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

    次のものが必要です。
    • 高度なワークアサインメントプラグイン (com.glide.awa)
    • ロール:awa_integration_user または admin

    エージェント:get(文字列 user_sys_id)

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

    表 : 1. パラメーター
    名前 タイプ 説明
    user_sys_id 文字列 テーブルにリストされているユーザーのsys_id sys_user。
    表 : 2. 返される内容
    タイプ 説明
    ブーリアン ユーザーが存在する場合は true、それ以外の場合は false。
    var agent = sn_awa.Agent.get("<user_sys_id>");
    var presence  = agent.getPresence();

    エージェント – getPresence()

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

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    オブジェクト 在席状況sys_id、在席状況名、およびチャネル情報。それ以外の場合はエラーメッセージ。
    var agent = sn_awa.Agent.get("<user_sys_id>");
            var presence  = agent.getPresence();

    エージェント – setPresence(Object setRequest)

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

    表 : 5. パラメーター
    名前 タイプ 説明
    setRequest オブジェクト setRequest.sys_id と setRequest.channels。
    setRequest.sys_id 文字列 AWA プレゼンスステータス [awa_presence_state] テーブルからのpresence_sys_id。
    setRequest.channels 名前/値ペア オプション。
    • 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
        }]
    });