使用可能な問い合わせ属性とその JSONPath リファレンスのリスト - Amazon Connect

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

使用可能な問い合わせ属性とその JSONPath リファレンスのリスト

次の表に、 で使用できる問い合わせ属性を示しますAmazon Connect。

動的テキスト文字列[プロンプトの再生] ブロックで動的テキスト文字列を作成するを作成できるように、各属性の JSONPath リファレンスが用意されています。

システム属性

これらは、Amazon Connect に定義済みの属性です。システム属性は参照できますが、作成することはできません。

問い合わせフロー内のすべてのブロックがシステム属性を使用してサポートするわけではありません。たとえば、お客様の入力を保存するためにシステム属性を使用することはできません。お客様が入力したデータを保存するには、ユーザーが定義した属性を使用します。

属性 説明 タイプ JSONPath 参照

お客様番号

お客様の電話番号。

アウトバウンドウィスパーフローで使用する場合、これは顧客に連絡するためにエージェントがダイヤルした番号です。インバウンドフローで使用した場合、これは顧客が電話をかけた番号です。この属性は、問い合わせトレースレコード (CTRs) に含まれています。Lambda 関数で使用するとCustomerEndpoint の入力オブジェクトに含まれます。

システム

$.CustomerEndpoint.Address

ダイヤルした番号

お客様がコンタクトセンターに電話するためにダイヤルした番号。

この属性は CTRsに含まれています。Lambda 関数で使用するとSystemEndpoint の入力オブジェクトに含まれます。

システム

$.SystemEndpoint.Address

お客様のコールバック番号

がお客様にコールバックAmazon Connectするために使用する番号。

この番号は、キューに入れられたコールバックに使用する番号、またはエージェントが CCP からダイヤルするときに使用できます。コールバックキュー機能への転送、または CCP からダイヤルするエージェント用。

デフォルト値は、顧客がコンタクトセンターに連絡するために使用した番号です。ただし、[コールバック番号の設定] ブロックで上書きできます。

この属性は CTRsに含まれず、Lambda 入力でアクセスできません。ただしCTRs に含まれる [問い合わせ属性の設定] ブロックを使用して、属性をユーザー定義属性にコピーできます。また、この属性をCTRs に含まれていない [Lambda 関数を呼び出す] ブロックで AWS Lambda 入力パラメータとして渡すこともできます。

システム

該当なし

保存済みのお客様の入力

最近の [顧客の入力を保存する] ブロックから作成される属性。

最近の [顧客の入力を保存する] ブロック呼び出しから作成された属性値。この属性は CTRsに含まれず、Lambda 入力でアクセスできません。この属性は、CTR に含まれている [問い合わせ属性の設定] ブロックを使用してユーザー定義属性にコピーできます。この属性は、[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。ReferenceKey.Value および $.References。ReferenceKey.Type です。ReferenceKey はユーザー定義の [参照名] です。

言語

コンテンツの言語。

標準の 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

To

リクエストの着信側または受信側に関する情報。

システム

$.Media.Sip.Headers.To

ISUP-OLI

発信ラインインジケータ (OLI)。コールを発信するラインのタイプ (PSTN、800 サービスコール、ワイヤレス/セル PCS、有料電話など) を表示します。

システム

$.Media.Sip.Headers.ISUP-OLI

ジップ

管轄表示パラメータ (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

コール転送インジケータ (たとえば、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 ボットから返された最後のダイアログの状態。インテントが問い合わせフローに返された場合、値は「受理済み」です。

該当なし (UI にタイプが表示されない)

$.Lex.dialogState

インテント名

Amazon Lex によって返されるユーザーのインテント。

システム

$.Lex.IntentName

スロット

やり取り中にユーザー入力から Amazon Lex が検出したインテントのスロットのマップ (キー/値のペア)。

Lex スロット

$.Lex.Slots.slotName

セッション属性

セッション固有のコンテキスト情報を表すキーと値のペアのマップ。

Lex 属性

$.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 関数を呼び出すを参照してください。

これらの属性は、CTR に含まれておらず、次の Lambda 呼び出しで渡されず、スクリーンポップ情報の CCP に渡されません。ただし、[ Lambda関数を呼び出す] AWS Lambda ブロックで関数入力として渡すことも、[問い合わせ属性の設定] ブロックを介してユーザー定義属性にコピーすることもできます。[問い合わせ属性の設定] ブロックで使用されると、コピーされた属性は CTR に含まれ、CCP で使用できます。

ユーザー定義属性

他のすべての属性では、キーと値Amazon Connectを定義します。ただし、ユーザー定義属性の場合は、キーと値の名前を指定します。

問い合わせフローに値を保存する状況でユーザー定義属性を使用し、後でそれらの値を参照します。たとえば、 Amazon Connect と CRM またはその他のシステムを統合する場合、お客様のメンバー番号など、お客様からの入力を入手することをお勧めします。その後、そのメンバー番号を使用して CRM からメンバーに関する情報を取得し、問い合わせフロー全体でメンバー番号を使用することができます。

属性

説明

タイプ

JSONPath 参照

選択した任意の名前

ユーザー定義属性には 2 つの部分があります。

  • 宛先キー: キーに選択する任意の名前です。

  • 値: これは、任意の値を選択できます。必要であれば、ここに小説全体を入力できます。

ユーザー定義

$.Attributes.name_of_Your_destination_key

ユーザー定義属性を作成するには、 問い合わせ属性の設定 ブロックを使用します。