Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト - Amazon Connect

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

Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト

以下の表により、Amazon Connect で利用できる問い合わせ属性について説明します。

各属性の JSONPath 参照が提供されているため、それらを動的なテキスト文字列の作成に使用できます。

システム属性

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

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

属性 説明 タイプ JSONPath 参照

AWS リージョン

これを使用すると、問い合わせが処理されている AWS リージョン が返されます。例えば、us-west-2、us-east-1 などです。

システム

$.AwsRegion or $['AwsRegion']

顧客のメールアドレスまたは電話番号

顧客の電話番号、または E メールチャネルを使用している場合は E メールアドレス。

音声通話、SMS、WhatsApp ビジネスメッセージング、E メールでサポートされています。

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

システム

$.CustomerEndpoint.Address

カスタマー ID

顧客 ID 番号。例えば、CustomerId は、CRM からの顧客番号の場合もあります。CRM システムから発信者の一意の顧客 ID を取得するための Lambda 関数を作成できます。Voice ID は、この属性を発信者の CustomerSpeakerId として使用します。

システム

$.CustomerId

システムのアドレスまたは番号

音声通話、SMS、E メール、WhatsApp ビジネスメッセージングでサポートされています。

顧客がコンタクトセンターに電話をかけるためにダイヤルした番号、または E メールチャネルを使用している場合は顧客が E メールを送信した E メールアドレス。

この属性は、問い合わせレコードに含まれています。Lambda 関数で使用する場合には、SystemEndpoint にある入力オブジェクトに含まれています。

システム

$.SystemEndpoint.Address

顧客の表示名

コンタクトセンターに送信された E メールに表示される顧客の名前。

システム

$.CustomerEndpoint.DisplayName

システムの表示名

顧客が送信した E メールアドレスの表示名。

システム

$.SystemEndpoint.DisplayName

CC の E メールアドレスリスト

コンタクトセンターに送信されたインバウンド E メールの CC に含まれる E メールアドレスの完全なリスト。

システム

$.AdditionalEmailRecipients.CcList

To の E メールアドレスリスト

コンタクトセンターに送信されたインバウンド E メールの To に含まれる E メールアドレスの完全なリスト。

システム

$.AdditionalEmailRecipients.ToList

顧客のコールバック番号

Amazon Connect が、顧客に折り返し通話するために使用する電話番号。

この電話番号は、キューに登録された折り返し通話に使用される番号や、エージェントが CCP からダイヤルする際に使用される番号です。折り返し通話のキュー機能、または CCP からダイヤルするエージェントに対し転送します。

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

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

システム

該当なし

保存済みの顧客の入力

[顧客の入力を保存する] ブロックの直近の呼び出しで作成される属性。

この属性値は、[顧客の入力を保存する] ブロックの直近の呼び出しで作成されたものです。この属性は問い合わせレコードに含まれず、Lambda 入力でもアクセスできません。この属性は、コンタクトレコードに含まれている [コンタクト属性の設定] ブロックを使用してユーザー定義の属性にコピーできます。またこの属性は、[AWS Lambda 関数] ブロックに Lambda 入力パラメータとして渡すこともできます。

システム

$.StoredCustomerInput

キュー名

キューの名前。

システム

$.Queue.Name

キュー ARN

キューの ARN。

システム

$.Queue.ARN

アウトバウンドの番号をキューに登録する

選択されたキューへのアウトバウンド通話者 ID 番号の登録。この属性は、アウトバウンドのウィスパーフローでのみ使用可能です。

システム

テキスト読み上げの音声

問い合わせフローでテキスト読み上げ機能に使用する Amazon Polly 音声の名前。

システム

$.TextToSpeechVoiceId

問い合わせ ID

問い合わせの一意の識別子。

システム

$.ContactId

イニシャル問い合わせ ID

コンタクトのための (顧客とコンタクトセンターとの間で最初に行われた対話に関連付けられた) 一意の識別子。最初の問い合わせ ID を使用して、フロー間の問い合わせを追跡します。

システム

$.InitialContactId

タスク問い合わせ ID

タスク問い合わせの一意の識別子。タスク問い合わせ ID を使用して、フロー間の問い合わせを追跡します。

システム

$.Task.ContactId

前の問い合わせ ID

転送される前のコンタクトの一意の識別子。前の問い合わせ ID を使用して、フロー間の問い合わせを追跡します。

システム

$.PreviousContactId

[チャネル]

コンタクトセンターへのコンタクトに使用される手段 (VOICE、CHAT、TASK、または EMAIL)。

システム

$.Channel

インスタンス ARN

Amazon Connect インスタンスの ARN。

システム

$.InstanceARN

開始メソッド

コンタクトが開始された方法。有効な値は、INBOUND、OUTBOUND、TRANSFER、CALLBACK、QUEUE_TRANSFER、EXTERNAL_OUTBOUND、MONITOR、DISCONNECT、WEBRTC_API、API です。

システム

$.InitiationMethod

Name

タスクの名前。

システム

$.Name

