- 名前: スクリプトを識別するための社内用の表示名を入力します。
- 言語: スクリプト言語を選択します。
結果は [結果] セクションに表示されます。
- 鉛筆アイコン
: スクリプトを編集します。 - ゴミ箱アイコン
: スクリプトを削除します。
- 成功: スクリプトが正常に実行できる場合、宛先ウィジェットを選択します。
- 失敗: スクリプトが実行に失敗した場合、宛先ウィジェットを選択します。
コンタクトセンターの管理者はスクリプトウィジェットを追加および編集できます。スクリプトウィジェットを使用すると、フローで特定の行動を取ることができるので、UIに依存してフローを構築する必要がなくなります。スクリプトウィジェットでは、キー、シークレット、その他の認証情報はデフォルトで非表示になっています。
: スクリプトを編集します。: スクリプトを削除します。注: スクリプトウィジェットをより詳しく理解するには、構成例をご覧ください。
スクリプトウィジェットを構成して実行したら、スクリプト変数値をフロー変数にマッピングできます。
変数は、スクリプトウィジェットをカスタマイズする際に、出力変数セクションでマッピングすることもできます。
詳しくは、アカウント番号の例をご覧ください。
async function main () {
// your code starts here
}
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)
注: 現時点では、上記の組み込み関数のみが利用可能です。外部モジュールはサポートされていません。
以下に示すように、組み込み関数「log」を活用するとスクリプトに情報を記録できます。ログを表示するには、フローデバッグコンソールを有効にする必要があります。
以下の関数を使用してログを実装します。
log.debug("debugging enabled")
log.error("error detected")
log.info("info: yes")
log.warn("WARNINGS: ")
スクリプトウィジェットを使用してHTTPリクエストを送信できます。スクリプトウィジェットのJavaScriptコードを使用すると、組み込み関数「req」を使用してHTTPリクエストを送信できます。
注: 標準のHttp呼出ウィジェットを使用してHTTPリクエストを実装すると、JavaScript関数を記述しなくてもHTTPリクエストを実行できます。ただし、より高度なユースケースでは、スクリプトウィジェットと「req」組み込み関数を使用してHTTPリクエストを実行できます。
以下はHTTPリクエストの例です。
const response = await req.get("https://api.example.com")
詳しくは、Axiosサポートサイトを参照してください。
以下に示すように、組み込み関数「var_get」を利用することで、スクリプトの変数情報を取得できます。一般的な使用例としては、グローバル変数データをスクリプトコードに読み込み、変数値に基づいてアクションを実行することが挙げられます。これを行うには、グローバル変数を読み取り、それをスクリプトで一時的にアクセス / 保存します。
var_get関数を使用して、変数の値を取得します。var_get関数は、ローカル変数とグローバル変数の両方の値にアクセスできます。
グローバルシステム変数の読み取り例:
let first_name = var_get()["global_system.Consumer.firstName"]
グローバルカスタム変数の読み取り例:
let account_number = var_get()['global_custom.General.account_number']
注: システムグローバル変数はデフォルトで定義されていますが、グローバルカスタムグローバル変数を最初に定義する必要があります。上記のグローバルカスタム変数の例では、「General」というカスタム変数グループが作成され、グループに「account_number」というカスタムグローバル変数が作成されます。
注: 値が複数のエンゲージメント間で共有されるかどうかなど、グローバル変数の詳細については、グローバル変数を参照し、「リンクされた値」、「デフォルト値」、「未定義」変数タイプの違いを確認してください。
スクリプトのローカル変数値は、下記の「var_set」組み込み関数を活用して設定できます。一般的な使用例としては、スクリプトで生成された一部のデータ（例: APIレスポンス）をローカル変数で保存することが挙げられます。
以下に示すように、「global_var_set」組み込み関数を利用して、スクリプトにグローバル変数の値を設定できます。一般的な使用例としては、スクリプトで生成された一部のデータ（例: API response）をグローバル変数に変換してZCCログで使用したり、Contact Centerエージェントに表示したりできます。
注: グローバル変数はシステムでグローバルに定義されていますが、フロー内でグローバル変数に設定した値は、アクティブエンゲージメントに範囲が限定されます。
スクリプトウィジェットの保存時に「最初の証明書を認証できません」という証明書エラーが発生した場合は、Qualys SSL TestにURLを入力して証明書チェーンを確認します。チェーンを検証できない場合、ウェブサイトの証明書に問題があります。
重要: