スクリプトウィジェットのカスタマイズ

コンタクトセンターの管理者はスクリプトウィジェットの追加と編集ができます。スクリプトウィジェットを使用すると、フローで特定の行動を起こせるようになるため、フローの構築を UI に依存する必要がなくなります。スクリプトウィジェットでは、キー、シークレット、その他の資格情報はデフォルトで非表示になっています。

重要:

2022 年 9 月 17 日に、Zoom Contact Center は、新たな構文を導入する新しいスクリプトエンジンを展開しました。既存のスクリプトは影響を受けません。ただし、新しいスクリプトウィジェットは新たな構文に従う必要があります。この記事では、新バージョンとラベル付けされたスクリプト例が、この新たな構文に従っています。
スクリプトウィジェットの使用方法の詳細を理解するには、設定例（英語）の記事を参照してください。

この記事では、次の項目について説明します。

スクリプトウィジェットの追加または編集方法
スクリプト変数のマッピング
- スクリプトマッピングの例
スクリプトのプログラム方法
- スクリプトプログラミングの例
ログ記録の使用方法
- ログ記録の例
HTTP リクエストの実装方法
スクリプトウィジェット内での変数の取得方法
スクリプトウィジェット内でのローカル変数の設定方法
スクリプトウィジェット内でのグローバル変数の設定方法

スクリプトウィジェットをカスタマイズするための前提条件

アカウントオーナーまたは管理者の特権
プロ、ビジネス、または教育機関向けアカウント
Zoom Contact Center ライセンス
音声、ビデオ、ウェブチャット、アプリ内チャット、または SMS フローが作成されていること
Javascript の高度な知識

スクリプトウィジェットの追加または編集方法

Zoom ウェブポータルにサインインします。
ナビゲーションメニューで、[コンタクトセンター管理]、[フロー] の順にクリックします。
フローの表示名をクリックして編集します。
左側のウィジェットパネルで、[スクリプト] をクリックしてから、フロー内の希望する場所にドラッグします。
[スクリプト] ウィジェットを選択します。
（オプション）[名前の変更] をクリックして、ウィジェットの表示名を変更します。
[スクリプトを追加] をクリックして新しいスクリプトをウィジェットに追加し、以下のオプションを指定します。
- 名前: スクリプトを識別する内部向けの表示名を入力します。
- 言語: スクリプトの言語を選択します。
[追加] をクリックします。
Javascript コードを入力します。
コードをローカルでテストするには、右側の [入力パラメータ] パネルを使用して、スクリプトのパラメータを JSON 形式で入力します。 JavaScript コードに、必要に応じて適切なキーと値のペアが含まれていることを確認してください。コードをローカルでテストする場合、予想されるすべてのキーと値のペアを入力パラメータとして指定する必要があります。
[実行] をクリックします。
[結果] セクションに結果が表示されます。
[閉じる] をクリックします。
[ドラフトを保存] をクリックしてスクリプトを保存します。
（オプション）[設定] タブで、以下のオプションをクリックします。
- 鉛筆アイコン : スクリプトを編集します。
- ゴミ箱アイコン : スクリプトを削除します。
[終了] タブをクリックして終了設定をカスタマイズします。
- 成功: スクリプトが正常に実行できる場合は宛先ウィジェットを選択します。
- 失敗: スクリプトが実行に失敗した場合は、宛先ウィジェットを選択します。

注: スクリプトウィジェットの使用方法の詳細を理解するには、設定例（英語）を参照してください。

スクリプト変数のマッピング

スクリプトウィジェットを設定して実行したら、スクリプト変数の値をフロー変数にマッピングできます。

スクリプトの var_set によって設定されたすべての変数は、ウィジェット名の下のフロー変数に設定されます。これはローカル変数と見なされます。
スクリプトによって返される変数は、ウィジェット名の下の value というフロー変数に設定されます。
global_var_set で設定されるすべての変数は、グローバルカスタム変数を使用して定義する必要があります。これらのグローバル変数は、完全なグローバル変数名で参照でき、global_var_set を使用してスクリプトウィジェット内で変更できます。

スクリプトマッピングの例

詳しくは、アカウント番号の例を参照してください。

スクリプトのプログラム方法

すべての依存関係をコードに追加します。以下のコード例の 2 ～ 4 行目を参照してください。
関数を module.exports に渡すと、コードエンジンが JS 関数を抽出します。関数に await が必要なときのみ、async を使用します。コードパネル内で関数を呼び出す必要はありません。
注: strict モード（厳格モード）は自動的にオンになります。

