Connect 客户数据湖中的联系人数据

下表包含联系人数据。

内容

联系记录
联系统计记录

联系记录

表名：contact_record

描述：主要联系人记录包含全面的联系人数据，包括座席详细信息、队列信息、时间戳、设备信息、聊天指标、质量指标和联系人链参考信息。这是数据湖中最大的表，有 100 多列。

主键：instance_id, contact_id

分区键：initiation_timestamp（每天）

加入密钥：

instance_id— 联接到所有表
contact_id— 加入接触统计记录、隐形眼镜、接触评估记录、接触流事件、AI 表
initial_contact_id,previous_contact_id,related_contact_id, next_contact_id — Self-joins 用于接触链
agent_id— 加入座席统计记录 (asuser_id)、座席队列统计记录 (asuser_id)、座席事件 (asagent_arn)、用户 (asuser_id)
queue_id— 加入座席队列统计记录、联系人统计记录
agent_routing_profile_id— 加入路由配置文件（作为）agent_routing_profile_id
agent_hierarchy_groups_level_*_id— 加入代理层次结构群组
campaign_Id— 加入出站活动活动（作为campaign_id）

列	Type	可为空	描述
instance_id	字符串	否	Connect 客户实例的 ID。
aws_account_id	字符串	是	拥有联系人的 AWS 账户的 ID。
contact_id	字符串	否	联系人记录中的联系人的 ID。
initial_contact_id	字符串	是	与客户和联络中心之间初次交互关联的联系人的唯一标识符。使用初始联系 ID 可跟踪流之间的联系人。
previous_contact_id	字符串	是	电话被转接前的联系人的唯一标识符。使用上一个联系 ID 可跟踪流之间的联系人。
related_contact_id	字符串	是	每次联系人连接到座席时，都会创建一个新的联系记录。联系人的联系人记录通过 contactId 字段链接在一起：相关。
next_contact_id	字符串	是	每次联系人连接到座席时，都会创建一个新的联系记录。联系人的联系人记录通过 contactId 字段链接在一起：初始、下一个和上一个。
渠道	字符串	是	联系联络中心的方法：语音、聊天、任务、电子邮件。
initiation_method	字符串	是	如何发起联系。有效值包括：INBOUND、OUTBOUND、TRANSFER、CALLBACK、QUEUE_TRANSFER、EXTERNAL_OUTBOUND、MONITOR、DISCONNECT 和 API。
initiation_timestamp	Timestamp	是	联系启动的时间戳。
connected_to_system_timestamp	Timestamp	是	标记客户端点连接到 Connect Customer 的日期和时间的时间戳，以 UTC 时间表示。对于入站，这与之匹配 InitiationTimestamp。对于 OUTBOUND、CALLBACK 和 API，该值为客户端点应答的时间。
last_update_timestamp	Timestamp	是	显示数据湖最后一次接触数据湖中记录的时间戳。
scheduled_timestamp	Timestamp	是	此联系人计划触发流运行的日期和时间（UTC 时间）。仅任务渠道支持此功能。
transfer_completed_timestamp	Timestamp	是	转接完成的时间戳。
disconnect_timestamp	Timestamp	是	联系断开的时间戳。
disconnect_reason	字符串	是	通话断开的原因。
queue_duration_ms	bigint	是	联系人在队列中等待的时间（以毫秒为单位）。
queue_dequeue_timestamp	Timestamp	是	在客户队列流中，联系人从另一队列转出的时间戳。
queue_enqueue_timestamp	Timestamp	是	在客户队列流中，联系人从另一队列转入该队列的时间戳。
queue_name	字符串	是	队列的名称。
queue_arn	字符串	是	队列的 ARN。
queue_id	字符串	是	队列的 ID。
agent_connection_attempts	bigint	是	Amazon Connect 尝试将此联系人与座席连线的次数。
agent_connected_to_agent_timestamp	Timestamp	是	联系人与座席连线的时间戳。
agent_interaction_duration_ms	bigint	是	座席与客户互动的总时间（以毫秒为单位）。
agent_customer_hold_duration_ms	bigint	是	座席和联系人等待的总时间（以毫秒为单位）。
agent_number_of_holds	bigint	是	由座席置于等候状态的联系人计数
agent_longest_hold_duration_ms	bigint	是	客户被座席置为等待接听状态所耗费的最长时间，以整秒为单位。
agent_after_contact_work_start_timestamp	Timestamp	是	标记AfterContactWork状态开始的时间戳。
agent_after_contact_work_end_timestamp	Timestamp	是	标记AfterContactWork状态结束的时间戳。
agent_after_contact_work_duration_ms	bigint	是	座席对联系人进行 ACW 所花费的总时间（以毫秒为单位）。在某些业务中，也称为“通话总结”时间。
属性	map(string,string)	是	联系属性以键值对的形式表示这些数据。您可以把它看作是一个字段名和输入到该字段中的数据。
agent_username	字符串	是	代理的用户名，在其 Connect Customer 用户帐户中输入。
agent_arn	字符串	是	代理的 ARN，在其 Connect Customer 用户账户中创建。
agent_id	字符串	是	代理的 ID，在其 Connect 客户用户账户中创建。
instance_arn	字符串	是	Connect Customer 实例的 ARN。
agent_hierarchy_groups_level_1_name	字符串	是	分配给座席的层级名称（用于第一层级）。
agent_hierarchy_groups_level_1_arn	字符串	是	分配给座席的层级 ARN（用于第一层级）。
agent_hierarchy_groups_level_1_id	字符串	是	分配给座席的层级 ID（用于第一层级）。
agent_hierarchy_groups_level_2_name	字符串	是	分配给座席的层级名称（用于第二层级）。
agent_hierarchy_groups_level_2_arn	字符串	是	分配给座席的层级 ARN（用于第二层级）。
agent_hierarchy_groups_level_2_id	字符串	是	分配给座席的层级 ID（用于第二层级）。
agent_hierarchy_groups_level_3_name	字符串	是	分配给座席的层级名称（用于第三层级）。
agent_hierarchy_groups_level_3_arn	字符串	是	分配给座席的层级 ARN（用于第三层级）。
agent_hierarchy_groups_level_3_id	字符串	是	分配给座席的层级 ID（用于第三层级）。
agent_hierarchy_groups_level_4_name	字符串	是	分配给座席的层级名称（用于第四层级）。
agent_hierarchy_groups_level_4_arn	字符串	是	分配给座席的层级 ARN（用于第四层级）。
agent_hierarchy_groups_level_4_id	字符串	是	分配给座席的层级 ID（用于第四层级）。
agent_hierarchy_groups_level_5_name	字符串	是	分配给座席的层级名称（用于第五层级）。
agent_hierarchy_groups_level_5_arn	字符串	是	分配给座席的层级 ARN（用于第五层级）。
agent_hierarchy_groups_level_5_id	字符串	是	分配给座席的层级 ID（用于第五层级）。
agent_routing_profile_name	字符串	是	座席的路由配置文件名称。
agent_routing_profile_arn	字符串	是	座席的路由配置文件 ARN。
agent_routing_profile_id	字符串	是	座席的路由配置文件 ID。
代理语音增强模式	字符串	是	代理使用的语音增强模式。有效值：语音隔离 \| 噪音抑制 \| 无。值为 null 表示尚未为此用户设置此模式。
aws_contact_trace_record_format_version	字符串	是	记录格式版本。
campaign_Id	字符串	是	与出站活动相关联的 ID，便于跟踪活动。
customer_endpoint_type	字符串	是	客户端点的类型。有效值为 TELEPHONE_NUMBER。
customer_endpoint_address	字符串	是	客户或外部第三方参与者的端点地址。
transferred_endpoint_type	字符串	是	客户或外部第三方参与者传输的端点类型。
transferred_endpoint_address	字符串	是	客户或外部第三方参与者传输的端点地址。
system_endpoint_type	字符串	是	系统端点的类型。有效值为 TELEPHONE_NUMBER。
system_endpoint_address	字符串	是	系统端点类型地址。
recording_deletion_reason	字符串	是	如果录音已删除，则该值为输入的删除原因。
recording_location	字符串	是	Amazon S3 中的录音位置。
recording_status	字符串	是	记录的状态。有效值：AVAILABLE \| DELETED \| NULL。
recording_type	字符串	是	记录的类型。有效值：AUDIO。
answering_machine_detection_Status	字符串	是	是否检测到答录机的状态。
voice_id_result_authentication_result	字符串	是	呼叫的语音身份验证信息。
voice_id_result_fraud_detection_watch_list_id	字符串	是	用于监控名单通话的欺诈检测信息。
voice_id_result_speaker_id	字符串	是	Voice ID 生成的欺诈检测结果，根据当前会话状态和说话者的流媒体音频进行处理。
voice_id_result_fraud_detection_result	字符串	是	通话的欺诈检测结果信息。
voice_id_result_fraud_detection_fraudster_Id	字符串	是	检测到欺诈者的通话的欺诈检测信息。
external_third_party_interaction_duration_ms	bigint	是	外部第三方的交互持续时间（以毫秒为单位）。
voice_id_result_authentication_minimum_speech_ms	bigint	是	对用户进行身份验证所需的最低身份验证分数。最小值 0，最大值 100。
voice_id_result_authentication_score	bigint	是	对用户进行身份验证所需的最低身份验证分数。最小值 0，最大值 100。
voice_id_result_authentication_score_threshold	bigint	是	对用户进行身份验证所需的最低身份验证分数。最小值 0，最大值 100。
voice_id_result_fraud_detection_risk_score_known_fraudster	bigint	是	在“已知欺诈者”类别的监视列表中检测欺诈者的分数。
voice_id_result_fraud_detection_risk_score_synthetic_speech	bigint	是	该分数以 Voice Spoofing 综合风险评分表示。
voice_id_result_fraud_detection_risk_score_voice_spoofing	bigint	是	基于语音欺骗的欺诈风险评分，例如从 Text-to-Speech 系统录制的音频中播放音频。
voice_id_result_fraud_detection_score_threshold	bigint	是	在流中为联系人设置的监视列表中检测欺诈者的阈值。
agent_pause_duration_ms	bigint	是	座席暂停联系人的持续时间（以秒为单位）。
voice_id_result_speaker_enrolled	布尔值	是	已注册：呼叫方已注册语音身份验证。
voice_id_result_speaker_opted_out	布尔值	是	已退出：呼叫方已选择退出语音认证。
media_streams_items	array(struct(type:string))	是	有关联系期间所用媒体流的信息。有效值：AUDIO、VIDEO、CHAT。
voice_id_result_fraud_detection_reasons_items	array(string)	是	包含欺诈类型：已知欺诈者和语音欺骗。
tags_references_items	map(string,string)	是	将指定的标签添加到指定的资源中。
contact_details	map(string,string)	是	座席和呼叫方之间联系的详细信息。
contact_evaluations	map(string,struct(form_id:string,evaluation_arn:string,status:string, start_timestamp:timestamp,end_timestamp:timestamp,delete_timestamp:timestamp, export_location:string))	是	评估表中包含字段和数据的列表。
参考	array(struct(name:string, type:string, value:string, status: string, arn: string))	是	包含与联系人相关的其他文档的链接。类型：URL \| ATTACHMENT \| NUMBER \| STRING \| DATE \| EMAIL_MESSAGE
additional_email_recipients	array(struct(to_list: array(struct(display_name: string, address: string)), cc_list: array(struct(display_name: string, address: string)), from_recipient: struct(display_name: string, address: string)))	是	包含电子邮件地址的完整列表以及电子邮件联系人的显示姓名。
agent_state_transitions	array(struct(state_start_timestamp:timestamp,state_end_timestamp:timestamp, state:string))	是	有关座席状态转换的信息。
录音	array(struct(storage_type:string,location:string,media_stream_type:string, participant_type:string,fragment_start_number:string,fragment_stop_number:string, start_timestamp:timestamp,stop_timestamp:timestamp,status:string, deletion_reason:string))	是	有关录音、聊天记录或屏幕记录的信息。
agent_device_platform_name	字符串	是	座席用于通话的平台名称。
agent_device_platform_version	字符串	是	座席用于通话的平台版本。
agent_device_operating_system	字符串	是	座席用于通话的操作系统。
customer_device_platform_name	字符串	是	客户用于通话的平台名称。
customer_device_platform_version	字符串	是	客户用于通话的平台版本。
customer_device_operating_system	字符串	是	客户用于通话的操作系统。
disconnect_details_potential_disconnect_issue	字符串	是	表示通话可能出现的断开连接问题。如果服务未检测到潜在问题，则不会填充此字段。
last_resumed_timestamp	Timestamp	是	上次恢复此次联系的日期和时间（UTC 时间）。
last_paused_timestamp	Timestamp	是	上暂停此次联系的日期和时间（UTC 时间）。
customer_voice_activity_greeting_start_timestamp	Timestamp	是	衡量出站语音呼叫中客户问候语开始的日期和时间（UTC 时间）。
customer_voice_activity_greeting_end_timestamp	Timestamp	是	衡量出站语音呼叫中客户问候语结束的日期和时间（UTC 时间）。
total_pause_duration_ms	bigint	是	总暂停时长，包括座席连线前后的时间。
total_pause_count	bigint	是	暂停的总次数，包括联系未连接时的暂停次数。
quality_metrics_agent_audio	struct	是	有关座席的媒体连接质量的信息。这是衡量座席在客户心目中的形象的标准。
quality_metrics_customer_audio	struct	是	有关客户的媒体连接质量的信息。这是衡量客户在座席心目中的形象的标准。
segment_attribute	map(string, string)	是	一组系统定义的键值对，使用属性映射存储在各个联系分段上。这些属性是标准 Amazon Connect 属性，可以在流中访问。属性键只能包含字母数字、- 和 _ 字符。
data_lake_last_processed_timestamp	Timestamp	是	显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。此字段不能可靠地用于确定数据的新鲜度。
chat_contact_metrics_total_messages	bigint	是	联系中的聊天消息条数
chat_contact_metrics_conversation_close_time_ms	bigint	是	最后一条客户消息之后到联系结束所花费的时间
chat_contact_metrics_conversation_turn_count	bigint	是	聊天联系中的对话回合次数
chat_contact_metrics_agent_first_response_timestamp	Timestamp	是	聊天联系中座席的首次响应时间戳。
chat_contact_metrics_agent_first_response_time_ms	bigint	是	在接入聊天联系后座席进行回复的时间。
chat_contact_metrics_total_bot_messages	bigint	是	聊天联系中收到的机器人和自动回复消息总数。
chat_contact_metrics_total_bot_message_length_in_chars	bigint	是	聊天联系中收到的机器人和自动回复消息的总字符数。
chat_contact_metrics_multi_party	布尔值	是	表示是否针对该联系人启用了多方聊天或主管插入的标志
chat_agent_metrics_participant_id	字符串	是	座席的参与者 ID。
chat_agent_metrics_participant_type	字符串	是	座席的参与者类型。
chat_agent_metrics_conversation_abandon	布尔值	是	表示聊天对话是否已被座席放弃的标志。
chat_agent_metrics_messages_sent	bigint	是	座席发送的聊天消息条数。
chat_agent_metrics_num_responses	bigint	是	座席向客户发送的回复数量。
chat_agent_metrics_message_length_in_chars	bigint	是	座席发送的聊天字符数。
chat_agent_metrics_total_response_time_ms	bigint	是	座席的总聊天响应时间。
chat_agent_metrics_max_response_time_ms	bigint	是	座席的最长聊天响应时间。
chat_agent_metrics_last_message_timestamp	Timestamp	是	座席发送最后一条聊天消息的时间戳。
chat_customer_metrics_participant_id	字符串	是	客户的参与者 ID。
chat_customer_metrics_participant_type	字符串	是	客户的参与者类型。
chat_customer_metrics_conversation_abandon	布尔值	是	表示聊天对话是否已被客户放弃的标志
chat_customer_metrics_messages_sent	bigint	是	客户发送的聊天消息条数。
chat_customer_metrics_num_responses	bigint	是	客户发送的回复数量。
chat_customer_metrics_message_length_in_chars	bigint	是	客户发送的聊天字符数。
chat_customer_metrics_total_response_time_ms	bigint	是	客户的总聊天响应时间。
chat_customer_metrics_max_response_time_ms	bigint	是	客户的最长聊天响应时间。
chat_customer_metrics_last_message_timestamp	Timestamp	是	客户发送最后一条聊天消息的时间戳。
q_in_connect_session_arn	字符串	是	Connect 人工智能代理会话的 ARN。
ai_agents	数组（结构）	是	联系人的 AI 代理信息。每个对象都包括 ai_use_case（字符串）、ai_agent_version_id（字符串）和 ai_agent_escalated（布尔值）。
客户_电话_号码_前缀	字符串	是	客户电话号码的前缀。

