事前定義された変数

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

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

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

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

1. Studioで、スクリプトを開きます。
2. スクリプトキャンバスの空白部分をクリックしてから、Propertiesタブをクリックします。

3. Inboundをクリックして展開し、以下のプロパティを入力します。

   • PhoneNumber：アクセスできる電話番号を入力します。
   • SimulateInbound：Trueを選択します。
   • SimulationANI：PhoneNumberプロパティで使用したのと同じ番号を入力します。
   • SimulationDNIS：もう1つ別の電話番号を入力します。本物の電話番号である必要はありません。
4. Studioツールバーで、Start with Traceをクリックします。
5. 電話が鳴ったら、応答します。スクリプトのさらに先にあるアクションによって追加された変数を確認するには、プロンプトに従ってください。スクリプトに渡されたシステム変数を確認するには、電話を切ることができます。

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

   画像の表示

   

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

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

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

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

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

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

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