説明

タスクの説明。

システム

$.Description

リファレンス

問い合わせに関連する他のドキュメントへのリンク。

システム

$.References.ReferenceKey. 値と、$.References.ReferenceKey. タイプ。ReferenceKey はユーザー定義の参照名に置き換えます。

Language

コンテンツの言語。

標準の java.util.Locale を使用します。例えば、米国英語の場合は en-US、日本語の場合は ja-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 でリソースにタグを追加する」と「Amazon Connect の使用状況を詳細に表示する詳細な請求を設定する」を参照してください。

システム

$.Tags

セグメント属性

セグメント属性とは、属性マップを使用して個別のコンタクトのセグメントに保存されるシステム定義のキーと値のペアのセットです。ただし、次の表に示すように、ユーザー定義のセグメント属性を作成することもできます。

属性 説明 許可される値 タイプ JSONPath 参照

connect:Subtype

コンタクトに使用されるチャネルのサブタイプを表します。

  • "connect:SMS"

  • "connect:WebRTC"

  • "connect:Guide"

  • "connect:Apple"

  • "connect:WhatsApp"

  • "connect:ExternalAudio"

  • "connect:Chat"

  • "connect:Telephony"

  • "connect:Task"

  • "connect:Email"

ValueString

$.SegmentAttributes['connect:Subtype']

connect:Direction

コンタクトの方向を表します。例えば、インバウンドまたはアウトバウンドです。

  • "INBOUND"

  • "OUTBOUND"

ValueString

$.SegmentAttributes['connect:Direction']

connect:CreatedByUser

タスクを作成したユーザーの ARN を表します。

ValueString

$.SegmentAttributes['connect:CreatedByUser']

connect:AssignmentType

タスクの割り当て方法を表します。

"SELF"

ValueString

$.SegmentAttributes['connect:AssignmentType']

connect:EmailSubject

E メールによるコンタクトの件名を表します。

ValueString

$.SegmentAttributes['connect:EmailSubject']

connect:ScreenSharingDetails

ScreenSharingDetails セクションには、コンタクトで実行された画面共有アクティビティに関する情報が含まれます。

ScreenSharingActivated キーは、コンタクトにおいて画面共有セッションがアクティブ化されているかどうかを示します。

