「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」
使用可能な問い合わせ属性とそのJSONPathリファレンスのリスト
次の表に、 で使用できる問い合わせ属性を示しますAmazon Connect。
動的テキスト文字列JSONPathを作成できるように、各属性のリファレンスが用意されています。
システム属性
これらは、 に定義済みの属性です。Amazon Connect. システム属性は参照できますが、作成することはできません。
問い合わせフロー内のすべてのブロックがシステム属性を使用してサポートするわけではありません。たとえば、お客様の入力を保存するためにシステム属性を使用することはできません。お客様が入力したデータを保存するには、ユーザーが定義した属性を使用します。
属性 | 説明 | タイプ | JSONPath リファレンス |
---|---|---|---|
お客様番号 |
お客様の電話番号。 アウトバウンドウィスパーフローで使用する場合、これは顧客に連絡するためにエージェントがダイヤルした番号です。インバウンドフローで使用した場合、これは顧客が電話をかけた番号です。この属性は、問い合わせトレースレコード (CTRs) に含まれています。Lambda 関数で使用すると、 の入力オブジェクトに含まれますCustomerEndpoint。 |
システム |
$.CustomerEndpoint.Address |
ダイヤルした番号 |
お客様がコンタクトセンターに電話するためにダイヤルした番号。 この属性は に含まれていますCTRs。 Lambda 関数で使用すると、 の入力オブジェクトに含まれますSystemEndpoint。 |
システム |
$.SystemEndpoint.Address |
お客様のコールバック番号 |
がお客様にコールバックAmazon Connectするために使用する番号。 この番号は、キューに入れられたコールバックに使用される番号、またはエージェントが CCP からダイヤルするときに使用できます。コールバックキュー機能への転送、または CCP からダイヤルするエージェントの場合。 デフォルト値は、顧客がコンタクトセンターに連絡するために使用した番号です。ただし、[コールバック番号の設定] ブロックで上書きできます。 この属性は に含まれずCTRs、Lambda 入力でアクセスできません。ただし、 属性は、 に含まれる [問い合わせ属性の設定] ブロックを使用してユーザー定義属性にコピーできますCTRs。 この属性は、 に含まれていない [AWS Lambda 関数を呼び出す] ブロックで Lambda 入力パラメータとして渡すこともできますCTRs。 |
システム |
該当なし |
保存済みのお客様の入力 |
[顧客の入力を保存する] ブロックの最新の呼び出しから作成された属性。 最近の [顧客の入力を保存する] ブロック呼び出しから作成された属性値。この属性は に含まれずCTRs、Lambda 入力でアクセスできません。属性は、 に含まれている [問い合わせ属性の設定] ブロックを使用してユーザー定義属性にコピーできますCTRs。 この属性は、[AWS Lambda 関数を呼び出す] ブロックで AWS Lambda 入力パラメータとして渡すこともできます。 |
システム |
該当なし |
キュー名 |
キューの名前。 |
システム |
$.Queue.Name |
キュー ARN |
キューの ARN。 |
システム |
$.Queue.ARN |
キューのアウトバウンド番号 |
選択したキューのアウトバウンド発信者 ID 番号。この属性は、アウトバウンドウィスパー問い合わせフローでのみ使用できます。 |
システム |
|
テキスト読み上げの音声 |
問い合わせフローのテキスト読み上げに使用するAmazon Polly音声の名前。 |
システム |
$.TextToSpeechVoiceId |
連絡先 ID |
問い合わせの一意の識別子。 |
システム |
$.ContactId |
イニシャル問い合わせ ID |
お客様とコンタクトセンター間の最初のやり取りに関連付けられた問い合わせの一意の識別子。最初の問い合わせ ID を使用して、問い合わせフロー間の問い合わせを追跡します。 |
システム |
$.InitialContactId |
前の問い合わせ ID |
転送される前の問い合わせの一意の識別子。前の問い合わせ ID を使用して、問い合わせフロー間の問い合わせを追跡します。 |
システム |
$.PreviousContactId |
チャネル |
コンタクトセンターに連絡するために使用される方法 (音声またはチャット)。 |
システム |
$.Channel |
インスタンス ARN |
Amazon Connect インスタンスの ARN。 |
システム |
$.InstanceARN |
初期化メソッド |
問い合わせが開始された方法。有効な値は、INBOUND、OUTBOUND、TRANSFER、CALLBACK、QUEUE_TRANSFER、DISCONNECT、および API です。 |
システム |
$.InitiationMethod |
名前 |
タスクの名前。 |
システム |
$.Name |
説明 |
タスクの説明。 |
システム |
$.説明 |
参照 |
問い合わせに関連する他のドキュメントへのリンク。 |
システム |
$.References。 |
言語 |
コンテンツの言語。 標準の java.util.Locale を使用します。たとえば、米国英語の場合は en-US、日本語の場合は jp-JP などです。 |
システム |
$.LanguageCode |
システムエンドポイントタイプ |
システムエンドポイントのタイプ。有効な値は TELEPHONE_NUMBER です。 |
システム |
$.SystemEndpoint.Type |
カスタマーエンドポイントタイプ |
カスタマーエンドポイントのタイプ。有効な値は TELEPHONE_NUMBER です。 |
システム |
$.CustomerEndpoint.Type |
キューのアウトバウンド発信者 ID 番号 |
アウトバウンド発信者 ID 番号はキューに対して定義されます。カスタム発信者 ID を設定した後に発信者 ID を復元するのに便利です。 |
システム |
$.Queue.OutboundCallerId.Address |
キューのアウトバウンド発信者 ID 番号タイプ |
キューのアウトバウンド発信者 ID 番号のタイプ。有効な値は TELEPHONE_NUMBER です。 |
システム |
$.Queue.OutboundCallerId.Type |
エージェントの属性
次の表に、 で利用できるエージェントの属性を一覧表示します。Amazon Connect.
属性 | 説明 | タイプ | JSONPath リファレンス |
---|---|---|---|
エージェントユーザー名 |
エージェントが にログインするために使用するユーザー名。Amazon Connect. |
システム |
$.Agent.UserName |
エージェントの名 |
Amazon Connect ユーザーアカウントに入力されているエージェントの名。 |
システム |
$.Agent.FirstName |
エージェントの姓 |
Amazon Connect ユーザーアカウントに入力されているエージェントの姓。 |
システム |
$.Agent.LastName |
エージェント ARN |
エージェントの ARN。 |
システム |
$.Agent.ARN |
[エージェントへの転送] フローでエージェントの問い合わせ属性を使用すると、エージェント属性には、転送を開始したエージェントではなく、ターゲットエージェントが反映されます。
エージェント属性は、次のタイプのコンタクトフローでのみ使用できます。
-
エージェントウィスパー
-
顧客ウィスパー
-
エージェント保留
-
顧客ウィスパー
-
発信ウィスパー
-
エージェントへの転送。この場合、エージェント属性には、転送を開始したエージェントではなく、ターゲットエージェントが反映されます。
エージェント属性は、次のコンタクトフロータイプでは使用できません。
-
顧客キュー
-
キューへの転送
-
着信コンタクトフロー
キュー属性
これらのシステム属性は、問い合わせフローで [キューメトリクスの取得] ブロックを使用するときに返されます。
コンタクトセンターで現在のアクティビティがない場合、これらの属性に対して NULL 値が返されます。
属性 | 説明 | タイプ | JSONPath リファレンス |
---|---|---|---|
キュー名 |
メトリクスが取得されたキューの名前。 |
システム |
$.Metrics.Queue.Name |
キュー ARN |
メトリクスが取得されたキューの ARN。 |
システム |
$.Metrics.Queue.ARN |
キュー内の問い合わせ |
現在キュー内にある問い合わせの数。 |
システム |
$.Metrics.Queue.Size |
キューの最も古い問い合わせ |
最も長くキューに入っている問い合わせの場合は、問い合わせがキューに入っている時間の長さ (秒単位)。 |
システム |
$.Metrics.Queue.OldestContactAge |
オンラインエージェント |
現在オンライン、つまり、ログインしていて、オフライン以外の何らかの状態にあるエージェントの数。 |
システム |
$.Metrics.Agents.Online.Count |
使用可能なエージェント |
状態が [Available] に設定されているエージェントの数。 |
システム |
$.Metrics.Agents.Available.Count |
対応エージェント |
現在対応可能なエージェントの数。対応可能とは、ログインしていて、[Available]、[ACW] または [Busy] 状態にあるエージェントです。 |
システム |
$.Metrics.Agents.Staffed.Count |
連絡作業後のエージェント |
現在 ACW 状態にあるエージェントの数。 |
システム |
$.Metrics.Agents.AfterContactWork.Count |
ビジー状態のエージェント |
現在、問い合わせに対応中のエージェントの数。 |
システム |
$.Metrics.Agents.Busy.Count |
不在のエージェント数 |
[Missed] 状態のエージェント数。エージェントは、不在問い合わせの後、この状態に入ります。 |
システム |
$.Metrics.Agents.Missed.Count |
非生産的な状態にあるエージェント |
非生産的 (NPT) 状態にあるエージェントの数。 |
システム |
$.Metrics.Agents.NonProductive.Count |
テレフォニーコールメタデータ属性 (コール属性)
テレフォニーメタデータは、テレフォニーキャリアからの発信に関連する追加情報を提供します。
属性 |
説明 |
タイプ |
JSONPath リファレンス |
---|---|---|---|
P-Asserted-Identity |
エンドユーザーのソース。 |
システム |
$.Media.Sip.Headers.P-Asserted-Identity |
P-Charge-Info |
通話に関連する料金の責任者。 |
システム |
$.Media.Sip.Headers.P-Charge-Info |
From |
リクエストに関連付けられたエンドユーザーの ID。 |
システム |
$.Media.Sip.Headers.From |
送信先 |
リクエストの着信側または受信側に関する情報。 |
システム |
$.Media.Sip.Headers.To |
ISUP-OLI |
発信ラインインジケータ (OLI)。コールを発信するラインのタイプ (PSTN、800 サービスコール、ワイヤレス/セル PCS、Payphone など) を表示します。 |
システム |
$.Media.Sip.Headers.ISUP-OLI |
JIP |
管轄表示パラメータ (JIP)。発信者/スイッチの地理的場所を示します。 値の例: 212555 |
システム |
$.Media.Sip.Headers.JIP |
ホップカウンタ |
ホップカウンター。 値の例: 0 |
システム |
$.Media.Sip.Headers.Hop-Counter |
発信元スイッチ |
発信元スイッチ。 値の例: 710 |
システム |
$.Media.Sip.Headers.Originating-Switch |
発生元 - 切り捨て |
Originating Trunk (ソースのトランク)。 値の例: 0235 |
システム |
$.Media.Sip.Headers.Originating-Trunk |
Call-Forwarding-Indicator |
Call Forwarding Indicators (たとえば、Diversion ヘッダー)。国内または国際通話の発信元を示します。 値の例: +15555555555@public-vip.us2.telphony-provider.com |
システム |
$.Media.SIP.Headers.Call-Forwarding-Indicator |
パーティ住所の呼び出し |
発信側住所 (数値)。NPAC dip は、実際のラインタイプとネイティブな地理的スイッチを示します。 値の例: 15555555555 |
システム |
$.Media.SIP.Headers.Calling-Party-Address |
着信側パーティアドレス |
発信元住所 (数値)。 値の例: 15555555555 |
システム |
$.Media.Sip.Headers.Called-Party-Address |
テレフォニーメタデータの可用性は、すべてのテレフォニープロバイダー間で一貫したものではなく、すべてのケースで利用できるとは限りません。これにより、空の値になる可能性があります。
メディアストリームの属性
次の表は、ライブメディアストリーム内で顧客の音声が開始/停止する位置を特定するための属性の一覧です。
属性 |
説明 |
タイプ |
JSONPath リファレンス |
---|---|---|---|
お客様のオーディオストリーム ARN |
参照する顧客データを含むライブメディアストリーミングに使用される Kinesis ビデオストリームの ARN。 |
メディアストリーム |
$.MediaStreams.Customer.Audio.StreamARN |
ライブメディアストリーミングに使用される Kinesis ビデオストリームのお客様のオーディオ開始タイムスタンプ。 |
お客様のオーディオストリームが開始された時刻。 |
メディアストリーム |
$.MediaStreams.Customer.Audio.StartTimestamp |
お客様のオーディオ停止タイムスタンプ |
ライブメディアストリーミングに使用された Kinesis ビデオストリームがお客様のオーディオストリームによって停止された時刻。 |
メディアストリーム |
$.MediaStreams.Customer.Audio.StopTimestamp |
お客様のオーディオ開始フラグメント番号 |
お客様のオーディオストリームが開始された、ライブメディアストリーミングに使用されるストリームの Kinesis ビデオストリームのフラグメントを識別する番号。 |
メディアストリーム |
$.MediaStreams.Customer.Audio.StartFragmentNumber |
Amazon Lex 問い合わせ属性
次の表に、 Amazon Lex ボットから返される属性を示します。
属性 | 説明 | タイプ | JSONPath リファレンス |
---|---|---|---|
ダイアログ状態 |
Amazon Lex ボットから返された最後のダイアログの状態。インテントが問い合わせフローに返された場合、値は「受理済み」です。 |
外部 |
$.Lex.dialogState |
インテント名 |
によって返されるユーザーのインテント。Amazon Lex. |
外部 |
$.Lex.IntentName |
スロット |
やり取り中にユーザー入力から Amazon Lex が検出したインテントのスロットのマップ (キー/値のペア)。 |
外部 |
$.Lex.Slots.slotName |
セッション属性 |
セッション固有のコンテキスト情報を表すキーと値のペアのマップ。 |
外部 |
$.Lex.SessionAttributes.attributeKey |
Lambda 問い合わせ属性
Lambda 属性は、[ 関数AWS Lambdaを呼び出す] ブロックの最新の呼び出しからキーと値のペアとして返されます。外部属性は、Lambda 関数の各呼び出しで上書きされます。
の外部属性を参照するにはJSONPath、以下を使用します。
-
$.External.attributeName
AttributeName
は属性名、または関数から返されたキーと値のペアのキーです。
たとえば、 関数が問い合わせ ID を返す場合、 属性を で参照
$.External.ContactId
します。 から返された問い合わせ ID を参照する場合Amazon Connect、 JSONPath は です$.ContactId
。
属性が の外部にある場合.External
、リファレンスJSONPathに が含まれることに注意してくださいAmazon Connect。外部ソースから返される属性名の大文字と小文字が一致していることを確認します。
Lambda 関数での属性の使用の詳細については、「」AWS Lambda 関数を呼び出すを参照してください。
これらの属性は に含まれておらずCTRs、次のLambda呼び出しには渡されず、スクリーンポップ情報の CCP には渡されません。ただし、[ Lambda関数を呼び出す] AWS Lambda ブロックで関数入力として渡すことも、[問い合わせ属性の設定] ブロックを介してユーザー定義属性にコピーすることもできます。[問い合わせ属性の設定] ブロックで使用すると、コピーされた属性は に含まれCTRs、CCP で使用できます。
ユーザー定義属性
他のすべての属性については、キー とキー が定義され、値 Amazon Connect が指定されています。ただし、ユーザー定義属性の場合は、キーと値の名前を指定します。
問い合わせフローに値を保存する状況でユーザー定義属性を使用し、後でそれらの値を参照します。たとえば、 Amazon Connect と CRM またはその他のシステムを統合する場合は、お客様のメンバー番号などの入力をお客様から取得することをお勧めします。その後、そのメンバー番号を使用して CRM からメンバーに関する情報を取得し、問い合わせフロー全体でメンバー番号を使用することができます。
属性 |
説明 |
タイプ |
JSONPath リファレンス |
---|---|---|---|
選択した任意の名前 |
ユーザー定義属性には 2 つの部分があります。
|
ユーザー定義 |
$.Attributes.name_of_your_destination_key |
ユーザー定義属性を作成するには、[問い合わせ属性の設定] ブロックを使用します。