事前定義された変数

このヘルプページの情報は、CXone StudioDesktop Studioの両方に適用されます。

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

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

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

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

  1. Studioで、スクリプトを開きます。
  2. スクリプトキャンバスの空白部分をクリックしてから、Propertiesタブをクリックします。
  3. Inboundをクリックして展開し、以下のプロパティを入力します。

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

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

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

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

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

このセクションの変数を使用する前に、トレースツールを使用して、作業中のスクリプトに変数が存在することを確認してください。その変数がスクリプトに渡されていない場合や、アクションによって追加されていない場合に、事前定義された変数をスクリプトで使用すると、スクリプトが意図したとおりに機能しないことがあります。

可能であれば、スクリプト内の変数を、シミュレートされたインタラクションではなく、ライブのインタラクションを使用して検証してください。シミュレートされたインタラクションには、ライブのインタラクションにはない変数が含まれている可能性があります。同様に、ライブのインタラクションに、シミュレーションにはない変数が含まれていることもあります。

変数名 説明
__agentContactID エージェントアプリケーションセッションのセッションID。
__agentId インタラクションに応答するエージェントのID。この変数には、エージェントがインタラクションに応答するまで値はありません。
ANI

発信者の電話番号(北米番号計画形式)。これは、北米の電話番号の標準形式です。e164ANI変数には同じ数字が国際形式で格納されています。

この値は電話会社から提供されます。可能な値にはRestrictedAnonymousが含まれます。

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

同じ親を起点とするすべてのスクリプトを識別できるようにする一意の識別子。あるスクリプトが別のスクリプトをスポーンしたり、別のスクリプトから実行されたりするときに使われます。親スクリプトの場合、contactIdmasterIdは同じです。子スクリプトの場合、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 UptivityACDゲートフィルターとして使用されます。

_user1 - _user 8

これらの変数の値は、NICE UptivityUser 1からUser 8までのフィールドに入力するために使用されます。

User9

User9は厳密には変数ではありませんが、エージェントのユーザーアカウントから、具体的にはCustom 1プロパティの値を取得し、NICE UptivityUser 9フィールドに入力します。

User10 User10は厳密には変数ではありませんが、エージェントのユーザーアカウントから、具体的にはCustom 2プロパティの値を取得し、NICE UptivityUser 10フィールドに入力します。
_surveyDNIS

このはユーザーが作成した一意のIDで、NICE Uptivityアンケートを作成するときに割り当てられ、コールバック閉じた 顧客の順番を待ち行列に入れ、順番待ちの前に移動すると自動的に顧客に電話をかけます。中に実行するアンケートを決定するために使用されます。

_surveyCallbackDNIS

この値は、調査のコールバックで使用される番号です。この変数はNICE Uptivityサーベイにのみ使用されます。

_surveyCallbackANI

この値は、調査に使用されるコールバック中に表示される発信者IDです。この変数はNICE Uptivityサーベイにのみ使用されます。