スクリプトプログラミングの例

新バージョン

async function main () {
  // ここからコードを開始
}

Note: 
#### Supported built-in functions: (no need to import again)

## Variable Get/Set:
var_get()[string]; var_set(string, string); global_var_set(string, string)

## Http Requests:
req.get(url[, config]); req.delete(url[, config]); req.head(url[, config]); req.options(url[, config])
req.post(url[, data[, config]]); req.put(url[, data[, config]]); req.patch(url[, data[, config]])

## Logging
log.debug(string), log.info(string), log.warn(string), log.error(string)

旧バージョン

// Lambda を使用

const log = require('./utils/log');
const req = require('axios'); // これは関数に Axios を使用する予定の場合のみ必要
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

module.exports = async () => {

// スクリプト ロジックを追加します。 上の 2 つの例を参照してください。

return
}

注: この時点では、Javascript のスクリプトウィジェットで使用できる外部モジュールは Axios のみです。

ログ記録の使用方法

次の関数を使用して、依存関係のインポートを追加します。

const log = require('./utils/log');

注: スクリプトエンジンの新バージョンの場合は組み込まれているため、再度インポートする必要はありません。

ログ記録の例

以下の関数を使用してログを実装できます。

log.debug("debugging enabled")
log.error("error detected")
log.info("info: yes")
log.warn("WARNINGS: ")

HTTP リクエストの実装方法

Axios を使用して HTTP リクエストを実装できます。詳しくは、Axios のサポートサイトを参照してください。

次の関数を使用して、依存関係のインポートを追加します。

const req = require('axios');

注:

スクリプトエンジンの新バージョンの場合は組み込まれているため、再度インポートする必要はありません。
標準の Http 通話ウィジェットを使用して、HTTP リクエストを実装できます。これにより、JavaScript 関数を記述しなくても HTTP リクエストを実行できます。ただし、より高度なユースケースでは、スクリプトと Axios モジュールを使用して HTTP リクエストを実行できます。

スクリプトウィジェット内での変数の取得方法

1. フロー内でスクリプトウィジェットを追加および設定します。
2. JavaScript ファイルを作成し、変数依存関係のインポートを追加します。
  例：
```
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set}
      = require('./utils/variable');
```

注: スクリプトエンジンの新バージョンの場合は組み込まれているため、再度インポートする必要はありません。

var_get 関数を使用して、変数の値を取得します。 var_get 関数は、ローカルウィジェットとグローバル変数の両方の値にアクセスできます。システムグローバル変数はデフォルトで定義されていますが、カスタムグローバル変数は最初に定義する必要があります。
例:
```
var_get()["global_system.Consumer.firstName"]
```

注: グローバル変数はシステムでグローバルに定義されますが、フロー内でグローバル変数に設定する値は、アクティブエンゲージメントに範囲が限定されます。つまり、フロー内でグローバル変数の値を設定 / 変更する場合、その値はその特定のエンゲージメントのみに設定されます。同じフロー内にほかのコンシューマーが同時に、または続いて存在する場合、ほかのエンゲージメントによって設定された更新済みのグローバル変数の値にアクセスすることはできません。

スクリプトウィジェット内でのローカル変数の設定方法

フロー内でスクリプトウィジェットを追加および設定します。この例では、スクリプトウィジェットの名前を Script から Script1 に変更します。
JavaScript ファイルを作成し、変数依存関係のインポートを追加します。依存関係のインポートを追加します。
例:
```
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');
```
注: スクリプトエンジンの新バージョンの場合は組み込まれているため、再度インポートする必要はありません。
var_set 関数を使用してローカル変数の値を設定します。最初のパラメータはローカル変数の完全な名前です。2 番目のパラメータは値です。
例：
```
var_set("account_number", “99999")
```
この変数の値はこのフロー内で、Script1.account_number としてアクセスできるようになりました。

スクリプトウィジェット内でのグローバル変数の設定方法

フロー内でスクリプトウィジェットを追加および設定します。
JavaScript ファイルを作成し、変数依存関係のインポートを追加します。
例:
```
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');
```
注: スクリプトエンジンの新バージョンの場合は組み込まれているため、再度インポートする必要はありません。
global_var_set 関数を使用してローカル変数の値を設定します。最初のパラメータはグローバル変数の完全な名前です。2 番目のパラメータは値です。
例:
```
global_var_set("global_system.Consumer.firstName", "Your Name")
```

注: グローバル変数はシステムでグローバルに定義されますが、フロー内でグローバル変数に設定する値は、アクティブエンゲージメントに範囲が限定されます。