"connect:ScreenSharingDetails": { "ScreensharingActivated" : "TRUE" // Allowed Values "TRUE" and "FALSE" }

ValueString

$.SegmentAttributes['connect:ScreenSharingDetails']

connect:ContactExpiry

タスクおよび E メールのコンタクトにおける ExpiryDurationExpiryTimeStamp など、コンタクトの有効期限に関する詳細が含まれます。

valueMap

$.SegmentAttributes['connect:ContactExpiry']

connect:CustomerAuthentication

チャットによるコンタクトの認証に関する詳細。

"connect:CustomerAuthentication": { "valueMap": { "IdentityProvider": { "ValueString": ""}, "ClientId": { "ValueString": ""}, "Status": { "ValueString": *AUTHENTICATED | FAILED | TIMEOUT*}, "AssociatedCustomerId": { "ValueString": ""} "AuthenticationMethod": { "ValueString": "*CONNECT" | "CUSTOM*" } } }

ValueMap

$.SegmentAttributes['connect:CustomerAuthentication']

connect:ValidationTestType

テストとシミュレーションのタイプを表します。このフィールドは、シミュレートされていない問い合わせでは空のままです。分析ダッシュボードでこの属性を使用して、実際の顧客の問い合わせを除外したり、問い合わせが問い合わせレコードオブジェクト内でシミュレートされているかどうかを特定したりできます。

「EXPERIENCE_VALIDATION」 ValueString $.Segment.Attributes['connect:ValidationTestType']

クライアント ID

Amazon Cognito アプリのクライアント識別子。

ValueString

$.SegmentAttributes['connect:CustomerAuthentication']['ClientId']

ID プロバイダー

顧客の認証に使用される ID プロバイダー。

ValueString

$.SegmentAttributes['connect:CustomerAuthentication']['IdentityProvider']

Status

認証プロセスのステータス。

AUTHENTICATED | FAILED | TIMEOUT

ValueString

$.SegmentAttributes['connect:CustomerAuthentication']['Status']

関連するカスタマー ID

顧客の識別子番号。これはカスタム識別子または顧客プロファイル識別子です。

ValueString

$.SegmentAttributes['connect:CustomerAuthentication']['AssociatedCustomerId']

認証方法

Amazon Connect が管理する認証ワークフローまたは顧客が管理する認証ワークフロー。

CONNECT | CUSTOM

ValueString

$.SegmentAttributes['connect:CustomerAuthentication']['AuthenticationMethod']

E メールの件名

顧客がコンタクトセンターに送信した E メールの件名。これは、E メールの件名で特定のキーワードを確認する場合に便利です。

セグメント属性

$.SegmentAttributes['connect:EmailSubject']

Amazon SES Spam Verdict

E メールがコンタクトセンターに着信すると、Amazon SES がスパムをスキャンします。FAILED 条件の有無をチェックして、E メールを削除するか、スーパーバイザーが確認できるように特別なキューに入れることができます。

セグメント属性

$.SegmentAttributes['connect:X-SES-SPAM-VERDICT']

Amazon SES Virus Verdict

E メールがコンタクトセンターに着信すると、Amazon SES がウイルスをスキャンします。FAILED 条件の有無をチェックして、E メールを削除するか、スーパーバイザーが確認できるように特別なキューに入れることができます。

セグメント属性

$.SegmentAttributes['connect:X-SES-VIRUS-VERDICT']

ユーザー定義の属性

任意のユーザー定義の属性を選択し、セグメント属性としてコンタクトに保存できます。属性を使用してコンタクトに値を保存するには、事前に属性を定義しておく必要があります。「コンタクトセグメント属性を使用する」を参照してください。

値が事前定義されていない場合、Amazon Connect はすべての文字列値を許可します。これは、[事前定義された属性を追加] ページで [有効な値の強制] オプションが選択されていない場合にも当てはまります。[有効な値の強制] オプションが選択され、値が事前定義されている場合、事前定義された属性キーの有効な値と事前定義された値のみが保存されます (API を使用している場合は、EnableValueValidationOnAssociation パラメータを参照してください)。

String

$.SegmentAttributes['Attribute_key_name']

ビューの属性

次の表に、Amazon Connect で利用できるビューの属性を一覧表示します。

属性 説明 タイプ JSONPath 参照

アクション

ビューを操作するユーザーによって実行されたアクション。アクションは [ビューを表示] ブロックでフローブランチとして表示されます

ビュー

$.Views.Action

結果データを表示

ユーザーがアクションを実行したコンポーネントに基づく、ビュー操作からの出力データ。

ビュー

$.Views.ViewResultData

機能の属性

次の表に、Amazon Connect で利用できる機能の属性を一覧表示します。これらの属性は、画面およびビデオ共有機能をサポートします。詳細については、「アプリ内通話、ウェブ通話、ビデオ通話機能、および画面共有のセットアップ」を参照してください。

属性 説明 タイプ JSONPath 参照

エージェント画面共有機能

参加者に対して有効になっている画面共有機能。

機能

$.Capabilities.Agent.ScreenShare

エージェントビデオ機能

通話中に参加者に対して有効になっているビデオ共有機能。

機能

$.Capabilities.Agent.Video

顧客画面共有機能

参加者に対して有効になっている画面共有機能。

機能

$.Capabilities.Customer.ScreenShare

顧客ビデオ機能

通話中に参加者に対して有効になっているビデオ共有機能。

機能

$.Capabilities.Customer.Video

エージェントの属性

次の表に、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-Charge-Info

通話に関連する料金の責任者。

システム

$.Media.Sip.Headers.P-Charge-Info

から

リクエストに関連付けられたエンドユーザーの ID。

システム

$.Media.Sip.Headers.From

まで

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

システム

$.Media.Sip.Headers.To

ISUP-OLI

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

システム

$.Media.Sip.Headers.ISUP-OLI

JIP

管轄区域表示パラメータ (JIP) 発信者/スイッチの地理的位置を表します。

値の例: 212555

システム

$.Media.Sip.Headers.JIP

ホップカウンター

ホップカウンター。

値の例:0

システム

$.Media.Sip.Headers.Hop-Counter

発信スイッチ

発信スイッチ。

値の例: 710

システム

$.Media.Sip.Headers.Originating-Switch

発信トランク

発信トランク。

値の例: 0235

システム

$.Media.Sip.Headers.Originating-Trunk

Call-Forwarding-Indicator

通話転送インジケータ (ディバージョンヘッダーなど) 国内または海外の通話の発信元を示します。

値の例:sip:+15555555555@public-vip.us2.telphony-provider.com;reason=unconditional

システム

$.Media.Sip.Headers.Call-Forwarding-Indicator

Calling-Party-Address

発信側アドレス (電話番号)。NPAC dip は、真のラインタイプと国内の地理的スイッチを示します。

値の例: 15555555555;noa=4

システム

$.Media.Sip.Headers.Calling-Party-Address

Called-Party-Address

着信側アドレス (電話番号)。

値の例: 15555555555;noa=4

システム

$.Media.Sip.Headers.Called-Party-Address

SIPREC メタデータ

Amazon Contact Lens コネクタが受信した SIPREC メタデータ XML

システム

$.Media.Sip.SiprecMetadata

注記

テレフォニーメタデータは、すべてのテレフォニープロバイダーで利用できるわけではなく、すべてのケースに対応するとは限りません。この値は空になることがあります。

チャット初期メッセージ属性

属性

説明

タイプ

JSONPath 参照

InitialMessage

ウェブチャットまたは SMS で顧客が送信した最初のメッセージ。

システム

$.Media.InitialMessage

E メール属性

次の表に、Amazon Connect で使用できる E メール属性を示します。

属性

説明

タイプ

JSONPath 参照

E メールメッセージ (プレーンテキスト)

保存済みコンテンツの取得フローブロックを使用すると、E メール連絡先からの E メールメッセージのプレーンテキストバージョンが保存されます。

システム

$.Email.EmailMessage.Plaintext

メディアストリームの属性

次の表は、ライブメディアストリーム内で顧客の音声が開始/停止する位置を特定するための属性の一覧です。

属性

説明

タイプ

JSONPath 参照

顧客のオーディオストリーム ARN

参照のための顧客データを含む、ライブメディアストリーミングに使用される Kinesis Video ストリームの ARN。

メディアストリーム

$.MediaStreams.Customer.Audio.StreamARN

ライブメディアストリーミングに使用される、顧客側 Kinesis ビデオストリームのオーディオ開始タイムスタンプ。

顧客のオーディオストリームが開始された時刻。

メディアストリーム

$.MediaStreams.Customer.Audio.StartTimestamp

顧客のオーディオ停止タイムスタンプ

ライブメディアストリーミングが使用している Kinesis ビデオストリームが、顧客側のオーディオストリームによって停止された時刻。

メディアストリーム

$.MediaStreams.Customer.Audio.StopTimestamp

顧客のオーディオ開始フラグメント番号

ライブメディアストリーミングで使用されているストリーム内にあり、顧客側のオーディオストリームの開始に使用された、Kinesis Video Streams のフラグメントを識別する番号。

メディアストリーム

$.MediaStreams.Customer.Audio.StartFragmentNumber

Amazon Lex 問い合わせ属性

次の表は、Amazon Lex ボットから返される属性の一覧です。これらはセッション属性とも呼ばれます。

属性 説明 タイプ JSONPath 参照

代替インテント

Amazon Lex から利用可能な代替インテントのリスト。各インテントには、対応する信頼スコアと入力するスロットがあります。

Lex

$.Lex.AlternativeIntents.x.IntentName

$.Lex.AlternativeIntents.x.IntentConfidence.Score

$.Lex.AlternativeIntents.x.Slots

$.Lex.AlternativeIntents.y.IntentName

$.Lex.AlternativeIntents.y.IntentConfidence.Score

$.Lex.AlternativeIntents.y.Slots

$.Lex.AlternativeIntents.z.IntentName

$.Lex.AlternativeIntents.z.IntentConfidence.Score

$.Lex.AlternativeIntents.z.Slots

xyz は Lex レスポンスのインテント名です。

インテントの信頼スコア

Amazon Lex によって返されるインテント信頼スコア。

Lex

$.Lex.IntentConfidence.Score

インテント名

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

Lex

$.Lex.IntentName

感情ラベル

Amazon Comprehend が最も信頼度が高いと推測されるセンチメント。

Lex

$.Lex.SentimentResponse.Label

感情スコア

センチメントが正しく推測された可能性。

Lex

$.Lex.SentimentResponse.Scores.Positive

$.Lex.SentimentResponse.Scores.Negative

$.Lex.SentimentResponse.Scores.Mixed

$.Lex.SentimentResponse.Scores.Neutral

セッション属性

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

Lex

$.Lex.SessionAttributes.attributeKey

Slots

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

Lex

$.Lex.Slots.slotName

ダイアログ状態

Amazon Lex ボットから返される最後のダイアログの状態。インテントがフローに返された場合、値は「受理済み」です。

該当なし (UI に表示されるタイプはなし)

$.Lex.dialogState

ケース問い合わせ属性

次の表では、Amazon Connect Cases で使用される属性を一覧表示しています。

属性 説明 タイプ JSONPath 参照 データソース

ケース ID

UUID 形式のケースの一意の識別子 (例: 689b0bea-aa29-4340-896d-4ca3ce9b6226) text

$.Case.case_id

Amazon Connect

ケースの理由

ケースをオープンした理由

single-select

$.Case.case_reason [エージェント]

お客様

API は顧客プロファイル ID です。[Cases: Fields] (Cases: フィールド) ページに、顧客の名前が表示されます。

text

$.Case.customer_id Amazon Connect

クローズ日時

ケースが最後にクローズされた日時。ケースがクローズされたことを保証するものではありません。ケースが再度オープンにされた場合、このフィールドには、ステータスが最後にクローズに変更されたときの日時のスタンプが含まれます。

date-time

$.Case.last_closed_datetime Amazon Connect

オープン日時

ケースがオープンされた日時。

date-time

$.Case.created_datetime Amazon Connect

更新日時

ケースが最後に更新された日時。

date-time

$.Case.last_updated_datetime Amazon Connect

参照番号

数字形式 (8 桁) のケースのわかりやすい番号。

参照番号は、(Case ID とは異なって) 一意であることが保証されません。顧客を特定してから、参照番号を収集して適切なケースを正しく見つけるようにすることをお勧めします。

text

$.Case.reference_number [エージェント]

Status

ケースの現在のステータス

text

$.Case.status [エージェント]

概要

ケースの概要

text

$.Case.summary [エージェント]

タイトル

ケースのタイトル

text

$.Case.title [エージェント]

Lambda での問い合わせ属性

Lambda の属性は、[AWS Lambda 関数] ブロックの直近の呼び出しからキーと値のペアとして返されます。Lambda の呼び出し属性は、Lambda 関数の呼び出しごとに上書きされます。

JSONPath で属性を参照するには、以下を使用します。

  • $.LambdaInvocation.ResultData.attributeName

この際、AttributeName は属性名、または関数から返されたキーと値のペアの中のキーの部分を意味します。

例えば、関数が問い合わせ ID を返した場合は、$.LambdaInvocation.ResultData.ContactId を使用して属性を参照します。Amazon Connect から返される問い合わせ ID を参照する場合の JSONPath は $.ContactId です。

Lambda 関数で属性を使用する方法の詳細については、「Amazon Connect の AWS Lambda 関数へのアクセスを付与する」を参照してください。

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

ユーザー定義の属性

その他のすべての属性については、Amazon Connect によってキーと値が定義されます。ただし、ユーザー定義の属性については、ユーザーがキーと値の名前を指定します。

問い合わせフローに値を格納し、それらの値を後で参照する場合は、ユーザー定義の属性を使用します。例えば、Amazon Connect と CRM などのシステムを統合する場合には、顧客にメンバー番号などの情報を入力してもらう必要があります。このメンバー番号は、メンバーに関する情報を CRM から取得するためや、フロー全体的のために使用することができます。

属性

説明

タイプ

JSONPath 参照

選択した任意の名前

ユーザー定義の属性は、以下の 2 つの部分で構成されます。

  • 送信先キー: キーに対して選択した任意の名前です。ただし、$ および . (ピリオド) 文字は、ともに JSONPath の属性パスを定義するために使用されるため使用できません。

  • 値: 任意の値を設定します。必要であれば、いくつかの段落を入力しテキスト文を構成することも可能です。(問い合わせレコード属性セクションの最大サイズについては、「Amazon Connect 機能の仕様」を参照してください。)

ユーザー定義

$.Attributes.name_of_your_destination_key

ユーザー定義の属性を作成するには、コンタクト属性の設定ブロックを使用します。

フロー属性

フロー属性はユーザー定義の属性に似ていますが、設定されたフローに制限されます。

フロー属性は、顧客のクレジットカード番号などの機密情報を使用して Lambda のデータディップを行う必要がある場合など、問い合わせ全体にわたってデータを保持したくない場合に役立ちます。

  • フロー属性は、ローカルに保存され、フローでのみ使用される一時変数です。問い合わせが別のフローに転送されても、フローの外側では見えません。

  • 最大サイズは 32 KB (コンタクトレコード属性セクションの最大サイズ) です。

  • [ AWS  Lambda 関数の呼び出し] ブロックで [パラメータを追加] を選択することによって、パラメータとして明示的に設定されない限り、Lambda には渡されません。

  • モジュールには渡されません。モジュール内でフロー属性を設定することはできますが、モジュールから渡されることはありません。

  • 問い合わせレコードには表示されません。

  • CCP のエージェントには表示されません。

  • GetContactAttributes API で公開することはできません。

  • フローでロギングを有効にしている場合、キーと値が Cloudwatch ログに表示されます。

属性

説明

タイプ

JSONPath 参照

選択した任意の名前

フロー属性には次の 2 つの部分があります。

  • 送信先キー: キーに対して選択した任意の名前です。ただし、$ および . (ピリオド) 文字は、ともに JSONPath の属性パスを定義するために使用されるため使用できません。

  • 値: 任意の値を設定します。

フロー

$.FlowAttributes.name_of_your_destination_key

フローモジュールの属性

フローモジュール Input 属性は、フローから入力スキーマを定義したモジュール、または Invoke Module ブロックを使用する別のモジュールに渡される属性です。フローモジュール Output 属性と Result 属性は、Invoke Module ブロックの最新の呼び出しから返されます。モジュール出力属性と結果属性は、モジュール関数の呼び出しごとに上書きされます。

これらの属性は問い合わせレコードに含まれず、次のモジュール呼び出しに渡されず、スクリーンポップ情報として CCP に渡されません。ただし、問い合わせ属性の設定ブロックを使用して、ユーザー定義属性にコピーできます。問い合わせ属性の設定ブロックで使用すると、コピーされた属性は問い合わせレコードに含まれ、CCP で使用できます。

次の表に、Amazon Connect で使用できるフローモジュールの属性を示します。

属性 説明 タイプ JSONPath 参照

Input

入力データは、モジュールに渡された入力へのアクセスを提供します。これは JSON オブジェクトとして返され、特定の形式はモジュール入力スキーマによって定義されます。

モジュール

$.Modules.Input

結果

結果データは、エラーブランチを除くモジュールから返されたブランチ名をキャプチャします。これは文字列として返されます。

モジュール

$.Modules.Result

出力 (UI からの属性参照)

出力データは、モジュールの実行から生成された結果データをキャプチャします。これは JSON オブジェクトとして返され、特定の形式はモジュール出力スキーマによって定義されます。

モジュール

$.Modules.ResultData

データテーブルの属性

データテーブルブロックオペレーションによって返される属性。これらを使用して、問い合わせフロー内のデータテーブルから取得したデータにアクセスします。

データテーブル値の属性を評価する

データテーブルブロックで評価アクションを使用して特定の属性値をクエリするときに返される属性。

  • クエリが結果を返さないか、 属性が見つからない場合、参照は空または null になります。

属性 説明 タイプ JSONPath 参照

データテーブルで評価されたクエリ結果

名前付きクエリによって取得された特定の属性の値。をクエリに割り当てられた一意の名前<QueryName>に置き換え、 を取得するために選択した属性の名前<AttributeName>に置き換えます。

データテーブル

$.DataTables.<QueryName>.<AttributeName>

データテーブル値の属性を一覧表示する

データテーブルブロックでリストアクションを使用して完全なレコードを取得したときに返される属性。

  • リストは、選択したレコードだけでなく、完全なレコード (すべての属性) を返します。

  • 一致するレコードが見つからない場合、primaryKeyGroups 配列は空になります。

  • プライマリキーグループが設定されていない場合、テーブル全体がロードされ、結果は「デフォルト」グループ名 でアクセスできます$.DataTableList.Result.primaryKeyGroups.default[index]

  • List 名前空間の最大データ制限は 32 KB です。

属性 説明 タイプ JSONPath 参照

データテーブル ID

レコードが取得されたデータテーブルの一意の識別子。

データテーブルリスト

$.DataTableList.Result.dataTableId

ロックバージョン

データテーブルのロックバージョン情報。

データテーブルリスト

$.DataTableList.Result.lockVersion.dataTable

デフォルトのグループ名

プライマリキーグループが設定されていない場合、テーブル全体がロードされ、結果は「デフォルト」グループ名でアクセスできます。

データテーブルリスト

$.DataTableList.Result.primaryKeyGroups.default[index]

プライマリキーグループ

プライマリ値グループ名別に整理された、取得されたレコードのコレクション。をプライマリ値グループに割り当てられた名前<GroupName>に置き換えます。

データテーブルリスト

$.DataTableList.Result.primaryKeyGroups.<GroupName>

特定の行

プライマリキーグループ内の特定の行にアクセスします。をグループ名<GroupName>に置き換え、 を行のゼロベースのインデックス[index]に置き換えます。

データテーブルリスト

$.DataTableList.Result.primaryKeyGroups.<GroupName>[インデックス]

プライマリキー値

特定の行のプライマリキー属性の値にアクセスします。

データテーブルリスト

$.DataTableList.Result.primaryKeyGroups.<GroupName>[index].primaryKeys[index].attributeValue

属性値

特定の行の非プライマリ属性の値にアクセスします。

データテーブルリスト

$.DataTableList.Result.primaryKeyGroups.<GroupName>[index].attributes[index].attributeValue

Apple Messages for Business の属性

Apple Messages for Business の顧客をルーティングするには、以下の問い合わせ属性を使用します。例えば、さまざまな基幹業務で Apple Messages for Business を使用している場合は、問い合わせ属性 AppleBusinessChatGroup に基づいて各フローへと分岐できます。また、Apple Messages for Business メッセージを他のチャットメッセージとは別個にルーティングしたい場合は、MessagingPlatform に基づいて分岐できます。

属性 説明 タイプ JSON

MessagingPlatform

顧客からの要求の発信元であるメッセージングプラットフォーム。

正確な値: AppleBusinessChat

ユーザー定義 $.Attributes.MessagingPlatform

AppleBusinessChatCustomerId

Apple から提供された、顧客の不明瞭な ID。この値は、AppleID とビジネスに対しては一定のままです。これを使用して、メッセージが新しい顧客からのものか、再訪した顧客からのものかを識別できます。

ユーザー定義 $.Attributes.AppleBusinessChatCustomerId

AppleBusinessChatIntent

チャットのインテント、あるいは目的を定義することができます。このパラメータは、顧客側で [ビジネスチャット] ボタンがクリックされている場合に、メッセージ内でチャットセッションを開始した URL の中に含まれます。

ユーザー定義 $.Attributes.AppleBusinessChatIntent

AppleBusinessChatGroup

顧客における特定の質問や問題を処理するのに最適な、部門または個人を指定するためのグループを定義します。このパラメータは、顧客側で [ビジネスチャット] ボタンがクリックされている場合に、メッセージ内でチャットセッションを開始した URL の中に含まれます。

ユーザー定義 $.Attributes.AppleBusinessChatGroup

AppleBusinessChatLocale

ユーザーがユーザーインターフェイスに表示する言語と AWS リージョンの設定を定義します。これは、言語識別子 (ISO 639-1) とリージョン識別子 (ISO 3166) で構成されます。例えば、en_US

ユーザー定義 $.Attributes.AppleBusinessChatLocale

AppleFormCapability

顧客のデバイスがフォームに対応しているか。

true の場合、顧客のデバイスは対応しています。

false の場合、デバイスは対応していません。

ユーザー定義 $.Attributes.AppleFormCapability

AppleAuthenticationCapability

顧客のデバイスが認証 (OAuth2) に対応しているかどうか。true の場合、顧客のデバイスは対応しています。false の場合、デバイスは対応していません。

ユーザー定義 $.Attributes.AppleAuthenticationCapability

AppleTimePickerCapability

カスタマーのデバイスがタイムピッカーをサポートしているか。

true の場合、顧客のデバイスは対応しています。

false の場合、デバイスは対応していません。

ユーザー定義 $.Attributes.AppleTimePickerCapability

AppleListPickerCapability

カスタマーのデバイスがリストピッカーをサポートしているか。

true の場合、顧客のデバイスは対応しています。

false の場合、デバイスは対応していません。

ユーザー定義 $.Attributes.AppleListPickerCapability

AppleQuickReplyCapability

カスタマーのデバイスがクイック返信をサポートしているか。

true の場合、顧客のデバイスは対応しています。

false の場合、デバイスは対応していません。

ユーザー定義 $.Attributes.AppleQuickReplyCapability

Customer Profiles の属性

Amazon Connect Customer Profiles で使用される属性の一覧は、次の表のとおりです。

Customer Profiles のコンタクト属性の合計サイズは、フロー全体で 14,000 文字 (各最大サイズを 255 と想定すると属性 56 個) に制限されます。これには、フロー中に Customer Profiles の [レスポンスフィールド] として保持されるすべての値が含まれます。

属性 説明 タイプ JSONPath 参照

profileSearchKey

プロファイルの検索に使用する属性の名前。

ユーザー定義

該当しない

profileSearchValue

顧客名やアカウント番号など、検索に使用するキーの値。

ユーザー定義

該当しない

プロファイル ID

お客様プロファイルの一意の識別子。

text

$.Customer.ProfileId

プロファイル ARN

顧客プロファイルの ARN。

text

$.Customer.ProfileARN

[First Name] (名)

お客様のファーストネーム。

text

$.Customer.FirstName

ミドルネーム

お客様のミドルネーム。

text

$.Customer.MiddleName

[Last Name] (姓)

お客様のラストネーム。

text

$.Customer.LastName

アカウント番号

お客様に付けた一意のアカウント番号。

text

$.Customer.AccountNumber

E メールアドレス

顧客のメールアドレス。個人用アドレスや業務アドレスとして指定されていないアドレス。

text

$.Customer.EmailAddress

電話番号

携帯番号、自宅番号、またはビジネス番号として指定されていないお客様の電話番号。

text

$.Customer.PhoneNumber

追加情報

お客様のプロファイルに関連する追加情報。

text

$.Customer.AdditionalInformation

関係者タイプ

顧客の関係者タイプ。

text

$.Customer.PartyType

ビジネス名

お客様のビジネスの名前。

text

$.Customer.BusinessName

生年月日

お客様の生年月日。

text

$.Customer.BirthDate

性別

顧客の性別。

text

$.Customer.Gender

携帯電話番号

お客様の携帯電話番号。

text

$.Customer.MobilePhoneNumber

自宅の電話番号

お客様の自宅電話番号。

text

$.Customer.HomePhoneNumber

勤務先の電話番号

お客様のビジネス電話番号。

text

$.Customer.BusinessPhoneNumber

勤務先の E メールアドレス

顧客の勤務先メールアドレス。

text

$.Customer.BusinessEmailAddress

Address

郵送用、配送用、請求用ではないお客様に関連付けられた一般的な住所。

text

$.Customer.Address1

$.Customer.Address2

$.Customer.Address3

$.Customer.Address4

$.Customer.City

$.Customer.County

$.Customer.Country

$.Customer.PostalCode

$.Customer.Province

$.Customer.State

配送先住所

お客様の配送先住所。

text

$.Customer.ShippingAddress1

$.Customer.ShippingAddress2

$.Customer.ShippingAddress3

$.Customer.ShippingAddress4

$.Customer.ShippingCity

$.Customer.ShippingCounty

$.Customer.ShippingCountry

$.Customer.ShippingPostalCode

$.Customer.ShippingProvince

$.Customer.ShippingState

郵送先住所

お客様の郵送先住所。

text

$.Customer.MailingAddress1

$.Customer.MailingAddress2

$.Customer.MailingAddress3

$.Customer.MailingAddress4

$.Customer.MailingCity

$.Customer.MailingCounty

$.Customer.MailingCountry

$.Customer.MailingPostalCode

$.Customer.MailingProvince

$.Customer.MailingState

請求アドレス

顧客の請求連絡先

text

$.Customer.BillingAddress1

$.Customer.BillingAddress2

$.Customer.BillingAddress3

$.Customer.BillingAddress4

$.Customer.BillingCity

$.Customer.BillingCounty

$.Customer.BillingCountry

$.Customer.BillingPostalCode

$.Customer.BillingProvince

$.Customer.BillingState

属性

顧客プロファイルの属性のキーバリューペア。

text

$.Customer.Attributes.x

オブジェクト属性

顧客プロファイルのカスタムオブジェクト属性のキーバリューペア。

text

$.Customer.ObjectAttributes.y

計算属性

顧客プロファイルの計算属性のキーバリューペア。

text

$.Customer.CalculatedAttributes.z

アセット

顧客の標準アセット。

text

$.Customer.Asset.AssetId

$.Customer.Asset.ProfileId

$.Customer.Asset.AssetName

$.Customer.Asset.SerialNumber

$.Customer.Asset.ModelNumber

$.Customer.Asset.ModelName

$.Customer.Asset.ProductSKU

$.Customer.Asset.PurchaseDate

$.Customer.Asset.UsageEndDate

$.Customer.Asset.Status

$.Customer.Asset.Price

$.Customer.Asset.Quantity

$.Customer.Asset.Description

$.Customer.Asset.AdditionalInformation

$.Customer.Asset.DataSource

$.Customer.Asset.Attributes.x

注文

顧客の標準注文。

text

$.Customer.Order.OrderId

$.Customer.Order.ProfileId

$.Customer.Order.CustomerEmail

$.Customer.Order.CustomerPhone

$.Customer.Order.CreatedDate

$.Customer.Order.UpdatedDate

$.Customer.Order.ProcessedDate

$.Customer.Order.ClosedDate

$.Customer.Order.CancelledDate

$.Customer.Order.CancelReason

$.Customer.Order.Name

$.Customer.Order.AdditionalInformation

$.Customer.Order.Gateway

$.Customer.Order.Status

$.Customer.Order.StatusCode

$.Customer.Order.StatusUrl

$.Customer.Order.CreditCardNumber

$.Customer.Order.CreditCardCompany

$.Customer.Order.FulfillmentStatus

$.Customer.Order.TotalPrice

$.Customer.Order.TotalTax

$.Customer.Order.TotalDiscounts

$.Customer.Order.TotalItemsPrice

$.Customer.Order.TotalShippingPrice

$.Customer.Order.TotalTipReceived

$.Customer.Order.Currency

$.Customer.Order.TotalWeight

$.Customer.Order.BillingName

$.Customer.Order.BillingAddress1

$.Customer.Order.BillingAddress2

$.Customer.Order.BillingAddress3

$.Customer.Order.BillingAddress4

$.Customer.Order.BillingCity

$.Customer.Order.BillingCounty

$.Customer.Order.BillingCountry

$.Customer.Order.BillingPostalCode

$.Customer.Order.BillingProvince

$.Customer.Order.BillingState

$.Customer.Order.ShippingName

$.Customer.Order.ShippingAddress1

$.Customer.Order.ShippingAddress2

$.Customer.Order.ShippingAddress3

$.Customer.Order.ShippingAddress4

$.Customer.Order.ShippingCity

$.Customer.Order.ShippingCounty

$.Customer.Order.ShippingCountry

$.Customer.Order.ShippingPostalCode

$.Customer.Order.ShippingProvince

$.Customer.Order.ShippingState

$.Customer.Order.Attributes.y

ケース

顧客の標準ケース。

text

$.Customer.Case.CaseId

$.Customer.Case.ProfileId

$.Customer.Case.Title

$.Customer.Case.Summary

$.Customer.Case.Status

$.Customer.Case.Reason

$.Customer.Case.CreatedBy

$.Customer.Case.CreatedDate

$.Customer.Case.UpdatedDate

$.Customer.Case.ClosedDate

$.Customer.Case.AdditionalInformation

$.Customer.Case.DataSource

$.Customer.Case.Attributes.z

アウトバウンドキャンペーンの属性

セグメントリストのデータ Amazon Pinpoint を使用して、 Amazon Connect フローのエクスペリエンスをカスタマイズできます。セグメントリスト内のデータを参照するには、$.Attributes.セグメントに含まれる属性を使用します。例えば、「Attributes.FirstName」と「Attributes.ItemDescription」の 2 つの列を持つセグメントがある場合は、次のように参照します。

  • $.Attributes.FirstName

  • $.Attributes.ItemDescription

詳細については、「Amazon Pinpoint ユーザーガイド」の「パーソナライズされたコンテンツをメッセージテンプレートに追加する」を参照してください。

Amazon Q in Connect の属性

次の属性は、Amazon Q in Connect セッションの ARN を保存します。この属性のユースケースは、UpdateSessionUpdateSessionData などの API アクションを実行する場合です。属性を [AWS Lambda 関数] ブロックへの入力として渡すことができます。また、Lambda は入力セッション ARN に対してこれらの API を呼び出すことができます。

属性 説明 タイプ JSONPath 参照

SessionArn

Amazon Q in Connect セッションの Amazon リソースネーム (ARN)。

フロー

$.Wisdom.SessionArn