联系统计记录

表名：contact_statistic_record

描述：包含预先计算的联系人统计数据和用于 KPI 计算的布尔标志，包括联系人处理、转移和放弃的时间指标和分类标志。

主键：instance_id, contact_id

加入密钥：

instance_id— 联接到所有表
contact_id— 加入接触记录、隐形眼镜、接触评估记录、接触流事件
queue_id— 加入联系人记录、座席队列统计记录
agent_id— 加入联系人记录 (asagent_id)、座席统计记录 (asuser_id)、座席队列统计记录 (asuser_id)、用户 (asuser_id)

列	Type	可为空	描述
instance_id	字符串	否	Connect 客户实例的 ID。
aws_account_id	字符串	是	拥有该联系人的 AWS 账户的 ID。
contact_id	字符串	否	联系人的 ID。
渠道	字符串	是	联系联络中心的方法：语音、聊天、任务、电子邮件。
queue_id	字符串	是	队列的 ID。
agent_id	字符串	是	座席的 ID。
initiation_method	字符串	是	INITIATION_METHOD 的值：INBOUND \| OUTBOUND \| TRANSFER \| QUEUE_TRANSFER \| CALLBACK \| API
disconnect_timestamp	Timestamp	是	联系断开的时间戳。
enqueue_timestamp	Timestamp	是	在客户队列流中，联系人从另一队列转入该队列的时间戳。
contact_flow_time_ms	bigint	是	联系人在联系流中耗费的时间。
abandon_time_ms	bigint	是	联系人在被放弃之前在队列中等待的时间。
queue_time_ms	bigint	是	联系人在队列中等待的时间。
queue_answer_time_ms	bigint	是	在座席应答之前，联系人在队列中等待的时间。
handle_time_ms	bigint	是	座席用于联络的时间。座席互动 + 客户等待 + ACW
customer_hold_time_ms	bigint	是	客户与座席连线之后等待接听所花费的时间。
agent_interaction_time_ms	bigint	是	客户与座席互动的时间。
agent_interaction_outbound_time_ms	bigint	是	在出站联系期间，座席与客户交互所花费的时间。
agent_interaction_and_hold_time_ms	bigint	是	客户与座席互动和等待的时间。
after_contact_work_time_ms	bigint	是	座席对联系人进行 ACW 所花费的时间。
after_contact_work_outbound_time_ms	bigint	是	座席为出站联系人执行联系后续工作 (ACW) 所花费的时间。
is_connected	bigint	是	表示 `connected_to_system_timestamp` 是否为 null 的标志。 `is_connected`在不`connected_to_system_timestamp`为空时填充，设置为客户端点连接到 Connect Customer 的日期和时间，以 UTC 时间表示。对于入站，这与之匹配 InitiationTimestamp。对于 OUTBOUND、CALLBACK 和 API，该值为客户端点应答的时间。请注意，`is_handled` 表示通话是否已连接到座席。
is_abandoned	bigint	是	表示联系人是否已被放弃的标志。（由未被座席处理、未通过流程转接和没有下一个联系人来确定。）
is_agent_hung_up_first	bigint	是	在客户之前，座席断开联系时，显示联系是否断开的标志。
is_handled	bigint	是	表示通话是否已连接到座席的标志。
is_handled_incoming	bigint	是	表示联系人是否是由座席处理过的传入联系人，包括入站联系人和转接联系人的标志。
is_handled_outbound	bigint	是	表示联系人是否是由座席处理的出站联系人的标志。
is_callback_handled	bigint	是	表示联系人是否为回拨并由座席处理的标志。
is_api_handled	bigint	是	一个标志，表示联系是否使用 Connect Customer API 操作发起并由代理处理。
is_put_on_hold	bigint	是	表示联系人是否等待接听的标志。
is_hold_disconnect	bigint	是	表示客户在通话过程中是否断开联系的标志。
is_hold_agent_disconnect	bigint	是	表示客户在等待接听过程中座席是否断开了联系的标志。
is_hold_customer_disconnect	bigint	是	表示客户在等待接听过程中客户是否断开了联系的标志。
is_incoming	bigint	是	表示联系人是否为传入联系人（包括入站联系人和转接的联系人）的标志。
is_callback_contact	bigint	是	表示联系人是否为回拨的标志。
is_api_contact	bigint	是	一个标志，指示联系是否是使用 Connect 客户 API 操作发起的。
is_queued	bigint	是	表示联系人是否已进入队列的标志。
is_queued_and_handled	bigint	是	一个标志，指示联系人是否已进入队列并由代理处理。
is_transferred_in	bigint	是	一个标志，表示联系人是否已转入。
is_transferred_in_from_handled	bigint	是	一个标志，指示联系人是否是从代理处理的联系人转入的。
is_transferred_in_from_queued	bigint	是	一个标志，用于指示在转接到队列的联系人流中是否将某个联系人从另一个联系人转移到队列。
is_transferred_out	bigint	是	一个标志，表示联系人是否已转出。
is_transferred_out_from_handled	bigint	是	一个标志，指示联系人是否是从代理处理的联系人转入的。
is_transferred_out_from_queued	bigint	是	一个标志，用于指示是否在 “转接到队列” 联系人流中将联系人从队列转移到另一个队列。
is_transferred_out_internal	bigint	是	一个标志，指示联系人是否已转移到内部来源。
is_transferred_out_external	bigint	是	一个标志，指示联系人是否已从队列转移到外部来源。
is_transferred_out_external_from_contact_flow	bigint	是	一个标志，指示联系人是否通过联系人流转移到外部目的地。
data_lake_last_processed_timestamp	Timestamp	是	显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。此字段不能可靠地用于确定数据的新鲜度。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

代理数据

联系人分析数据