事前定義された変数

事前定義された変数とは、すでに定義されているシステム変数のことです。 これらは作成しなくても、スクリプトの中で使用することができます。 事前定義された変数に対して予期される値は上書きできますが、推奨されません。 オンラインヘルプやアカウント担当者で指示がある場合のみ、これらを上書きしてください。

事前定義された変数は自動的にスクリプトに追加されます。 インタラクションがスクリプトにルーティングされる前に、バックグラウンドで実行されるシステムスクリプトから取得されるものもあります。 これらはシステム変数とも呼ばれます。 その他の事前定義された変数は、スクリプトに追加したアクションから取得されます。 スクリプト内の変数を表示するには、トレース ツールを使用できます。 トレース出力の各アクションをクリックすると、変数タブにその時点のスクリプト内のアクションが表示されます。

スクリプト内の事前定義された変数を表示する

トレースツールを使用すると、スクリプト内の変数を表示できます。 インタラクション中にスクリプトをトレースすると、そこに渡される変数を確認できます。 これらの変数は、システムスクリプトや、電話サービスプロバイダーなどの他のソースから得られます。 シミュレートされたインタラクションでは、スクリプトをトレースできますが、システムスクリプトから渡された変数しか見ることができません。 このセクションでは、シミュレートされたインバウンド電話スクリプトのトレースについて説明します。 他のインタラクションに対して トレースを実行することで、スクリプト内の定義済み変数を表示することもできます。

1. CXone Mpowerで、アプリセレクターをクリックし、選択します：オムニチャネルルーティング>Studio。
2. スクリプトページで、使用するスクリプトを見つけてダブルクリックして開くか、新しいスクリプトを作成します。 スクリプトが新しいタブで開きます。
3. トレース > トレースで開始をクリックします。
4. インバウンド電話ACD スキルを選択します。
5. 着信通話シミュレートを選択します。
6. スクリプトにダイヤルさせたいPhone Numberを入力します。 これは、テスト中に応答できる電話の番号でなければなりません。 この線は、組織に電話をかけているコンタクトを表しています。
7. このチャネルのDNISを入力します。 これは、コンタクトが組織に到達するためにダイヤルする番号です。 この番号にアクセスできる別の電話の電話番号を使用できます。 この線は、エージェントレッグ 通話やボイスメールのためにCXone Mpowerと接続されるエージェント側の音声接続。を表しています。
8. ANIを入力します。 ANIは、着信電話の発信元IDとしてリストされた電話番号です。 Phone Number フィールドで使用される番号と同じ番号にすることができます。
9. Start Traceをクリックします。
10. 電話が鳴ったら応答し、スクリプトのテストに必要なアクションを実行します。 たとえば、IVRをテストする場合は、この手順を各メニューオプションのテストに必要な回数繰り返します。

11. トレース出力ウィンドウで、Beginアクションをクリックします。 Variables タブには、システムスクリプトからスクリプトに渡されたすべての変数が表示されます。

    画像を表示

    

12. 変数をダブルクリックすると、変数の名前と値が表示されます。 これは、Value列に収まらない長い値を持つ変数に役立ちます。

    インタラクションの進行中にスクリプトに追加された追加の変数を確認する場合は、トレース出力ウィンドウのメイン セクションで他のアクションをクリックします。

一般的な事前定義された変数

次の表は、一般的な事前定義された変数の一部です。 すべてのスクリプトに、リストにあるすべての変数が含まれるわけではありません。 スクリプトで使用できる事前定義された変数は、スクリプトのメディアタイプやスクリプトで使用されるアクションによって変わります。 また、サービスプロバイダーが提供する変数もあります。 これらの変数は、プロバイダーによって異なる場合があります。

変数名	説明
__agentContactID	エージェントアプリケーションセッションのセッションID。
__agentId	インタラクションに応答するエージェントのID。 この変数には、エージェントがインタラクションに応答するまで値はありません。
ANI	発信者の電話番号（北米番号計画形式）。 これは、北米の電話番号の標準形式です。 e164ANI変数には同じ数字が国際形式で格納されています。 この値は電話会社から提供されます。 可能な値にはRestrictedとAnonymousが含まれます。
busno	ビジネスユニット CXone Mpowerシステムにおけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループ。の数。 これは、あなたのCXone Mpower システムの一意の識別子です。 組織に複数のビジネスユニットがある場合、スクリプトでこの値に基づいて論理判定を行うことができます。 たとえば、ACDスキル エージェントのスキル、能力、知識に基づいてインタラクションの配信を自動化するために使用されます。を割り当てる前にbusnoをチェックし、そのスキルがビジネスユニットに存在していることを確認できます。
contactId	各連絡先の一意の識別子。 contactIdを使用すると、特定の連絡先を検索して報告できます。 セカンダリスクリプトが生成されると、新しいcontactIdが作成されます。
city	コールが発生した市町村の名前。 インバウンドインタラクションの場合、この値はコンタクトのサービスプロバイダーから得られます。 アウトバウンドインタラクションの場合、この値はお使いのサービスプロバイダーから提供されます。
country	インバウンドコールまたはアウトバウンドコールの電話番号文字列で国コード（次の項目を参照）によって指定された国の名前。 CXone Mpowerテレフォニープラットフォームは、国際電気通信連合（ITU）の値に基づいてこれを自動的に生成し、通話のメタデータ 他のデータに関する情報を提供するデータ。で渡します。 インバウンドインタラクションの場合、この値はコンタクトのサービスプロバイダーから得られます。 アウトバウンドインタラクションの場合、この値はお使いのサービスプロバイダーから提供されます。
countryCode	着信コールの発信国または発信コールの宛先国を指定する国際電気通信連合（ITU）コード。 このコードは電話番号文字列の先頭に表示され、通話メタデータで渡されます。 たとえば、米国のITUコードは+1です。 特定の国の国コードを表示するには、国コード<country>をインターネットで検索します。 この形式は、コールの発信元によって異なります。 インバウンドインタラクションの場合、この値はコンタクトのサービスプロバイダーから得られます。 アウトバウンドインタラクションの場合、この値はお使いのサービスプロバイダーから提供されます。
DNIS	北米番号計画形式でダイヤルされた発信者の電話番号。 これは、北米の電話番号の標準形式です。 e164DNIS変数には同じ数字が国際形式で格納されています。
e164ANI e164DNIS	ANI 発信者IDとも呼ばれます。 着信音声通話のリストに表示される電話番号です。とDNIS インバウンドまたはアウトバウンドの音声通話でダイヤルされた番号。はE.164テレフォニーフォーマット標準に従ってフォーマットされています。 E.164は、米国外の電話番号をフォーマットするための国際規格です。
from	送信者のEメールアドレス。
__httpstatuscode	REST APIアクションが呼び出すサーバーから返される HTTP ステータス コード。
__httpstatusdescription	REST APIアクションが呼び出すサーバーから返される HTTP ステータスの説明。
isReskill	現在のコンタクトIDがリスキルされていることを示します。 値は1（true）または0（false）です。
__lastStateChange	コンタクトが最後に状態を変更したときのタイムスタンプ。 例えば、コンタクトがプレキュー状態からキュー待ち状態に変更されると、この変数にはその変更が行われた時刻のタイムスタンプが入力されます。
masterId	同じ親を起点とするすべてのスクリプトを識別できるようにする一意の識別子。 あるスクリプトが別のスクリプトをスポーンしたり、別のスクリプトから実行されたりするときに使われます。 親スクリプトの場合、contactIdとmasterIdは同じです。 子スクリプトの場合、contactIdは新しい一意の値になり、masterIdは親スクリプトのcontactIdと同じ値です。 例えば、インタラクションをリスキルする場合、リスキルされたインタラクションのmasterIdは、元のインタラクションのcontactIdと同じです。 インタラクションが2回目にリスキルされる場合、新しくリスキルされたインタラクションのmasterIdは、子スクリプトのcontactIdと同じです。
__mediaServerName	メディアサーバーの名前。 この変数は、CXone Mpowerテクニカルサポートと連携する際に、サーバー関連の問題をトラブルシューティングするのに役立ちます。 問題には、遠隔地の遅延や電話回線の問題などがあります。
__POC	連絡先 電話番号やEメールアドレスなど、インバウンドコンタクトがインタラクションを開始するために使用するエントリーポイント。の一意のID。 CXone MpowerACDアプリケーションのIDと一致します。
__SIPInvite	コンタクトのヘッダー情報を含みます。 あるビジネスユニットテナント CXone Mpowerシステムにおけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループ。からコールを転送する場合、この変数には元のコールに関する情報が含まれます。 たとえば、元のビジネスユニットから通話contactIDにアクセスできます。
__Skill	特定のACDスキル エージェントのスキル、能力、知識に基づいてインタラクションの配信を自動化するために使用されます。の一意の識別子。 __Skill変数を使用すると、特定のスキルを見つけてレポートすることができます。 この値は、Reqagentアクションによって変更される可能性があります。
__SkillName	ACDスキルの名前。 これは __Skillと一緒に使用され、Reqagentアクションで変更されることがあります。
state	発信者が住んでいるアメリカの州。 この値はコンタクトのサービスプロバイダーから得られます。
__targetScript	システムスクリプトが起動しているスクリプト。
test	この変数をアクションSnippetの外部で設定または使用しないでください。 これを行うと、深刻な結果を招く可能性があります。 これは、デバッグ コードデバッグ コードSnippet 用に予約されています。
to	宛先のEメールアドレス。

Uptivityからの事前定義された変数

変数名	説明
_customFilter	この変数の値は、UptivityのACDゲートフィルタとして使用されます。
_user1 - _user 8	これらの変数の値は、Uptivityのユーザー1からユーザー8のフィールドに入力するために使用されます。
User9	User9は厳密には変数ではありませんが、エージェントのユーザーアカウント、特にカスタム1プロパティの値から値を取得し、Uptivityのユーザー9フィールドに入力します。
User10	User10は厳密には変数ではありませんが、エージェントのユーザーアカウントから値、具体的にはカスタム2プロパティの値を取得し、Uptivityのユーザー10フィールドに入力します。
_surveyDNIS	この値は、ユーザー作成の一意のIDで、Uptivity調査を作成するときに割り当てられ、コールバック 顧客の順番をキューに保持し、キューの先頭に移動したときに自動的に顧客に電話をかけます。中に実行する調査を決定するために使用されます。
_surveyCallbackDNIS	この値は、調査のコールバックで使用される番号です。 この変数は、Uptivity調査でのみ使用します。
_surveyCallbackANI	この値は、調査に使用されるコールバック中に表示される発信元IDです。 この変数は、Uptivity調査でのみ使用します。