Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de perfiles de clientes de Amazon Connect
Para ayudar a los agentes a ofrecer un servicio de atención al cliente más eficiente y personalizado, Amazon Connect le permite combinar información de aplicaciones externas, como Salesforce, Zendesk u otros productos de gestión de relaciones con los clientes (CRM), con el historial de contactos de. ServiceNow Amazon Connect De este modo se crea un perfil de cliente que contiene toda la información que los agentes necesitan durante las interacciones con los clientes en un solo lugar.
Con una única vista de la información del cliente, incluidos sus productos, casos e historial de contactos, los agentes pueden confirmar rápidamente la identidad del cliente y determinar el motivo de la llamada o el chat.
En la actualidad, los perfiles de clientes de Amazon Connect pueden utilizarse de conformidad con el [RGPD](https://aws.amazon.com/compliance/gdpr-center) y están pendientes de certificaciones adicionales en poder de Amazon Connect.
En la siguiente imagen se muestra el espacio de trabajo del agente; a efectos de esta documentación, aparece una imagen de Perfiles de clientes de Amazon Connect . El espacio de trabajo del agente, diseñado para una multitarea eficaz, permite la gestión simultánea de llamadas, chats y tareas, al mismo tiempo que proporciona un acceso rápido a la información del perfil del cliente, todo ello en la misma ventana del navegador.
![\[La pestaña del perfil del cliente de la aplicación del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png)
1. **Casos**: estado, identificador de referencia, título, fuente, fecha de actualización y más información relacionada con los casos obtenidos de una aplicación 3P, como Zendesk ServiceNow, y también con los casos creados y gestionados mediante casos. Amazon Connect
1. **Más información**: información adicional contenida en el campo *Atributos* definido por el cliente en [el perfil](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html), así como más información del perfil, como el número de teléfono móvil y la dirección de envío. Esta información se ordenará alfabéticamente para ayudar al agente a localizar rápidamente la información que necesita.
1. **Historial de contactos**: fecha, hora y duración de las anteriores tomas de contacto del cliente con el centro de contacto.
1. **Historial de compras de productos**: aquí se pueden rellenar todos los activos comprados por un cliente. Los datos se ingieren de una aplicación externa, como Salesforce o Zendesk, [integrada](integrate-external-apps-customer-profiles.md) con Perfiles de clientes.
# ¿Qué es un perfil de cliente en Amazon Connect?
Un *perfil de cliente* es un registro que almacena el historial de contactos e información sobre los clientes, como el número de cuenta, información adicional, la fecha de nacimiento, el correo electrónico, varias direcciones, el nombre y el tipo de parte. Se espera que un *perfil basado en una cuenta* tenga subperfiles subyacentes.
Tras activar Perfiles de clientes de Amazon Connect, se crea un perfil de cliente único para cada contacto. Esto le permite crear un perfil de cliente que contiene toda la información que los agentes necesitan durante las interacciones con los clientes en un solo lugar sin cargo alguno.
Para acceder a los perfiles de clientes en sus flujos, utilice el bloque [Perfiles de clientes](customer-profiles-block.md). [Los agentes acceden a los perfiles de los clientes](customer-profile-access.md) en su espacio de trabajo.
Puede utilizar las características de pago de Perfiles de clientes para enriquecer los perfiles de clientes mediante la [ingesta de datos de aplicaciones externas](integrate-external-apps-customer-profiles.md). Para obtener más información, consulte los [precios](https://aws.amazon.com/connect/pricing/).
También puede añadir campos y objetos personalizados a los perfiles de los clientes mediante los perfiles de [clientes de Amazon Connect APIs](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ¿Cómo se almacenan los datos de los perfiles de clientes?
Amazon Connect almacena el historial de contactos en perfiles de clientes únicos. Analiza los datos ingeridos desde aplicaciones externas y los almacena como atributos de perfil de cliente.
Amazon Connect no reemplaza ni actualiza los datos de la aplicación externa. Si se elimina un origen de datos, los datos de la aplicación externa dejarán de estar disponibles en el perfil del cliente para todos los contactos de voz.
Para obtener información sobre cómo se protegen los datos del perfil del cliente, consulte [Protección de datos en Amazon Connect](data-protection.md).
Para obtener más información sobre cómo acceder a los datos almacenados en un perfil de cliente, consulte [Acceso a Perfiles de clientes en el espacio de trabajo del agente](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html) o [Uso de la API de Perfiles de clientes](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html).
# Habilitación de perfiles de clientes para su instancia de Amazon Connect
Amazon Connect proporciona integraciones prediseñadas para que pueda combinar rápidamente la información de clientes de varias aplicaciones externas con el historial de contactos de Amazon Connect. Esto le permite crear un perfil de cliente que contiene toda la información que los agentes necesitan durante las interacciones con los clientes.
## Antes de empezar
A continuación se ofrece un resumen de los conceptos clave y de la información que se le solicitará durante el proceso de configuración.
### Acerca del dominio de perfiles de clientes
Al activar Perfiles de clientes de Amazon Connect, se crea un dominio de perfiles de clientes: un contenedor para todos los datos, como los perfiles de clientes, los tipos de objetos, las claves de perfil y las claves de cifrado. A continuación, se indican las directrices para crear dominios de Perfiles de clientes:
+ Cada instancia de Amazon Connect solo puede asociarse a un dominio.
+ Puede crear varios dominios, pero no comparten integraciones de aplicaciones externas ni datos de clientes entre sí.
+ Todas las integraciones de aplicaciones externas que se crean son a nivel de dominio. Todas las instancias de Amazon Connect asociadas a un dominio heredan las integraciones del dominio.
+ Puede cambiar la asociación de su instancia de Amazon Connect del dominio actual a un nuevo dominio en cualquier momento, seleccionando un dominio diferente. Sin embargo, no se recomienda, ya que los perfiles de clientes del dominio anterior no se moverán al nuevo dominio.
### Almacén de datos
El almacén de datos es un almacén de datos a largo plazo de datos de perfiles de clientes. Almacena los datos de los perfiles de los clientes que se han actualizado durante los últimos 10 años. Son los datos que se utilizan para la segmentación impulsada por Spark SQL y los conocimientos predictivos, y deben estar habilitados para poder utilizar esas funciones. No se utilizan para calcular los atributos calculados ni para rellenar el espacio de trabajo del agente.
### ¿Cómo quiere denominar el dominio de sus perfiles de clientes?
Al habilitar los perfiles de los clientes, se le solicitará que proporcione un nombre de dominio descriptivo que sea significativo para usted, como el nombre de su organización, por ejemplo, *CustomerProfiles- ExampleCorp*. Puede cambiar el nombre descriptivo mediante la API en cualquier momento.
### Almacén de datos
El almacén de datos es un almacén de datos gestionado por servicios necesario para la segmentación con Spark SQL y la información predictiva, y debe estar habilitado para utilizar esas funciones. No se utiliza para calcular los atributos calculados ni para rellenar el espacio de trabajo del agente.
Una vez que habilita el almacén de datos, almacenará automáticamente sus datos en los perfiles de los clientes. Una vez que hayas activado el almacén de datos, no podrás desactivar esta función. Para eliminar datos del almacén de datos, puede usar la DeleteProfile API o eliminar los tipos de objetos o el dominio del perfil del cliente.
### ¿Desea utilizar una cola de mensajes fallidos?
Una cola de mensajes fallidos se utiliza para informar de errores asociados con el procesamiento de datos de aplicaciones externas.
Amazon AppFlow gestiona la conexión a la aplicación externa y el traslado de los datos desde ella a los perfiles de clientes de Amazon Connect. A continuación, Amazon Connect procesa el archivo.
+ Si se produce un error durante la conexión o durante el transporte de los datos a Amazon Connect AppFlow , Amazon muestra el error pero no lo escribe en la cola de letra muerta.
Por ejemplo, un error de procesamiento podría deberse a que los datos externos no coincidieran con el esquema especificado o a que el formato de los datos externos no fuera correcto (actualmente solo se admite JSON).
+ Si se produce un error al procesar el archivo, Amazon Connect escribirá el error en su cola de mensajes fallidos. Puede consultar la cola más tarde e intentar reprocesar el error.
+ Tal vez encuentre mensajes de SQS en la cola de mensajes fallidos definida con su dominio que incluye el mensaje de error junto con el objeto.
| **Mensaje de error** | **Recomendación** |
| --- | --- |
| La clave UNIQUE o la clave PROFILE no existen en el objeto de perfil | Modifique la asignación de datos o el objeto y compruebe que las claves marcadas como UNIQUE y PROFILE en la asignación de datos existan en el objeto. Consulte la [**página de asignación de datos**](customer-profiles-object-type-mapping.md) para saber cómo configurarlo. |
| Se incorporan demasiados objetos por segundo en el perfil | Se han asignado demasiados objetos al mismo perfil en poco tiempo. Puedes volver a introducir el objeto o añadir un tiempo de espera entre las llamadas a la API. PutProfileObject |
| Los perfiles de clientes no pueden ingerir el objeto porque EncryptionKey no existe en la región, EncryptionKey no tienen autorización para su uso o EncryptionKey no tienen el permiso GenerateDataKey | Compruebe su permiso de KMS y asegúrese de que Perfiles de clientes tenga el acceso necesario. Siga las indicaciones de la sección [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1). |
| La clave de KMS no es válida | Compruebe su permiso de KMS y asegúrese de que Perfiles de clientes tenga el acceso necesario. Siga las indicaciones de la sección [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1). |
| Los perfiles de los clientes no pueden incorporar el objeto porque la clave de KMS no es válida | Compruebe su permiso de KMS y asegúrese de que Perfiles de clientes tenga el acceso necesario. Siga las indicaciones de la sección [**Enable Customer Profiles, and specify a dead-letter queue and KMS key**](#enable-customer-profiles-step1). |
| Sus datos contienen un objeto de perfil superior a \$1 bytes | Elimine los campos innecesarios y reduzca el tamaño de los datos hasta que estén por debajo del límite especificado que se menciona en el mensaje de error. |
| Todas las claves de este objeto están enlazadas a más de un perfil | Modifique la asignación de datos o el objeto y asegúrese de que al menos una clave PROFILE del objeto esté vinculada a un número igual o inferior a 1 perfil existente. |
Al activar Perfiles de cliente, tiene la opción de especificar una cola de Amazon SQS como cola de mensajes fallidos. Si selecciona esta opción, agregue la siguiente política de recursos a Amazon SQS para que Perfiles de clientes tenga permisos para enviar mensajes a esa cola:
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
Para evitar un problema de seguridad de suplente confuso, consulte en [Prevención de suplentes confusos por servicios de Perfiles de clientes de Amazon Connect](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service) un ejemplo de política para aplicar.
Step-by-step Las instrucciones para crear una cola de texto sin efecto se proporcionan más adelante en este tema, en. [Habilitación de Perfiles de clientes y especificación de una cola de mensajes fallidos y una clave de KMS](#enable-customer-profiles-step1)
### Creación de la clave de KMS que utilizará Perfiles de clientes para cifrar los datos (obligatorio)
**nota**
Para mantener el acceso a los perfiles de los clientes APIs, las entidades que utilizan los perfiles de los clientes `profile` APIs deben tener `kms:GenerateDataKey` permisos `kms:Decrypt` y permisos explícitos en sus políticas de IAM. Esto les permite utilizar `kms:Decrypt` y `kms:GenerateDataKey` para la clave de KMS asociada a los recursos obtenidos de la API relacionados con Perfiles de clientes.
Al activar los perfiles de cliente, se le solicitará que cree o proporcione una [clave AWS Key Management Service KMS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Step-by-stepLas instrucciones para crear una clave KMS se proporcionan más adelante en este tema, en[Habilitación de Perfiles de clientes y especificación de una cola de mensajes fallidos y una clave de KMS](#enable-customer-profiles-step1).
Todos los datos en reposo de Perfiles de clientes se cifran con la clave de KMS que elija. Usted crea, posee y administra su clave administrada por el cliente. Usted tiene el control total sobre la clave KMS (de AWS KMS pago).
Si elige configurar una clave de KMS en la que otra persona sea el administrador, deberá tener una política que permita los permisos `kms:GenerateDataKey`, `kms:CreateGrant` y `kms:Decrypt` para la entidad principal del servicio Perfiles de clientes. Para obtener información sobre cómo cambiar una política clave, consulte [Cambiar una política clave](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) en la Guía para AWS Key Management Service desarrolladores. Además, para evitar la suplantación entre servicios, consulte [La prevención policial confusa entre servicios en AWS](cross-service-confused-deputy-prevention.md) para ver ejemplos de políticas que debe aplicar.
## Habilitación de Perfiles de clientes y especificación de una cola de mensajes fallidos y una clave de KMS
**Almacén de datos**
Elija si desea habilitar el almacén de datos. Es necesario utilizar la segmentación basada en Spark SQL y la información predictiva. Si decides no habilitar el almacén de datos al crear un dominio, puedes habilitarlo después de crear y utilizar el dominio. No puede desactivar el almacén de datos después de haberlo activado.
Para activar el almacén de datos, haga clic en el botón de activación situado en el banner azul de la página de perfiles de los clientes (panel izquierdo > **Perfiles de clientes**). Verás este banner azul una vez que hayas creado tu dominio.
El almacén de datos requiere una clave administrada por el cliente (CMK) y le pedirá que cree una clave administrada por el cliente (CMK) si aún no la ha activado para su dominio.
**importante**
Al usar Data Vault, Customer Profiles almacena los datos por tipo de objeto y los cifra con la clave de AWS KMS. Customer Profiles normaliza los nombres de los tipos de objeto de la siguiente manera:
Convertir el nombre a minúsculas
Convertir guiones en guiones bajos \$1
Añadir «estándar» a cualquier tipo de objeto estándar de perfil de cliente
Añadir «dominio» a cualquier tipo de objeto de dominio de perfiles de clientes
Añadir «domain\$1standard» a cualquier tipo de objeto de dominio estándar de Customer Profiles
No puede habilitar el almacén de datos si Customer Profiles detecta conflictos de nombres. Tras activar el almacén de datos, no podrá crear tipos de objetos que entren en conflicto con los nombres de los tipos de objeto existentes según estas reglas de normalización.
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
En la página **Dominio de perfiles de clientes** se enumeran las aplicaciones disponibles para la integración. En la siguiente imagen, la página muestra que no se ha activado ningún dominio de perfil de cliente.
![\[Página de perfiles de clientes, botón Habilitar perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-domains-page.png)
1. Seleccione **Habilitar perfiles de clientes** para empezar.
1. En la página **Perfiles de clientes habilitados**, selecciona **Crear nuevo dominio**. En **Especificar un dominio**, introduce un nombre descriptivo que sea significativo para ti, como el nombre de tu organización, por ejemplo, *CustomerProfiles- ExampleCorp*.
![\[Página Perfiles de clientes habilitados.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-domain.png)
1. En **Especificar cola de mensajes fallidos**, elija si desea enviar los eventos fallidos a una cola de mensajes fallidos. Esto es útil si desea obtener visibilidad de los datos que no se han podido ingerir. También le da la opción de volver a intentar estas ingestas de datos con errores en el futuro.
Los pasos para crear una cola de mensajes fallidos son los siguientes:
+ En la página **Perfiles de clientes habilitados**, elija **Crear una cola de SQS nueva o seleccionar una cola de SQS existente** y, a continuación, elija **Crear una nueva cola de mensajes fallidos**.
![\[Opción para crear una cola de SQS nueva o seleccionar una existente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png)
+ Se abre una nueva pestaña en el navegador para la consola de Amazon SQS. Elige **Crear cola**.
+ En la página **Crear cola**, elija **Estándar** y, a continuación, asigne un nombre a la cola.
![\[Página Crear cola.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png)
+ En la sección **Política de acceso**, elija **Avanzada**.
Aparecen el nombre de la versión, el identificador de política y la instrucción. Si es necesario, actualice esta sección para permitir el acceso únicamente a los roles correspondientes.
+ Al final de la sección Instrucción (línea 15 en la siguiente imagen), agregue una coma después de \$1 y presione `Enter`.
![\[Sección Política de acceso.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png)
+ A continuación, copie y pegue el siguiente código:
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
+ Para reemplazar *region* y *YourQueueName* con tu información, copia y pega la `Resource` información de la línea 14. *accountID*
![\[Sección Política de acceso, información del recurso.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png)
+ Elige **Crear cola**.
+ Vuelva a la pestaña de su navegador correspondiente a la consola de Amazon Connect, página **Perfiles de clientes habilitados**. Haga clic o pulse el cuadro **Elegir una cola de SQS existente** para seleccionar la cola que acaba de crear en la lista desplegable.
![\[Cola de SQS de la lista desplegable.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png)
1. En **Especificar la clave de KMS**, cree o introduzca su propia AWS KMS key para el cifrado. A continuación, se indican los pasos para crear su AWS KMS key:
+ En la página **Perfiles de clientes habilitados**, seleccione **Crear una AWS KMS key**.
![\[Página Perfiles de clientes habilitados, botón Crear una AWS KMS key .\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key.png)
+ Se abrirá una nueva pestaña en su navegador para la consola Key Management Service (KMS). En la página **Configurar clave**, elija **Simétrico** y, a continuación, elija **Siguiente**.
![\[Página Configurar clave, opción Simétrico.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
+ En la página **Agregar etiquetas**, escriba un nombre y una descripción para la clave y, a continuación, elija **Siguiente**.
![\[Página Agregar etiquetas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png)
+ En la página **Definir permisos de administración de claves**, elija **Siguiente**.
+ En la página **Definir permisos de uso de claves**, elija **Siguiente**.
+ En la página **Revisar y editar política de claves**, elija **Finalizar**.
En el siguiente ejemplo, el nombre de la clave comienza por **bcb6fdd**:
![\[Página Claves administradas por el cliente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png)
+ Vuelva a la pestaña de su navegador correspondiente a la consola de Amazon Connect, página **Perfiles de clientes habilitados**. Pulse o haga clic en el cuadro **Especificar clave de KMS** para que la clave que ha creado aparezca en una lista desplegable. Elija la clave que ha creado.
![\[Sección Especificar clave de KMS.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png)
1. En **Almacén de datos**, elija si desea habilitar el almacén de datos. Es necesario utilizar la segmentación basada en Spark SQL y los conocimientos predictivos. Si decides no habilitar el almacén de datos al crear un dominio, puedes habilitarlo después de crear y utilizar el dominio. No puede desactivar el almacén de datos después de haberlo activado.
Si ya tiene un dominio sin almacén de datos, puede activarlo haciendo clic en el botón de activación situado en el banner azul de la página de perfiles de los clientes (panel izquierdo > Perfiles de clientes)
El almacén de datos requiere una clave gestionada por el cliente (CMK) y le pedirá que cree una clave gestionada por el cliente (CMK) si aún no la ha activado para su dominio.
1. Seleccione **Enviar**. La página completada tiene un aspecto similar a la siguiente imagen. Muestra el nombre del dominio de perfiles de clientes, la cola de mensajes fallidos y la clave de KMS.
![\[Página completada Dominio de perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-final.png)
Ya ha terminado. Perfiles de clientes de Amazon Connect está habilitado. Ahora, con cada nuevo contacto que entre, Amazon Connect crea un registro de perfil de cliente. A continuación, rastrea el historial de contactos de ese número de teléfono (voz) o dirección de correo electrónico (chat).
Sus agentes pueden [crear nuevos perfiles de clientes](ag-cp-create.md) y ver los registros de contactos de sus clientes.
## Siguientes pasos
1. [Haga que Perfiles de clientes esté disponible a través de la aplicación del agente](customer-profile-access.md).
1. [Asigne a los agentes permisos para acceder a Perfiles de clientes en la aplicación del agente](assign-security-profile-customer-profile.md).
1. [Realice la integración con aplicaciones externas que ofrezcan datos sobre el perfil de cliente (opcional)](integrate-external-apps-customer-profiles.md).
1. [Habilite la resolución de identidades para identificar dos o más perfiles similares y consolidarlos](use-identity-resolution.md).
# Introducción a las plantillas de recursos sectoriales
Perfiles de clientes de Amazon Connect proporciona plantillas de recursos sectoriales para configurar rápidamente su dominio con atributos calculados, segmentos y diseños del Explorador de perfiles adaptados a sectores específicos.
## Antes de empezar
Antes de activar las plantillas de recursos sectoriales, asegúrese de que dispone de lo siguiente:
+ Una instancia de Amazon Connect con Perfiles de clientes activado
+ Los permisos adecuados para crear recursos en su dominio de Perfiles de clientes
## Acerca de las plantillas de recursos sectoriales
Al activar una plantilla de sector, Perfiles de clientes crea automáticamente los siguientes recursos en su dominio:
+ Definiciones de atributos calculados: atributos predefinidos derivados de los datos de sus clientes
+ Definiciones de segmentos: agrupaciones de clientes basadas en características comunes
+ Diseños del explorador de perfiles: vistas de panel personalizadas para visualizar la información de los clientes
Estos recursos están diseñados para ayudarlo a obtener valor rápidamente de los datos de sus clientes sin tener que crear cada recurso manualmente.
## Activación de las plantillas de recursos sectoriales
1. En la página de inicio de Perfiles de clientes, busque la sección Plantillas del sector.
+ Si es la primera vez que configura Perfiles de clientes, aparecerá un mensaje en la parte superior de la página.
![\[Si es la primera vez que utiliza perfiles de clientes, aparece un banner para activar las plantillas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-industry-resource-templates-1.png)
+ Si ya tiene recursos en su dominio, la lista de plantillas habilitadas aparece en la sección de plantillas del sector.
![\[Si ya ha utilizado perfiles de clientes, aparecerá una lista de plantillas habilitadas en la sección de plantillas del sector.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-industry-resource-templates-2.png)
1. Para activar una plantilla, elija **Habilitar una plantilla**.
1. En el menú desplegable **Seleccione una plantilla**, elija el sector que mejor se ajuste a su empresa:
+ **Aerolínea**: para empresas de viajes en avión
+ **Hotel**: para empresas de hostelería
1. En la sección **Revise los recursos**, revise los recursos que se crearán.
![\[Revise los recursos que se crearán.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-industry-resource-templates-3.png)
1. Seleccione **Habilitar plantilla**.
1. Espere a que se creen los recursos. Mantenga abierta la pestaña del navegador mientras se crea el recurso.
1. Cuando haya terminado, verá un mensaje de confirmación y la plantilla aparecerá en la sección Plantillas del sector con el número de recursos creados.
![\[Aparece el banner de creación correcta.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-industry-resource-templates-4.png)
## Recursos creados por plantillas del sector
### Plantilla del sector de las aerolíneas
#### Atributos calculados
La plantilla de la aerolínea crea atributos calculados en varias categorías:
**Atributos calculados para las aerolíneas**
| Nombre del atributo calculado | Nombre de visualización | Description (Descripción) | Tipo de objeto |
| --- | --- | --- | --- |
| air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | Aeropuerto de salida preferido | Devuelve el aeropuerto de salida preferido configurado más recientemente por el cliente. | \$1airPreference |
| air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | Aeropuerto de llegada preferido | Devuelve el aeropuerto de llegada preferido configurado más recientemente por el cliente. | \$1airPreference |
| air\$1airPreference\$1travel\$1type\$1last\$1occurrence | Tipo de viaje preferido | Devuelve el tipo de viaje preferido configurado más recientemente por el cliente. | \$1airPreference |
| air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Preferencia de suscripción de marketing | Devuelve la configuración de suscripción de marketing configurada más recientemente por el cliente. | \$1airPreference |
| air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | Idioma preferido para interacciones en persona | Devuelve el idioma preferido más recientemente por el cliente para las interacciones en persona. | \$1airPreference |
| air\$1airPreference\$1seat\$1location\$1last\$1occurrence | Ubicación de asiento preferida | Devuelve la preferencia de la ubicación del asiento seleccionada más recientemente por el cliente. | \$1airPreference |
| air\$1airPreference\$1home\$1airport\$1last\$1occurrence | Aeropuerto de origen preferido | Devuelve el aeropuerto de origen especificado por el cliente más recientemente. | \$1airPreference |
| air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | Restricción dietética preferida | Devuelve la última restricción dietética especificada por el cliente. | \$1airPreference |
| air\$1airBookings\$1number\$1of\$1passengers\$1average | Media de pasajeros por reserva | Muestra el promedio de pasajeros de las reservas del cliente. | \$1AirBooking |
| air\$1airBookings\$1price\$1total\$1price\$1average | Precio medio por reserva | Devuelve el costo medio de todas las reservas del cliente. | \$1AirBooking |
| air\$1airBookings\$1count | Recuento de reservas | Devuelve el recuento de reservas realizadas por un cliente. | \$1AirBooking |
| air\$1airSegments\$1flight\$1delay\$1time\$1sum | Duración total del retraso del vuelo | Devuelve la duración total de los retrasos en los vuelos sufridos por el cliente. | \$1airSegment |
| air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | Vuelos cancelados en los últimos 30 días | Recuento de los vuelos del cliente cancelados en los últimos 30 días. | \$1airSegment |
| air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | Vuelos retrasados en los últimos 30 días | Devuelve el recuento de los vuelos del cliente retrasados en los últimos 30 días. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | Vuelos completados en los últimos 30 días | Devuelve el recuento de los vuelos del cliente completados en los últimos 30 días. | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | Vuelos completados en el último año | Devuelve el recuento de los vuelos del cliente completados en el último año. | \$1airSegment |
| air\$1airSegment\$1departure\$1date\$1last\$1occurrence | Fecha de salida del último vuelo | Devuelve la fecha de salida del vuelo más reciente del cliente. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum | Millas totales recorridas | Devuelve la suma de todas las distancias de vuelo en millas de un cliente. | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | Millas acumuladas el año pasado | Devuelve la suma de las millas de vuelo recorridas por el cliente en el último año. | \$1airSegment |
| air\$1airSegments\$1business\$1first\$1class\$1count | Número de vuelos de clase premium | Recuento de las reservas de segmentos aéreos del cliente en primera clase o en business. | \$1airSegment |
| air\$1loyalties\$1points\$1redeemed\$1sum | Total de puntos de fidelidad canjeados | Devuelve la suma total de puntos canjeados en todos los programas de fidelización del cliente. | \$1loyalty |
| air\$1loyalties\$1count | Recuento de suscripciones a programas de fidelización | Devuelve el número de suscripciones a programas de fidelización del cliente. | \$1loyalty |
| air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Puntos para el siguiente nivel | Devuelve el registro más reciente de puntos del cliente necesarios para alcanzar el siguiente nivel de fidelización. | \$1loyalty |
| air\$1loyalty\$1points\$1balance\$1last\$1occurrence | Saldo actual de puntos de fidelización | Devuelve el saldo de puntos de fidelización más reciente del cliente. | \$1loyalty |
| air\$1loyalty\$1membership\$1id\$1last\$1occurrence | ID de membresía de fidelización actual | Devuelve el identificador de membresía de fidelización más reciente del cliente. | \$1loyalty |
| air\$1loyalty\$1program\$1name\$1last\$1occurrence | Nombre del programa de fidelización actual | Devuelve el nombre del programa de fidelización más reciente del cliente. | \$1loyalty |
| air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Fecha de inscripción más reciente en el programa de fidelización | Devuelve la fecha de inscripción más reciente al programa de fidelización del cliente. | \$1loyalty |
| air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Nivel de fidelización actual | Devuelve el nivel del programa de fidelización más reciente del cliente. | \$1loyalty |
| air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Número de membresías de nivel premium | Devuelve el número de programas de fidelización del cliente de nivel Silver. | \$1loyalty |
| air\$1loyaltyPromotions\$1count | Recuento de promociones de fidelización | Devuelve el número total de promociones de fidelización recibidas por el cliente. | \$1loyaltyPromotion |
#### Segmentos
La plantilla de aerolínea crea los siguientes segmentos:
+ [Aerolínea] Suscriptores a comunicaciones de marketing
+ [Aerolínea] Clientes con vuelos cancelados en los últimos 30 días
+ [Aerolínea] Clientes con vuelos retrasados en los últimos 30 días
+ [Aerolínea] Clientes con vuelos finalizados en los últimos 30 días
+ [Aerolínea] Miembros inactivos
#### Diseño del explorador de perfiles
Se crea un diseño de demostración del explorador de perfiles con el nombre del diseño: `DEMO-Airline-Layout` que consta de los siguientes widgets:
+ Detalles del cliente e información de contacto
+ Estado y puntos del programa de fidelización
+ Reservas y vuelos recientes
+ Preferencias de los clientes
+ Métricas de valor para el cliente
+ Indicadores de satisfacción del cliente
### Plantilla del sector hotelero
#### Atributos calculados
La plantilla de hotel crea atributos calculados en varias categorías:
**Atributos calculados del hotel**
| Nombre del atributo calculado | Nombre de visualización | Description (Descripción) | Tipo de objeto |
| --- | --- | --- | --- |
| hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | Tipo de habitación preferida | Devuelve el tipo de habitación preferida configurada más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | Hora de limpieza preferida | Devuelve la hora de limpieza de la habitación preferida configurada más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | Vista preferida desde la habitación | Devuelve la vista preferida desde la habitación configurada más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | Método de registro preferido | Devuelve el método de registro preferido configurado más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | Método de salida preferido | Devuelve el método de salida preferido configurado más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | Último tipo de solicitud especial | Devuelve el tipo de alojamiento especial solicitado más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | Interés más frecuente | Devuelve el interés o la preferencia de servicio que el cliente ha expresado con mayor frecuencia. | \$1hotelPreference |
| hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | Preferencia de suscripción de marketing | Devuelve la configuración de suscripción de marketing configurada más recientemente por el cliente. | \$1hotelPreference |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | Duración media de la estancia | Devuelve la duración media de la estancia de todas las reservas de hotel del cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | Total de noches durante el año pasado | Devuelve el total de noches de alojamiento durante el año pasado en todas las reservas del cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | Total de noches de estancia | Devuelve el total de noches de estancia de todas las reservas de hotel del cliente. | \$1hotelReservation |
| hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | Último tipo de habitación reservada | Devuelve el tipo de habitación que el cliente ha reservado más recientemente. | \$1hotelReservation |
| hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | Último canal de reservas utilizado | Devuelve el canal utilizado recientemente por el cliente para reserva un hotel. | \$1hotelReservation |
| hotel\$1hotelReservations\$1count | Recuento de reservas | Devuelve el recuento de reservas de hotel realizadas por un cliente. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | Gasto medio de las reservas | Devuelve el importe medio gastado por reserva de hotel después de impuestos. | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | Gasto total en hoteles | Devuelve el importe total gastado en todas las reservas de hotel del cliente después de impuestos. | \$1hotelReservation |
| hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | Tamaño del grupo más habitual | Devuelve el número de huéspedes que el cliente ha reservado con mayor frecuencia en todas las estancias. | \$1hotelReservation |
| hotel\$1hotelReservations\$1business\$1travel\$1count | Recuento de viajes de negocios | Devuelve el recuento de reservas del cliente marcadas como viajes de negocios. | \$1hotelReservation |
| hotel\$1hotelReservations\$1missed\$1checkin\$1count | Recuento de registros no realizados | Devuelve el recuento de las reservas en las que el cliente no ha hecho el check-in. | \$1hotelReservation |
| hotel\$1hotelReservation\$1cancelled\$1count | Recuento de reservas canceladas | Devuelve el recuento de reservas de hotel canceladas por el cliente. | \$1hotelReservation |
| hotel\$1 \$1cantidad\$1suma hotelStayRevenues | Ingresos totales generados | Devuelve los ingresos totales generados en todas las estancias de hotel del cliente. | \$1hotelStayRevenue |
| hotel\$1 hotelStayRevenues \$1cantidad\$1promedio | Ingresos medios por estancia | Devuelve el importe medio de ingresos calculado en todas las estancias del cliente. | \$1hotelStayRevenue |
| hotel\$1 hotelStayRevenues \$1cantidad\$1máxima | Importe de ingresos más alto | Devuelve el importe de ingresos más alto individual generado por cualquier estancia del cliente. | \$1hotelStayRevenue |
| hotel\$1 hotelStayRevenue \$1ingreso\$1type\$1max\$1occurrence | Fuente de ingresos más común | Devuelve el tipo de ingresos más frecuente generado por las estancias de hotel del cliente. | \$1hotelStayRevenue |
| hotel\$1loyalties\$1points\$1redeemed\$1sum | Total de puntos de fidelidad canjeados | Devuelve la suma total de puntos canjeados en todos los programas de fidelización del cliente. | \$1loyalty |
| hotel\$1loyalties\$1count | Recuento de suscripciones a programas de fidelización | Devuelve el número de suscripciones a programas de fidelización del cliente. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | Puntos para el siguiente nivel | Devuelve el registro más reciente de puntos del cliente necesarios para alcanzar el siguiente nivel de fidelización. | \$1loyalty |
| hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | Saldo actual de puntos de fidelización | Devuelve el saldo de puntos de fidelización más reciente del cliente. | \$1loyalty |
| hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | ID de membresía de fidelización actual | Devuelve el identificador de membresía de fidelización más reciente del cliente. | \$1loyalty |
| hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | Nombre del programa de fidelización actual | Devuelve el nombre del programa de fidelización más reciente del cliente. | \$1loyalty |
| hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | Fecha de inscripción más reciente en el programa de fidelización | Devuelve la fecha de inscripción más reciente al programa de fidelización del cliente. | \$1loyalty |
| hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | Nivel de fidelización actual | Devuelve el nivel del programa de fidelización más reciente del cliente. | \$1loyalty |
| hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | Número de membresías de nivel premium | Devuelve el número de programas de fidelización del cliente de nivel Silver. | \$1loyalty |
| hotel\$1loyaltyPromotions\$1count | Recuento de promociones de fidelización | Devuelve el número total de promociones de fidelización recibidas por el cliente. | \$1loyaltyPromotion |
#### Segmentos
La plantilla del hotel crea segmentos tales como:
+ [Hotel] Suscriptores a comunicaciones de marketing preferencial
+ [Hotel] Personas que viajan solas
+ [Hotel] Personas que viajan en pareja
+ [Hotel] Personas que viajan en familia o en grupo
+ [Hotel] Clientes con una reserva dentro de 30 días
#### Diseño del explorador de perfiles
Diseño personalizado que muestra:
+ Detalles del cliente e información de contacto
+ Preferencias de habitación
+ Historial de estancias
+ Información sobre ingresos
+ Estado de fidelización
## Desactivación de las plantillas del sector
Puede desactivar una plantilla del sector para eliminar los recursos que ha creado de su dominio. Para desactivar una plantilla:
1. En la página de inicio de Perfiles de clientes, busque la sección Plantillas del sector.
1. Busque la plantilla que deseas desactivar y elija la acción **Desactivar**.
1. Revise el mensaje de confirmación y elija **Confirmar** para desactivar la plantilla.
**importante**
Al desactivar una plantilla, todos los recursos creados por esa plantilla se eliminarán de su dominio. Si alguno de estos recursos se utiliza en los segmentos de clientes, las campañas externas o los flujos de contactos, la desactivación de la plantilla puede afectarles.
Antes de desactivar una plantilla, revise los recursos en uso para comprender el posible impacto.
## Resolución de problemas
**Solución de problemas con las plantillas del sector**
| Error | Recomendación |
| --- | --- |
| No se han podido crear los recursos de la plantilla | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| Los recursos creados no aparecen en el Explorador de perfiles | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| No se pueden activar varias plantillas | Cada dominio puede tener habilitadas varias plantillas de sector. Si tienes problemas, compruebe que no haya alcanzado los límites de recursos de su dominio. |
| Se deben eliminar los recursos de la plantilla | Actualmente, la característica Introducción no proporciona ninguna forma de eliminar automáticamente todos los recursos creados por una plantilla. Puede eliminar manualmente los recursos individuales a través de sus respectivas páginas de administración. |
## Siguientes pasos
Tras activar una plantilla de sector, puede:
+ navegar hasta el explorador de perfiles para ver su nuevo diseño en acción,
+ ver y editar los atributos calculados para que se adapten mejor a sus necesidades específicas,
+ Administración de los segmentos de clientes en Amazon Connect
+ editar el diseño del explorador de perfil en función de los requisitos de su empresa.
+ Integración de aplicaciones externas con Perfiles de clientes de Amazon Connect para empezar a rellenar los perfiles
# Acceso a Perfiles de clientes de Amazon Connect en el espacio de trabajo del agente
Una vez activados los perfiles de los Amazon Connect clientes, los agentes pueden empezar a interactuar con los clientes y acceder a su [información](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html) para ofrecer un servicio personalizado. En este tema se explica cómo acceder al espacio de trabajo de los Amazon Connect agentes.
**sugerencia**
Asegúrese de que sus agentes tienen permisos de **Perfiles de clientes** en su perfil de seguridad para que puedan acceder a Perfiles de clientes. Para obtener más información, consulte [Permisos de perfil de seguridad para Perfiles de clientes de Amazon Connect](assign-security-profile-customer-profile.md).
## Opción 1: utilizar los perfiles de los clientes con el CCP out-of-the-box
Perfiles de clientes ya está integrado junto al Panel de control de contacto (CCP). Sus agentes pueden acceder al CCP, a los perfiles de los clientes y a la administración Amazon Connect de casos desde la misma ventana del navegador. Para ello, deben iniciar sesión en su Amazon Connect instancia y pulsar el botón **Agent Workspace**, situado en la esquina superior derecha, como se muestra en la siguiente imagen.
![\[La página Perfiles de clientes y el botón resaltado que abre el espacio de trabajo del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png)
**nota**
También puede acceder al espacio de trabajo del agente con la siguiente URL:
***instance name*https://.my.connect.aws/ agent-app-v 2/**
Si accede a su instancia con el dominio **awsapps.com**, utilice la siguiente URL:
***instance name*https://.awsapps. com/connect/agent**-app-v2/
Si necesita ayuda para encontrar el nombre de su instancia, consulte [Búsqueda del nombre de instancia de Amazon Connect](find-instance-name.md).
A continuación se muestra un ejemplo del aspecto de Perfiles de clientes en el espacio de trabajo del agente.
![\[La pestaña Perfiles de clientes y el CCP en el espacio de trabajo del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-agent-app.png)
## Opción 2: insertar Perfiles de clientes en un espacio de trabajo de agente personalizada
Cuando inserte su Panel de control de contacto (CCP), tendrá la opción de mostrar u ocultar la interfaz de usuario CCP prediseñada. Por ejemplo, puede que desee desarrollar un espacio de trabajo de agente personalizado que tenga una interfaz de usuario diseñada por usted, con botones personalizados para aceptar y rechazar llamadas. También puede insertar el CCP prediseñado que se incluye con Amazon Connect en otra aplicación personalizada.
Independientemente de si muestra la interfaz de usuario de CCP prediseñada o la oculta y crea la suya propia, debe utilizar la biblioteca de [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) para insertar el CCP y Perfiles de clientes en el espacio de trabajo del agente. De este modo, se inicializa Amazon Connect Streams y el agente puede conectarse y autenticarse en Amazon Connect y Perfiles de clientes.
Para obtener información sobre cómo insertar Perfiles de clientes, consulte [Inicialización para CCP, Perfiles de clientes y Wisdom](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom).
Para crear tu propio widget utilizando datos sin procesar de los perfiles de los clientes, consulta la documentación de [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles) sobre cómo usar la CustomerProfiles biblioteca de código abierto JS.
**sugerencia**
Cuando personaliza el espacio de trabajo del agente, determina la URL que utilizarán los agentes para acceder a su espacio de trabajo y puede ser muy diferente de la que proporciona Amazon Connect. Por ejemplo, tu URL podría ser https://example-corp.com/agent-support-app.
# Autocompletado de los perfiles de clientes
De forma predeterminada, Perfiles de clientes de Amazon Connect utiliza los siguientes valores para buscar y rellenar automáticamente un perfil de cliente en su interfaz de usuario:
+ Para contactos de voz: número de teléfono
+ Para contactos de chat: correo electrónico
Rellena automáticamente un perfil de cliente mediante el bloque de flujo Perfiles de clientes. Para personalizar este comportamiento, utilice el bloque [Establecer atributos de contacto](set-contact-attributes.md) (consulte abajo) para los siguientes atributos de contacto
| Atributo | Description (Descripción) | Tipo | JSONPath Referencia |
| --- | --- | --- | --- |
| profileSearchKey | El nombre del atributo que desea usar para buscar un perfil. | Definido por el usuario | No aplicable |
| profileSearchValue | El valor de la clave que desea buscar, como el nombre del cliente o el número de cuenta. | Definido por el usuario | No aplicable |
Por ejemplo, para buscar por correo electrónico los contactos del chat, puede establecer el atributo `profileSearchKey` a la clave de búsqueda `_email` y proporcionar el valor del correo electrónico como `profileSearchValue`.
Si ha definido claves personalizadas en sus objetos de perfil, también puede buscar por esas claves de búsqueda. Para asegurarse de que sus claves personalizadas se pueden buscar, consulte [Detalles de la definición de clave](object-type-mapping-definition-details.md#key-definition-details).
La siguiente imagen muestra cómo podría utilizar estos atributos en el bloque [Establecer atributos de contacto](set-contact-attributes.md).
![\[La página de propiedades del bloque Establecer atributos de contacto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-attributes1.png)
## Asociación automática de un perfil de cliente a un contacto
De forma predeterminada, los agentes tienen que asociar manualmente un perfil de cliente con un contacto después de haber verificado la identidad del cliente. Para cambiar este comportamiento y asociar automáticamente los contactos a un perfil en función del número de teléfono, consulte [Asociación del registro de contacto con un perfil encontrado mediante la clave \$1phone en Perfiles de clientes](auto-associate-profile-using-phone-profile-key.md).
Si varios perfiles coinciden con el número de teléfono de un contacto, se muestran al agente los múltiples perfiles coincidentes. El agente debe elegir qué perfil asociará al contacto.
# Permisos de perfil de seguridad para Perfiles de clientes de Amazon Connect
Asigne permisos a los perfiles de seguridad de sus agentes para que puedan realizar tareas como buscar perfiles y ver los detalles de los clientes, asociar los registros de contactos a los perfiles, editar los perfiles y crear y guardar nuevos perfiles. Los temas de la sección lo ayudan a asignar permisos mediante la actualización de los permisos de los agentes, los flujos y los atributos calculados. También hay información que lo ayudará a solucionar un posible error al actualizar los permisos.
**Topics**
+ [
# Permisos de actualización de Perfiles de clientes para los agentes
](security-profile-customer-profile-agent.md)
+ [
# Actualización de los permisos de Perfiles de clientes para los flujos
](security-profile-customer-profile-contact-flows.md)
+ [Actualización de los permisos de los atributos calculados](security-profile-customer-profile-calc-attribs.md)
+ [Permisos de perfil de seguridad para segmentos de clientes](security-profile-customer-profile-segmentation.md)
+ [
# En caso de error, asigne nuevos permisos de Perfiles de clientes
](security-profile-customer-profile-issues.md)
# Permisos de actualización de Perfiles de clientes para los agentes
Asigne los siguientes permisos de **Perfiles de clientes** según sea necesario al perfil de seguridad del agente:
+ **Ver**: permite a los agentes ver la aplicación de Perfiles de clientes. Puede realizar lo siguiente:
+ Ver los perfiles que se rellenan automáticamente en la aplicación del agente.
+ Busca perfiles.
+ Ver los detalles almacenados en los perfiles de clientes (por ejemplo, nombre y dirección).
+ Asociar registros de contacto a perfiles, tal y como se muestra en la siguiente imagen.
![\[La pestaña Perfiles de clientes en el espacio de trabajo del agente con el botón Asociar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-associate.png)
+ **Editar**: permite a los agentes editar los detalles del perfil del cliente (por ejemplo, cambiar de dirección). Heredan los permisos de **Ver** de forma predeterminada.
+ **Crear**: permite a los agentes crear y guardar un perfil nuevo. Heredan los permisos de **Ver** de forma predeterminada, pero no heredan los permisos de **Editar**.
Para obtener información acerca de cómo agregar más permisos a un perfil de seguridad existente, consulte [Actualización de los perfiles de seguridad predeterminados en Amazon Connect](update-security-profiles.md).
De forma predeterminada, el perfil de seguridad **Administrador** ya tiene permisos para realizar todas las actividades de Perfiles de clientes.
# Actualización de los permisos de Perfiles de clientes para los flujos
1. Vaya a la página Perfiles de seguridad, elija el perfil de seguridad que quiere editar o **Agregar nuevo perfil de seguridad**.
![\[Página Perfiles de seguridad.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Seleccione el permiso **Ver** para los perfiles de cliente.
![\[Seleccione los permisos Ver en la página de perfiles de seguridad.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png)
1. Seleccione **Save**. Ahora puede ir a la sección **Administración de usuarios** y proporcionar este perfil de seguridad a los usuarios que desee.
# Actualización de los permisos de los atributos calculados en Perfiles de clientes de Amazon Connect
1. Vaya a la página Perfiles de seguridad, elija el perfil de seguridad que quiere editar o **Agregar nuevo perfil de seguridad**.
![\[Página Perfiles de seguridad.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Seleccione el permiso **Todo** o **Ver**, **Editar**, **Crear** y **Eliminar** para los atributos calculados.
![\[Seleccione los permisos Ver, Editar, Crear y Eliminar en la consola de perfiles de seguridad.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png)
1. Seleccione **Save**. Ahora puede ir a la sección **Administración de usuarios** y proporcionar este perfil de seguridad a los usuarios que desee.
# Asignación de permisos de perfil de seguridad para administrar segmentos de clientes
Asigne los siguientes permisos de segmentos de clientes según sea necesario al perfil de seguridad del usuario. Para obtener más información sobre los perfiles de seguridad, consulte [Perfiles de seguridad para el acceso a Amazon Connect y al Panel de control de contacto (CCP)](connect-security-profiles.md).
1. Vaya a la página Perfiles de seguridad, elija el perfil de seguridad que quiere editar o **Agregar nuevo perfil de seguridad**.
![\[La página Perfiles de seguridad con la sección Perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png)
1. Selecciones el permiso **Todo** o **Ver**, **Crear**, **Eliminar** y **Exportar** para los segmentos de cliente.
![\[El permiso Segmentos de clientes está establecido en Todos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png)
1. Seleccione **Save**. Ahora puede ir a la sección **Administración de usuarios** y proporcionar este perfil de seguridad a los usuarios que desee.
# En caso de error, asigne nuevos permisos de Perfiles de clientes
1. Para actualizar los permisos en caso de que se produzca un error de llamada 403 en cualquiera de los servidores APIs, diríjase a la sección de dominios de la consola de perfiles de Amazon Connect clientes y seleccione **Ver** detalles.
![\[La sección de dominios de la consola de perfiles de Amazon Connect clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png)
1. Seleccione **Actualizar permisos** en la sección de visualización de detalles del dominio.
![\[El botón Actualizar permisos aparece aquí si es necesario actualizar algún permiso pendiente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png)
1. Una vez hecho esto, los permisos se actualizarán correctamente y el botón **Actualizar permisos** ya no estará visible en la sección de detalles del dominio. Esto mitigará el problema del error de llamada prohibida 403 y podrá realizar correctamente las llamadas a la API.
![\[El botón Actualizar permisos desaparece después de completar la acción correctamente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png)
# Vencimiento de datos de Perfiles de clientes de Amazon Connect
Si un perfil no se ha actualizado en un período de tiempo específico, caducará. En consecuencia, el perfil se limpiará y eliminará del dominio de los perfiles de los clientes.
El tiempo de caducidad de los datos de los perfiles de los clientes se puede dividir en dos categorías diferentes:
## Perfiles creados mediante CreateProfile
Los perfiles creados mediante la `CreateProfile` API caducarán en función de la marca de tiempo asignada por un dominio **DefaultExpirationDays**de perfiles de clientes. Si no se ha configurado ningún vencimiento, el valor predeterminado será de 365 días.
## Los perfiles se crean o actualizan mediante PutProfileObject
Los perfiles creados o actualizados mediante el uso siempre `PutProfileObject` respetarán lo **ExpirationDays**definido en el tipo de objeto asociado a ellos. Si no se ha definido ningún vencimiento en el tipo de objeto, se utilizará la fecha de vencimiento del dominio de Perfiles de clientes. Por último, si no se proporciona ninguna, el perfil o el objeto de perfil caducarán durante los 365 días predeterminados.
## Modelo mental visualizado
![\[Un diagrama de flujo que muestra la lógica de caducidad de los perfiles de los clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-expiration-model.png)
## Vencimiento del perfil de importación
Si se ha importado un perfil a un dominio de perfil de clientes mediante la importación de segmentos, su vencimiento se producirá en dos escenarios diferentes.
1. **Definición explícita de caducidad al llamar CreateUploadJob**
De forma predeterminada, los perfiles importados mediante la importación de segmentos caducan en 14 días si no se ha realizado ninguna actualización. Este número [se puede definir](customer-segments-imported-files.md#set-profile-expiry) mediante la API o en el sitio web de Amazon Connect administración durante la creación de la importación, con un máximo de 90 días.
1. **Importación de perfiles que ya existen en su dominio de Perfiles de clientes desde un trabajo de importación anterior**
Si se han realizado dos trabajos de importación y se ha encontrado un perfil duplicado, los perfiles de cliente siempre respetarán el tiempo de caducidad más largo.
# Uso de la resolución de identidades para consolidar perfiles similares en Amazon Connect
Se habla de *perfil similar* cuando se determina que dos o más perfiles corresponden al mismo contacto. Puede haber varios perfiles cuando los registros de cliente se capturan a través de varios canales y aplicaciones para el mismo cliente y no comparten un identificador único común.
La resolución de identidades busca automáticamente perfiles similares y lo ayuda a consolidarlos. Ejecuta un trabajo de resolución de identidades semanalmente, que realiza los siguientes pasos:
1. [Coincidencia automática de perfiles](how-identity-resolution-works.md#auto-profile-matching)
1. [Combinación automática de perfiles similares](how-identity-resolution-works.md#auto-profile-merging) en función de sus criterios de consolidación
Cada vez que se ejecuta un trabajo de resolución de identidades, se muestran las métricas en la página **Perfiles de clientes**. Las métricas muestran el número de perfiles que ha revisado, el número de grupos coincidentes encontrados y el número de perfiles consolidados.
Podrían aplicarse cargos adicionales por habilitar la resolución de identidades. Para obtener más información, consulte [Precios de Amazon Connect](https://aws.amazon.com/connect/pricing/).
![\[Página Perfiles de clientes de Amazon Connect, botón Habilitar la resolución de identidades.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Habilitación de la resolución de identidades para su dominio de Perfiles de clientes de Amazon Connect
**importante**
Amazon Connect Cases no es totalmente compatible con la resolución de identidad de los perfiles de clientes de Amazon Connect cuando se utiliza el espacio de trabajo de agente. Esto es lo que ocurre con los casos existentes cuando se fusionan los perfiles:
Los casos permanecen vinculados a su ID de perfil original tras una fusión.
Los casos no se consolidan automáticamente en todos los perfiles fusionados.
No hay ningún método compatible para volver a asociar un caso existente a otro perfil. Utilice [CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html)y [CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html)como solución alternativa si necesita consolidar los casos manualmente.
Cuando habilite la resolución de identidades, deberá especificar la siguiente información:
+ Cuándo debe ejecutarse semanalmente el trabajo de resolución de identidades. De forma predeterminada, se ejecuta los sábados a las 00:00 h UTC.
+ El bucket de Amazon S3 en el que el trabajo de la resolución de identidades debe escribir los resultados del proceso de coincidencia automática de perfiles. Si no dispone de un bucket de S3, podrá crear uno durante el proceso de habilitación.
Puede consultar el bucket de Amazon S3 o utilizar la [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para filtrar los resultados en función de las [puntuaciones de confianza](how-identity-resolution-works.md#confidence-score).
Después de activar la resolución de identidades, verá la opción para [crear criterios de consolidación](create-consolidation-criteria.md) para el proceso opcional de combinación automática.
**Para habilitar la resolución de identidades**
1. Debe tener un dominio de Perfiles de clientes habilitado para su instancia. Para obtener instrucciones, consulte [Habilitación de perfiles de clientes para su instancia de Amazon Connect](enable-customer-profiles.md).
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la sección **Resolución de identidades**, elija **Habilitar la resolución de identidades**.
![\[Página Perfiles de clientes de Amazon Connect, botón Habilitar la resolución de identidades.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
1. En el cuadro emergente **Resolución de identidades**, elija **Habilitar la resolución de identidades**.
![\[Página Perfiles de clientes de Amazon Connect, botón Habilitar la resolución de identidades.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png)
1. En la página **Habilitar la resolución de identidades**, especifique la fecha y la hora en las que desea que se ejecute el trabajo de resolución de identidades.
1. Si desea revisar el perfil coincidente IDs de un bucket de Amazon S3, seleccione **Escribir coincidencias de ID de perfil con Amazon S3**. De lo contrario, puede usar la [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para revisar los perfiles coincidentes.
**nota**
Si habilita automáticamente las fusiones, no recibirá el perfil coincidente. IDs
1. El bucket de Amazon S3 en el que el trabajo de la resolución de identidades debe escribir las coincidencias de perfil.
Recomendamos aplicar una política para evitar un problema de seguridad de suplente confuso. Para obtener más información y una política de muestra, consulte [Prevención de suplentes confusos por servicios de Perfiles de clientes de Amazon Connect](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service).
1. Cuando haya terminado, elija **Habilitar la resolución de identidades**. Tanto la coincidencia basada en reglas como la coincidencia basada en ML se activan después de habilitar la resolución de identidades. Puede deshabilitar una de ellas o ambas desde la página Resolución de identidades. Para obtener más información, consulte [Desactivación de la resolución de identidades en los perfiles de clientes de Amazon Connect](disable-identity-resolution.md).
1. Coincidencia basada en reglas para la resolución de identidades:
1. Después de habilitar la coincidencia basada en reglas con un dominio nuevo, la coincidencia se iniciará inmediatamente si configura una integración y la integración está en ejecución.
1. Después de activar la coincidencia basada en reglas con un dominio existente, el proceso de coincidencia se iniciará en una hora.
1. Coincidencia basada en ML para la resolución de identidades:
1. Tras activar la resolución de identidades, el trabajo de resolución de identidades se ejecuta por primera vez en 24 horas.
**nota**
Antes de ejecutar un trabajo de resolución de identidades por primera vez en un nuevo dominio de Perfiles de clientes, le recomendamos que compruebe las métricas de su perfil para asegurarse de que se han creado los perfiles. De lo contrario, no habrá ningún resultado coincidente.
1. Le recomendamos establecer criterios de consolidación para combinar automáticamente los perfiles coincidentes. Si es así, consulte [Configuración de los criterios de consolidación para la resolución de identidades en Amazon Connect](create-consolidation-criteria.md).
# Configuración de los criterios de consolidación para la resolución de identidades en Amazon Connect
**nota**
Debe [habilitar la resolución de identidades](#create-consolidation-criteria) para acceder a la opción de creación de criterios de consolidación mediante la consola de administración de Amazon Connect.
Cuando un trabajo de resolución de identidades detecta perfiles similares, el proceso puede combinarlos automáticamente en un perfil unificado basándose en los criterios de consolidación que usted especifique.
Los atributos que seleccione se comparan en todos los perfiles similares de un grupo de coincidencias para obtener una coincidencia exacta. Por ejemplo, si especifica `email` como atributo en los criterios, todos los perfiles similares de un grupo de coincidencias que tengan exactamente el mismo valor de `email address` se combinarán en un perfil unificado.
**sugerencia**
Si quieres configurar tu propia lógica de fusión, usa la API. [MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html)
## Límites
Puede seleccionar cualquier atributo del [perfil estándar](standard-profile-definition.md) para comparar perfiles similares. Por ejemplo, puede elegir el número de teléfono, la dirección de correo electrónico y el nombre, así como atributos personalizados.
Puede especificar hasta:
+ 10 criterios de consolidación
+ 20 atributos por criterio
## Consejos para crear criterios sólidos
Para mejorar la segmentación de perfiles únicos y evitar la consolidación de perfiles que no sean duplicados, recomendamos seguir estos pasos:
+ Seleccione atributos que puedan identificar de forma exclusiva a un cliente y que no sea probable que sean los mismos en todos los clientes, como un número de cuenta o una forma de documento de identidad oficial.
+ Evite los criterios de un solo atributo. Seleccione varios atributos para crear una combinación de atributos que mejore la segmentación. Por ejemplo:
+ **Número de teléfono** con **Nombre**, **Segundo nombre**, **Apellido** es un criterio más sólido
que
+ **Número de teléfono solo**, o
+ Solo la combinación de **Nombre, Segundo nombre y Apellido**
+ Seleccione todos los atributos en un grupo de atributos específico, cuando proceda. Por ejemplo, si desea utilizar el nombre, seleccione todos los atributos de nombre relacionados: **Nombre, Segundo nombre, Apellido**. Si desea usar la dirección de la empresa, seleccione todos los atributos de la dirección de la empresa relacionados.
+ Incluya en los criterios uno de los siguientes atributos susceptibles de identificar de forma exclusiva a un cliente en combinación con otros atributos:
+ Número de cuenta
+ Número de teléfono
+ Correo electrónico
## Cómo configurar los criterios de combinación automática
Antes de configurar sus criterios de consolidación para la combinación automática, le recomendamos que consulte [Cómo funciona el proceso de combinación automática](how-identity-resolution-works.md#consolidation-criteria-how-it-works).
1. Después de activar la resolución de identidades, en la página **Resolución de identidades** tendrá la opción de configurar los criterios de combinación automática. Elija **Crear criterios de consolidación**.
1. Si recibe el cuadro de diálogo de **Falta la marca de tiempo**, le recomendamos que añada nuevos atributos de marca temporal a sus tipos de objeto personalizados antes de continuar. Consulte [Falta la marca temporal para los conflictos de perfil](#missing-timestamp-for-profile-conflicts).
1. En la sección **Conflictos de perfil**, elija cómo deben resolverse los conflictos de perfil cuando haya conflictos entre dos o más registros.
1. En la sección **Criterios de consolidación**, cree uno o más criterios. Recomendamos incluir al menos dos o más atributos por criterio.
## Falta la marca temporal para los conflictos de perfil
El mensaje **Falta marca temporal** aparece si tiene asignaciones de tipo de objeto personalizadas.
Usa la [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API para añadir los siguientes atributos nuevos a tu tipo de objeto personalizado:
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Si no se especifica el atributo de marca temporal, puede seguir creando criterios de consolidación, aunque, se utilizará una marca temporal predeterminada de cuándo se realizó la ingesta de los registros en Perfiles de clientes. Le recomendamos que agregue los nuevos atributos antes de crear sus criterios de consolidación.
Si ya ha definido un tipo de objeto personalizado y desea actualizarlo, ejecutamos una reposición programada cada semana para actualizar sus perfiles existentes con `Fields.sourceLastUpdatedTimestamp`. Para activar la reposición programada:
1. Actualice el tipo de objeto de perfil personalizado mediante la [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Después de actualizar el tipo de objeto de su perfil personalizado, cree un [ticket de Soporte](https://console.aws.amazon.com/support/home) y programaremos la reposición por usted. La reposición programada se extiende hasta finales de febrero de 2022.
Como alternativa, puedes eliminar y volver a crear el ingestion/connector que tienes para tu dominio que usa el tipo de objeto personalizado. Todos sus datos se volverán a ingerir mediante su tipo de objeto actualizado y `Fields.sourceLastUpdatedTimestamp` se analizará a partir de él.
## Ejemplo: cómo se aplican los criterios de muestra
En este ejemplo, hay tres criterios:
+ **Resolución de conflictos de perfil** se ha establecido a **Utilizar la marca de tiempo actualizada más recientemente**. Esto significa que, cuando dos campos tienen valores en conflicto, la resolución de identidades va a utilizar la última marca temporal actualizada para determinar qué valor se debe utilizar.
+ Criterio 1:
+ Nombre, apellido
+ Correo electrónico
+ Criterio 2:
+ Número de teléfono
Estos criterios se aplican a los siguientes perfiles:
+ Perfil A
+ John Doe [última actualización **05:00**a]
+ doefamily@anyemail.com [última actualización **05:00**a]
+ 555-555-5555 [última actualización **07:00**a]
+ Perfil B
+ John Doe [última actualización **04:00**a]
+ doefamily@anyemail.com [última actualización **06:00**a]
+ 555-555-555**6** [última actualización *04:00*a]
+ Perfil C
+ **Jane** Doe [última actualización **06:00**a]
+ doefamily@anyemail.com [última actualización **07:00**a]
+ 555-555-5555 [última actualización **06:00**a]
A continuación, se muestran los resultados cuando se aplica el criterio 1:
+ Los perfiles A y B se combinan = perfil AB
El resultado es el perfil AB, que tiene el siguiente aspecto:
+ John Doe [última actualización **05:00**a]
+ doefamily@anyemail.com [última actualización **07:00**a]
+ 555-555-555**5** [última actualización **06:00**a]
Como hay un conflicto entre los números de teléfono, la resolución de identidades utiliza la última marca temporal para elegir el número 555-555-555.
Después, se aplica el criterio 2. A continuación, se muestran los resultados:
+ Los perfiles AB y C se combinan = perfil ABC
El resultado es el perfil ABC, que tiene el siguiente aspecto:
+ **Jane** Doe [última actualización **06:00**a]
+ doefamily@anyemail.com [última actualización **07:00**a]
+ 555-555-555**5** [última actualización **07:00**a]
La resolución de identidades utiliza el nombre, los apellidos y el correo electrónico del perfil C porque tienen las marcas temporales más recientes.
# Machine learning para la resolución de identidades en Amazon Connect
La resolución de identidades en Amazon Connect busca automáticamente perfiles similares y lo ayuda a consolidarlos. En los temas de esta sección se describe cómo configurar la coincidencia de machine learning para consolidar los perfiles duplicados como parte del proceso de combinación automática.
**Topics**
+ [Cómo funciona la resolución de identidades mediante machine learning](how-identity-resolution-works.md)
+ [Configuración del machine learning para la resolución de identidades](setup-machine-learning-matching.md)
# Cómo funciona la resolución de identidades mediante machine learning en Amazon Connect
En este tema se describe cómo la resolución de identidades realiza la coincidencia automática de perfiles y, si está configurada, cómo combina automáticamente perfiles similares.
## Coincidencia automática de perfiles
Para identificar perfiles similares, la resolución de identidades utiliza el machine learning para revisar los siguientes atributos de información de identificación personal (PII) de cada perfil:
+ Nombre: se revisa la similitud de todos los nombres, incluidos el nombre, el segundo nombre y el apellido.
+ Correo electrónico: se revisan todas las direcciones de correo electrónico para comprobar su similitud, incluido el correo electrónico personal y el correo electrónico profesional. No distinguen entre mayúsculas y minúsculas.
+ Número de teléfono: Se revisan todos los números de teléfono y formatos para comprobar su similitud, incluidos el teléfono particular, el teléfono móvil y el teléfono de empresa.
+ Dirección: se revisan todos los tipos y formatos de direcciones para comprobar su similitud, incluida la dirección empresarial, la dirección postal, la dirección de envío y la dirección de facturación.
+ Fecha de nacimiento: se revisan todos los formatos y fechas de nacimiento para comprobar su similitud.
Utiliza esta información para crear grupos de coincidencias de perfiles similares.
### Grupos de coincidencias
Un grupo de coincidencias consta de todos los perfiles similares que representan a un cliente. Cada grupo de coincidencias contiene la siguiente información:
+ Un ID de coincidencia, que identifica de forma exclusiva el grupo de dos o más perfiles similares que representan un contacto
+ El número de perfiles del IDs grupo coincidente
+ Una puntuación de confianza asociada al grupo de coincidencias
### Puntuaciones de confianza
Una vez ejecutado el proceso de coincidencia automática, puede consultar el depósito de S3 o utilizar la [GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html)API para filtrar los resultados en función de las puntuaciones de confianza. Por ejemplo, puede filtrar las coincidencias de alta confianza para una revisión posterior.
Una puntuación de confianza es un número entre 0 y 1 que representa el nivel de confianza a la hora de asignar perfiles a un grupo de coincidencias. Es probable que una puntuación de 1 indique una coincidencia exacta.
## Combinación automática de perfiles similares
Una vez efectuada la coincidencia de los perfiles, el trabajo de resolución de identidades puede combinar opcionalmente perfiles similares según sus criterios. Si elimina o actualiza los criterios, los criterios actualizados se aplicarán a perfiles similares en la siguiente ejecución.
**importante**
No puede deshacer el proceso de consolidación. Recomendamos encarecidamente utilizar la [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API para realizar una prueba del proceso de fusión automática antes de ejecutar el Identity Resolution Job.
**nota**
Al fusionar dos perfiles, los campos de perfil completados manualmente mediante una llamada a la API o el espacio de trabajo del agente no se sobrescribirán con campos de perfil incorporados automáticamente a partir de una integración o asignación de tipo de objeto personalizado.
Por ejemplo, supongamos que un agente crea manualmente un perfil con FirstName «John» en el espacio de trabajo del agente. Se crea otro perfil mediante una integración de S3 con FirstName «Peter». Si estos perfiles se fusionan automáticamente, se conservará el nombre FirstName «John».
### Cómo funciona el proceso de combinación automática
+ **Todos los atributos seleccionados en un criterio de consolidación se conectan con criterios `AND` con comparación de valores exactos antes de combinarlos**.
+ Por ejemplo, cuando se especifican varios atributos en los criterios, como `email address` y `phone number`, se combinan todos los perfiles similares en un grupo de coincidencias que tengan exactamente el mismo valor de `email address` y `phone number`.
+ Si uno o varios de los perfiles similares de un grupo de coincidencias tienen un valor diferente o un valor omitido para uno o varios de los atributos de un criterio, los perfiles similares se combinan.
Por ejemplo, un grupo de coincidencias puede estar formado por cinco perfiles similares de los que se consolidan tres, porque estos tres perfiles cumplen los criterios. Los otros dos perfiles no se combinan porque no cumplen los criterios.
+ **Los criterios múltiples se evalúan por orden de prioridad empezando por el criterio 1**.
+ La secuencia en la que se aplican los criterios de consolidación. Comienza con el criterio 1 como la prioridad más alta hasta el criterio 10 como la prioridad más baja.
+ Una vez que el trabajo de resolución de identidades aplica un criterio, aplica el siguiente criterio a los perfiles consolidados y al resto de perfiles similares de un grupo de coincidencias.
+ Puede tener un máximo de diez criterios de consolidación.
+ **Cada criterio se ejecuta de forma independiente y funciona como `OR` junto con otros criterios**.
+ Cuando tiene varios criterios, cada uno se aplica de forma individual y en orden de prioridad antes de que el trabajo de resolución de identidades pase al siguiente criterio.
+ Todos los criterios se aplican en el orden en que se han enumerado. No importa si los criterios no se realizan o tienen éxito a la hora de consolidar perfiles similares en un grupo de coincidencias.
+ **De forma predeterminada, los conflictos de perfiles se administran por uso reciente**.
+ Cuando dos o más perfiles similares de un grupo de coincidencias cumplen un criterio de consolidación, el perfil consolidado resultante se crea mediante la comparación de cada valor de los atributos del perfil que componen perfiles similares.
+ Cada atributo puede tener un valor que coincida exactamente. En este caso, se puede seleccionar cualquier valor para ese atributo.
+ Si existe un conflicto entre los valores de dos o más perfiles similares componentes, se elige el atributo actualizado más recientemente.
Por ejemplo, si Jane Doe tiene tres valores diferentes en el atributo `Address` de los perfiles similares que lo componen, la resolución de identidades selecciona el más reciente para crear el perfil unificado.
+ De forma predeterminada, se utiliza la **Marca temporal de la última actualización** para determinar el registro que se ha actualizado más recientemente.
+ **Los conflictos de perfil se administran por tipo de objeto de origen y uso reciente**.
+ También puede cambiar el comportamiento predeterminado de la resolución de conflictos para elegir un perfil componente similar de un origen específico como único origen de información para informar de la resolución de conflictos.
+ Si desea especificar un origen de datos que se utilizará para los conflictos de perfil, puede elegir uno de sus tipos de objeto como origen de datos si selecciona **Fuente con la marca de tiempo actualizada más recientemente**.
+ Para resolver los conflictos de perfil, se utiliza el registro actualizado más recientemente del tipo de objeto especificado.
+ **La marca temporal de la última actualización identifica qué registro se actualizó más recientemente**.
+ El atributo de marca temporal asociado al tipo de objeto del registro de origen se utiliza para identificar qué registro se actualizó más recientemente.
+ Si el atributo de marca temporal no está disponible para el tipo de objeto, se utilizará la marca temporal en la que el registro se ingirió en su dominio de Perfiles de clientes.
+ Si tiene tipos de objetos personalizados, debe agregar marcas temporales. Para obtener más información, consulte [Falta la marca temporal para los conflictos de perfil](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts).
+ **La consolidación es un proceso unidireccional y no se puede deshacer**.
+ Elija sus criterios cuidadosamente antes de iniciar el proceso de consolidación. Para obtener más información, consulte [Consejos para crear criterios sólidos](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria).
+ Utilice la [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html)API para probar la configuración de fusión automática de su resolución de identidad sin fusionar los datos.
Para obtener un ejemplo que muestra cómo se aplican los criterios, consulte [Ejemplo: cómo se aplican los criterios de muestra](create-consolidation-criteria.md#criteria-examples).
# Configuración del machine learning para la resolución de identidades en Amazon Connect
## Edición de la programación de ejecución de coincidencias de machine learning
![\[Editar la programación de ejecución de coincidencias de machine learning.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png)
## Edición de la combinación de coincidencias de machine learning
![\[Editar la combinación de coincidencias de machine learning.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png)
## Edición de la ubicación de coincidencias de machine learning
![\[Editar la ubicación de coincidencias de machine learning.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png)
# Coincidencia basada en reglas para la resolución de identidades en Amazon Connect
La resolución de identidades en AC busca automáticamente perfiles similares y lo ayuda a consolidarlos. En los temas de esta sección se describe cómo configurar la resolución de identidades basada en reglas para consolidar los perfiles duplicados como parte del proceso de combinación automática.
**Topics**
+ [Cómo funciona la resolución de identidades basada en reglas](how-rule-based-identity-resolution-works.md)
+ [Configuración de la coincidencia basada en reglas para la resolución de identidades](setup-rule-based-matching.md)
+ [Configuración de las reglas de coincidencia para la resolución de identidades basada en reglas](setup-matching-rule-examples.md)
# Cómo funciona la resolución de identidades basada en reglas en Amazon Connect
En este tema se describe cómo la resolución de identidades basada en reglas realiza la coincidencia automática de perfiles y cómo combina automáticamente perfiles similares.
## Coincidencia automática de perfiles
Para identificar perfiles similares, la resolución de identidades basada en reglas utiliza una lista de [atributos de regla coincidentes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) para la coincidencia cada perfil. Se admiten hasta 15 MatchingRule atributos en. [MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules)
### Reglas de coincidencia
La siguiente es una lista de los [ MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)atributos que se pueden utilizar. Puede configurar hasta 15 niveles de reglas de coincidencias. Para cada regla de coincidencias, puede utilizar los siguientes atributos de información de identificación personal (PII) en cada perfil:
+ **AccountNumber**
+ **Dirección.Dirección**: se revisan todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) para comprobar su similitud, incluidas las direcciones, BusinessAddress, y MaillingAddress ShippingAddress
+ **Dirección.Ciudad**: todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidas la dirección,, y BusinessAddress MaillingAddress ShippingAddress
+ **Dirección. País**: todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidas la dirección,, y BusinessAddress MaillingAddress ShippingAddress
+ **Dirección. Condado**: todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidas la dirección,, y BusinessAddress MaillingAddress ShippingAddress
+ **Dirección. PostalCode**: Se revisan todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) para comprobar su similitud, incluidas las direcciones BusinessAddress, MaillingAddress, y ShippingAddress
+ **Dirección. Estado**: todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidas la dirección, BusinessAddress, y MaillingAddress ShippingAddress
+ **Dirección.Provincia**: todas las direcciones especificadas en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidas la dirección,, y BusinessAddress MaillingAddress ShippingAddress
+ **PhoneNumber**: Los números de teléfono especificados en el [Selector de tipo de atributo](#rule-based-attribute-type-selector) se revisan para comprobar su similitud, incluidos PhoneNumber HomePhoneNumber, y. MobilePhoneNumber
+ **EmailAddress**: Se revisa la similitud de todas [Selector de tipo de atributo](#rule-based-attribute-type-selector) las direcciones de correo electrónico especificadas en el EmailAddress, incluidas BusinessEmailAddress, y PersonalEmailAddress
+ **BirthDate**
+ **BusinessName**
+ **FirstName**
+ **LastName**
+ **MiddleName**
+ **Gender**
+ **Cualquier atributo de perfil personalizado con el prefijo *Attributes***
Las reglas de coincidencia se procesan por prioridad. Por ejemplo, la primera regla debe ser la más optimizada que desee definir y debe utilizarse para obtener el resultado más preciso.
### Selector de tipo de atributo
El selector de tipos de atributos contiene información de configuración vital para la resolución de identidades basada en reglas, lo que facilita la coincidencia de perfiles. Esto le permite afinar la comparación de perfiles entre tipos de atributos y seleccionar los atributos clave para la coincidencia en cada tipo. En esta característica, tiene la flexibilidad de configurar tres tipos de atributos distintos, lo que permite un control preciso del proceso de coincidencia.
+ **Tipo de Email**
+ Puede elegir entre EmailAddress BusinessEmailAddress, y PersonalEmailAddress
+ **PhoneNumber type**
+ Puede elegir entre PhoneNumberNumber HomePhoneNumber, y MobilePhoneNumber
+ **Tipo de Address**
+ Puede elegir entre Dirección BusinessAddress, MaillingAddress, y ShippingAddress
Puede elegir `ONE_TO_ONE` o `MANY_TO_MANY` como AttributeMatchingModel. Al elegir `MANY_TO_MANY`, el sistema puede hacer coincidir los atributos de los subtipos de un tipo de atributo. Por ejemplo, si el valor del EmailAddress campo del perfil A y el valor del BusinessEmailAddress campo del perfil B coinciden, los dos perfiles coinciden en el EmailAddress tipo. Al elegir `ONE_TO_ONE`, el sistema solo puede establecer una coincidencia si los subtipos coinciden exactamente. Por ejemplo, solo cuando el valor del EmailAddress campo del perfil A y el valor del EmailAddress campo del perfil B coinciden, los dos perfiles coinciden en el EmailAddress tipo.
**Nivel de regla máximo permitido para la coincidencia**
Puede configurar el nivel de regla máximo que desea utilizar para hacer coincidir perfiles similares. Por ejemplo, si su nivel de regla máximo permitido para la coincidencia es 5, el sistema no encontrará perfiles similares mediante el nivel de reglas 6.
### Grupos de coincidencias
Un grupo de coincidencias consta de todos los perfiles similares que representan a un cliente. Cada grupo de coincidencias contiene la siguiente información:
+ Un ID de coincidencia, que identifica de forma exclusiva el grupo de dos o más perfiles similares que representan un contacto
+ El número de perfiles IDs del grupo coincidente
### Estado de coincidencia
+ **PENDING**
El primer estado después de la configuración de una regla de coincidencia basada en reglas. Si se trata de un dominio existente, la resolución de identidades basada en reglas espera una hora antes de crear la regla coincidente. Si se trata de un nuevo dominio, el sistema omitirá la etapa **PENDIENTE**.
+ **EN\$1PROCESO**
El sistema está creando la regla de coincidencia basada en reglas. En este estado, el sistema está evaluando los datos existentes y ya no puede modificar la configuración de coincidencia basada en reglas.
+ **ACTIVO**
La regla está lista para utilizarla. Puede cambiar la regla un día después de que el estado sea **ACTIVO**.
### Cómo funciona el proceso de coincidencia automática
Tras crear un nuevo dominio de Perfiles de clientes de Amazon Connect con la regla de coincidencias basada en reglas, la resolución de identidades basada en reglas realizará coincidencias de perfiles similares en función de la regla que especificó al ingerir los perfiles. Si actualiza la configuración de la coincidencia basada en reglas, Perfiles de clientes empezará a reevaluar los perfiles de su dominio con la nueva configuración en una hora.
Si va a activar la coincidencia basada en reglas con un dominio existente, el sistema pasará a un estado **PENDIENTE** y empezará a evaluar los perfiles existentes en su dominio con la nueva configuración en una hora. El tiempo que se tarda en terminar de evaluar los perfiles depende de cuántos perfiles existan.
+ **De forma predeterminada, se aplicará la regla predeterminada si no se especifica ninguna personalizada.**
+ Perfiles de clientes de Amazon Connect proporciona una regla de coincidencia predeterminada si no proporciona una personalizada. Puede consultar la regla de coincidencia personalizada aquí.
+ **Todos los registros pasarán por las reglas de coincidencia basada en reglas.**
+ El sistema evalúa cada nivel de regla de coincidencia hasta que se identifica una coincidencia o hasta que se alcanza el nivel de regla máximo permitido para la coincidencia. El proceso de evaluación comienza en el nivel de regla 1, donde se analiza el registro. Si no se descubre ningún grupo de coincidencias, el sistema procede a evaluar los niveles de reglas siguientes y busca un grupo de coincidencias hasta que se encuentre una coincidencia o se alcance el nivel máximo de reglas permitido para la coincidencia.
+ **Todos los atributos de un mismo nivel de regla de coincidencia se conectan mediante una relación *Y***
+ Cuando hay varios atributos presentes en un mismo nivel de regla, están interconectados mediante una relación Y. Durante la coincidencia de perfiles, todos los valores de los atributos deben alinearse para que los perfiles se asignen al mismo grupo de coincidencias. Por ejemplo, solo cuando los valores de todos los atributos sean idénticos, los perfiles se considerarán coincidencias y se agruparán para su posterior procesamiento.
+ **Todos los atributos de un selector de tipo de atributo están conectados con una relación *O***
+ Al especificar atributos en el selector de tipo de atributo, los atributos del mismo tipo se vinculan mediante una relación O. Por ejemplo, considere el PhoneNumber tipo en el que se utilizan HomePhoneNumber y en el BusinessPhoneNumber que se utilizan. En este escenario, dos perfiles pueden coincidir si están alineados HomePhoneNumber o están BusinessPhoneNumber alineados. En consecuencia, el proceso de coincidencia permite coincidencias flexibles basadas en los números de teléfono particulares o de empresa.
+ **Al final se optimiza el resultado de la coincidencia.**
+ Debido a la naturaleza casi en tiempo real de la coincidencia de perfiles en el sistema, existe la posibilidad de que se encuentre un grupo de coincidencias para su perfil en un nivel de reglas inferior (menos optimizado). No obstante, si se dispone de una coincidencia en un nivel de reglas superior (más optimizado), el sistema asignará el perfil a ese grupo concreto.
**nota**
Cuando la resolución de identidades realiza una coincidencia basada en reglas, el orden en que se procesarán las reglas que haya configurado depende de cómo se ingieran los datos. Por ejemplo, si configura las reglas 1 y 2, es posible que la regla 2 se procese antes que la regla 1. El orden de procesamiento puede cambiar, pero el resultado final será siempre el mismo.
## Combinación automática de perfiles similares
Una vez coincidentes los perfiles, Identity Resolution Job puede combinar opcionalmente perfiles similares en función de [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)lo que especifique en la configuración de coincidencia basada en reglas.
**importante**
No puede deshacer el proceso de consolidación. Se recomienda activar la coincidencia solo primero para evaluar el resultado de la coincidencia con y. ListMatches GetSimiliarProfiles APIs Puedes activar la fusión configurando el [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html)uso de la [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
**nota**
Al fusionar dos perfiles, los campos de perfil completados manualmente mediante una llamada a la API o el espacio de trabajo del agente no se sobrescribirán con campos de perfil incorporados automáticamente a partir de una integración o asignación de tipo de objeto personalizado.
Por ejemplo, supongamos que un agente crea manualmente un perfil con FirstName «John» en el espacio de trabajo del agente. Se crea otro perfil mediante una integración de S3 con FirstName «Peter». Si estos perfiles se fusionan automáticamente, se conservará el nombre FirstName «John».
# Configuración de coincidencias basadas en reglas para la resolución de identidades en Amazon Connect
En este tema se ofrece un recorrido ilustrativo de los pasos que se utilizan para editar los tipos de atributos coincidentes basados en reglas, las reglas de coincidencia basadas en reglas, las reglas de combinación coincidentes basadas en reglas y las ubicaciones de coincidencia basadas en reglas. También muestra cómo restablecer las reglas de coincidencia basadas en reglas.
## Edición de los tipos de atributos de coincidencia basada en reglas
![\[Editar los tipos de atributos de coincidencia basada en reglas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/rule-based-edit-attribute-types.png)
## Edición de las reglas de coincidencia basada en reglas
![\[Editar las reglas de coincidencia basada en reglas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/rule-based-edit-matching-rules.png)
## Restablecimiento de las reglas de coincidencia basada en reglas
![\[Restablecer las reglas de coincidencia basada en reglas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/rule-based-edit-reset-rules.png)
## Edición de las reglas de combinación de coincidencias basada en reglas
![\[Edición de las reglas de combinación de coincidencias basada en reglas\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/rule-based-edit-merge-rules.png)
## Edición de la ubicación de la coincidencia basada en reglas
![\[Editar la ubicación de la coincidencia basada en reglas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/rule-based-match-location.png)
# Configuración de las reglas de coincidencias para la resolución de identidades basada en reglas en Amazon Connect
## Límites
Puede seleccionar cualquier atributo del perfil estándar para comparar perfiles similares. Por ejemplo, puede elegir el número de teléfono, la dirección de correo electrónico y el nombre, así como atributos personalizados.
Puede crear una regla de coincidencia basada en reglas con las siguientes limitaciones:
+ 15 niveles de reglas
+ Cada nivel de regla puede contener hasta 15 atributos de perfil
## Consejos
Para mejorar la segmentación de perfiles únicos y evitar la consolidación de perfiles que no sean duplicados, se recomiendan los siguientes consejos:
+ Incluya al menos un atributo de alta cardinalidad que pueda identificar de forma exclusiva a un cliente y que no sea probable que sea el mismo en todos los clientes, como un número de teléfono, una dirección de correo electrónico o un número de cuenta.
+ Evite utilizar atributos de perfil que puedan pertenecer a diferentes identidades sin un atributo de alta cardinalidad.
+ **Número de teléfono** con **Nombre** y **Apellido** es una regla más sólida que la combinación de **Nombre** y **Apellido** solos.
+ Si, en un nivel de regla, todos los atributos de perfil de esa regla son atributos de cardinalidad baja (el atributo que puede pertenecer a más de 500 perfiles diferentes), Perfiles de clientes no intentará establecer una coincidencia con el perfil. Recibirá el siguiente mensaje de SQS en su DLQ si ha configurado uno durante la creación del dominio:
+ Todos los atributos del nivel de regla x están asociados a más de 500 registros.
+ Active siempre primero **solo la opción de coincidencia**, compruebe los resultados de las coincidencias y solo active la combinación configurando la opción **MaxAllowedRuleLevelForMerging**si está satisfecho con los resultados de las coincidencias.
## Resolución de conflictos de perfiles para combinar perfiles
Puede definir qué registro se utilizará cuando el valor de un atributo de dos o más perfiles similares sea diferente, como sucede con los registros de direcciones en conflicto.
**Marca temporal de la última actualización**
De forma predeterminada, los conflictos de perfiles se administran por uso reciente. Cuando hay un conflicto entre los valores de dos o más perfiles similares, se elegirá el atributo actualizado más recientemente.
**Fuente con la marca de tiempo actualizada más recientemente**
Le permite dar prioridad a los registros de un tipo de objeto específico como origen de datos para administrar los conflictos entre perfiles. Cuando hay un conflicto entre los valores de dos o más perfiles similares, se elegirá el atributo actualizado más recientemente del tipo de objeto especificado.
Si no se especifica una marca temporal en su tipo de objeto, se utilizará la fecha en que se realizó la ingesta del registro en Perfiles de clientes. El origen con la marca temporal actualizada más recientemente no está disponible cuando no tiene ninguna integración configurada. Cuando agregue una integración, sus tipos de objetos estarán disponibles como origen de esta opción.
## Falta la marca temporal para los conflictos de perfil
El mensaje Falta marca temporal aparece si tiene asignaciones de tipo de objeto personalizadas.
Usa la [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API para añadir los siguientes atributos nuevos a tu tipo de objeto personalizado:
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
Si no se especifica el atributo de marca temporal, puede seguir creando criterios de consolidación, aunque, se utilizará una marca temporal predeterminada de cuándo se realizó la ingesta de los registros en Perfiles de clientes. Se recomienda agregar los nuevos atributos antes de crear sus criterios de consolidación.
Si ya ha definido un tipo de objeto personalizado y desea actualizarlo, ejecutamos una reposición programada cada semana para actualizar sus perfiles existentes con `Fields.sourceLastUpdatedTimestamp`. Para activar la reposición programada, utilice los siguientes pasos:
1. Actualice el tipo de objeto de perfil personalizado mediante la [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.
1. Tras actualizar el tipo de objeto de perfil personalizado, abra un [ticket de AWS Support](https://console.aws.amazon.com/support/home).
1. AWS programará el relleno en tu nombre. La reposición programada se extiende hasta finales de febrero de 2022.
Como alternativa, puede eliminar y volver a crear la ingesta o el conector que tiene para su dominio y que utiliza el tipo de objeto personalizado. Todos sus datos se volverán a ingerir mediante su tipo de objeto actualizado y `Fields.sourceLastUpdatedTimestamp` se analizará a partir de él.
## Ejemplo: cómo funciona la coincidencia
### Ejemplo de ONE\$1TO\$1ONE
Puede elegir `ONE_TO_ONE` como `AttributeMatchingModel`. Al elegir `ONE_TO_ONE`, el sistema solo puede establecer una coincidencia si los subtipos coinciden exactamente.
**Por ejemplo**:
Utiliza `EmailAddress` y `BusinessEmailAddress` para representar los tipos de `EmailAddress`. El valor de `AttributeMatchingModel` es `ONE_TO_ONE`.
**Su regla de coincidencia es**:
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
El perfil A y el perfil B coinciden en el nivel de regla 1, ya que el tipo `EmailAddress`, `LastName` y `FirstName` coinciden.
### Ejemplo de MANY\$1TO\$1MANY
Puede elegir `MANY_TO_MANY` como `AttributeMatchingModel`. Al elegir `MANY_TO_MANY`, el sistema puede hacer coincidir los atributos de los subtipos de un tipo de atributo.
**Por ejemplo**:
Utiliza `EmailAddress` y `BusinessEmailAddress` para representar los tipos de `EmailAddress`. El valor de `AttributeMatchingModel` es `MANY_TO_MANY`.
**Su regla de coincidencia es**:
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress)
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress)
LastName: Doe
FirstName: John
AccountNumber: account1234
```
El perfil A y el perfil B coinciden en el nivel de regla 1, ya que el tipo `EmailAddress`, `LastName` y `FirstName` coinciden.
# Visualización de las métricas de resolución de identidades en los perfiles de clientes de Amazon Connect
Siempre que la resolución de identidades realice las coincidencias de perfiles o los combine, las métricas sobre el proceso se muestran en el panel Perfiles de clientes. Puede consultar la métrica de la semana transcurrida en la página de resumen de **Resolución de identidades**.
Las siguientes métricas se generan cada vez que se ejecuta el trabajo de resolución de identidades:
+ **Grupos de coincidencia encontrados**: número de grupos de coincidencias encontrados.
+ Disponible tanto para la resolución de identidades basada en ML como en reglas.
+ **Perfiles fusionados**: el número de perfiles que se han combinado.
+ Disponible tanto para la resolución de identidades basada en ML como en reglas.
+ **Grupo de coincidencias por regla**: el número de grupos de coincidencias que ha creado cada nivel de regla.
+ Solo está disponible para la resolución de identidades basada en reglas.
![\[Página Perfiles de clientes de Amazon Connect, botón Habilitar la resolución de identidades.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ir-metrics-example-1.png)
![\[Página Perfiles de clientes de Amazon Connect, botón Habilitar la resolución de identidades.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Desactivación de la resolución de identidades en los perfiles de clientes de Amazon Connect
## Desactivación de la coincidencia basada en machine learning
Puede desactivar la coincidencia basada en machine learning cuando ya no desee que encuentre automáticamente perfiles similares. Si tiene criterios de consolidación, se eliminarán todos sus criterios y sus perfiles dejarán de consolidarse automáticamente. Los perfiles que ya se hayan consolidado permanecerán consolidados.
## Desactivación de la coincidencia basada en reglas
Puede desactivar la coincidencia basada en reglas cuando ya no desee que encuentre automáticamente perfiles similares. Si tiene una regla de coincidencia personalizada, se eliminará y sus perfiles dejarán de consolidarse automáticamente. Los perfiles que ya se hayan consolidado permanecerán consolidados.
# Resolución con AWS Entity Resolution
Los perfiles de clientes de Amazon Connect ofrecen un *conector gestionado* que le permite importar directamente los resultados coincidentes desde AWS Entity Resolution. Esta integración le permite aprovechar las potentes capacidades de coincidencia de AWS Entity Resolution y, al mismo tiempo, mantener los perfiles de sus clientes en Amazon Connect.
AWS Entity Resolution lo ayuda a hacer coincidir y vincular los registros relacionados en sus distintas fuentes de datos mediante técnicas de coincidencia flexibles, como reglas, aprendizaje automático o proveedores de datos de terceros. Al conectar los resultados de Entity Resolution con los perfiles de los clientes, puede:
+ Consolide los registros de clientes de varios sistemas con mayor precisión
+ Aplique una lógica de correspondencia sofisticada en función de las necesidades específicas de su negocio
+ Mejore los perfiles de los clientes con datos enlazados de diversas aplicaciones y canales
+ Mantenga una visión coherente de los clientes en toda su organización
Para empezar a utilizar AWS Entity Resolution con perfiles de clientes, primero tendrá que configurar los flujos de trabajo correspondientes en la consola de AWS Entity Resolution. [Más información sobre AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html).
Para configurarlo, necesita los siguientes requisitos previos:
+ Instancia activa de Amazon Connect con perfiles de clientes activados
+ Datos de clientes almacenados en Amazon S3
+ Permisos de IAM adecuados para acceder a AWS Entity Resolution
**Para configurarlo, siga estos pasos:**
1. Cree un dominio de perfiles de clientes
+ Si aún no lo has hecho, crea un dominio de Customer Profiles en tu instancia de Connect
+ Dirígete a la sección Perfiles de clientes de tu consola de Amazon Connect.
+ Nota: Verás una nueva sección para AWS Entity Resolution después de crear el dominio
1. Configurar la resolución de entidades de AWS
+ En su dominio de perfiles de clientes, busque la sección AWS Entity Resolution
+ Haga clic en «Configurar la resolución de entidades de AWS»
+ Se le redirigirá a la consola de AWS Entity Resolution.
+ Cree un flujo de trabajo coincidente
+ Configure sus fuentes de datos de S3
+ Defina los criterios de coincidencia
+ Revisa y activa tu flujo de trabajo coincidente
1. Conecte los resultados de Entity Resolution con los perfiles de los clientes
+ Regrese a su dominio de perfiles de clientes
+ Seleccione su flujo de trabajo de resolución de entidades
+ Configure cómo deben consolidarse los registros coincidentes
+ Habilite la integración
# Integración aplicaciones externas con Perfiles de clientes de Amazon Connect
Amazon Connect proporciona un conjunto de integraciones prediseñadas impulsadas por Amazon y AppFlow Amazon. EventBridge Una vez que haya habilitado Perfiles de clientes de Amazon Connect, podrá utilizar estas integraciones para combinar información de aplicaciones externas, como Salesforce o Zendesk, con el historial de contactos de Amazon Connect. De este modo se crea un perfil de cliente que contiene toda la información que los agentes necesitan durante las interacciones con los clientes en un solo lugar.
También puedes usar los perfiles de clientes en Amazon AppFlow. Amazon AppFlow admite `CustomerProfiles` como destino. Puedes usar Amazon AppFlow APIs para enviar datos a los perfiles de los clientes utilizando `CustomerProfiles` como nombre de destino.
Antes de empezar, asegúrese de que utiliza una clave administrada por el cliente. Para obtener más información sobre la configuración de las claves de KMS, consulte [Creación de la clave de KMS que utilizará Perfiles de clientes para cifrar los datos (obligatorio)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey).
## Configuración de integraciones
Puede configurar una integración con aplicaciones destacadas de Amazon Connect o aplicaciones externas con Amazon. AppFlow Para ello, elija el método que mejor se adapte a su caso de uso a continuación. Para obtener información más detallada sobre la integración de Amazon ServiceNow y Slack, consulta la entrada del blog [Combine datos de varias fuentes con Amazon AppFlow y cree un perfil de cliente de Amazon Connect unificado para los agentes del centro de contacto](https://aws.amazon.com/blogs/contact-center/unified-customer-data/).
**Topics**
+ [Configuración de integraciones](#setup-integrations-title-menu)
+ [Configuración de la integración de aplicaciones destacadas en Amazon Connect](integrate-customer-profiles-appflow.md)
+ [Configura la integración para aplicaciones externas mediante Amazon AppFlow](integrate-external-applications-appflow.md)
+ [
# Eliminación de Perfiles de clientes o detención de las integraciones
](delete-customer-profile-connection.md)
# Configuración de la integración de aplicaciones destacadas en Amazon Connect
Estas integraciones utilizan aplicaciones destacadas de Amazon Connect para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect.
## Antes de empezar
### Ingesta en bloque de datos
Cuando configure su integración, se le pedirá que introduzca una fecha hasta la que desee retroceder para la ingesta de datos. Si elige una fecha de hace más de dos meses, Perfiles de clientes habilita automáticamente la ingesta masiva mediante la creación de varios flujos. Lo hace para que no tenga que calcular cuántos flujos necesita para la ingesta de datos.
Cuando la ingesta en bloque automática está habilitada, Perfiles de clientes hace lo siguiente:
+ Establece el tamaño del lote en dos meses.
+ Hace tres reintentos en errores transitorios antes de fallar.
Puedes usar la [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API para calcular tu propio tamaño de lote.
### ¿Por qué se me pide que seleccione o cree un rol de IAM?
En el caso de Salesforce, Marketo y Customer Profiles ServiceNow, ayuda a mejorar el registro histórico de estas fuentes, ya que utiliza su función de IAM para crear varios flujos de trabajo que le permitan procesar sus datos de forma rápida y eficiente.
Para estos orígenes, si selecciona más de 60 días atrás en el selector **Fecha de importación de los registros**, se le pedirá que cree un nuevo rol de IAM o que seleccione uno existente. Este rol permite a Perfiles de clientes administrar su integración. Proporciona a Perfiles de clientes los permisos necesarios para actualizar y crear un flujo de trabajo para la ingesta de sus datos. Una vez completado el flujo de trabajo, Perfiles de clientes crea una integración estándar y continua que realiza la ingesta de sus nuevos datos a medida que se actualizan en su origen.
El rol creado en la consola solo lo puede utilizar el dominio en el que se creó. Esto se debe a que Amazon Connect limita el acceso del rol solo a la clave de KMS que utiliza el dominio.
Para obtener más información, consulte [Concesión de acceso de privilegio mínimo a su rol de ejecución de Perfiles de clientes](#grant-least-privilege-cp).
## Concesión de acceso de privilegio mínimo a su rol de ejecución de Perfiles de clientes
Si desea crear su propio rol de IAM, le recomendamos que utilice los permisos que se muestran en el siguiente código para limitar el rol a los permisos mínimos necesarios. Utilice el siguiente fragmento para crear su rol manualmente. Utilice su propia clave de KMS y especifique su región cuando sea necesario.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.
# Configuración de la integración de Amazon Connect Cases
Para actualizar Amazon Connect los datos de sus casos en los perfiles de clientes de Amazon Connect y utilizar funciones como los atributos calculados, puede realizar la integración mediante Amazon AppIntegrations. Comience por configurar una transmisión de eventos de Cases para enviar los campos del sistema a un EventBridge autobús y, a continuación, utilice Amazon AppIntegrations para reenviar estos eventos a los perfiles de los clientes.
## Transmisión de datos desde Amazon Connect Cases a EventBridge
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[El alias de la instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. En el panel de navegación, seleccione **Casos** y anote su ID de dominio de Cases en la sección **Detalles del dominio**.
![\[En la página Casos, en la sección Detalles del dominio, una flecha apunta hacia el ID del dominio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. Con AWS CLI, cree una configuración de eventos de casos para enviar los eventos de Amazon Connect Cases al bus Cuenta de AWS de Event Bridge predeterminado.
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. Abra la consola de Event Bridge de su AWS región. Por ejemplo, [¿https://us-west-2.console.aws.amazon.com/events/en casa? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Seleccione **Crear bus de eventos**.
![\[La página de autobuses de eventos de la EventBridge consola de Amazon, el botón Crear bus de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Cree un bus de eventos con el nombre `connect-cases-to-customer-profiles`.
![\[La página Crear bus de eventos con el cuadro Nombre.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Vuelva al **bus de eventos predeterminado** y cree una regla con el nombre `connect-cases-to-customer-profiles-rule`.
![\[El bus de eventos predeterminado con el botón Crear regla.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[El paso Crear patrón de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Fragmento de Patrón de eventos:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[La sección Método de creación con la opción Patrón personalizado (editor JSON) y el código del patrón de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Seleccione **Saltar a revisar y crear** y elija **Crear regla**.
![\[El botón Saltar a revisar y crear.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Introduzca los datos de los casos de Event Bridge en los perfiles de los clientes mediante AppIntegrations
1. Con el AWS CLI, cree una integración de eventos con AppIntegrations y registre la salida del ARN. Esto representa un origen de datos que puede utilizar una instancia de Amazon Connect.
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. Con el AWS CLI, cree una integración con los perfiles de los clientes mediante la API put-integration. Esto iniciará el flujo de datos hacia Perfiles de clientes y sustituirá los valores de los marcadores de posición por el ARN de integración de eventos y el nombre de dominio del perfil del cliente.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Verificación de la integración de Casos
1. Cree un caso en Amazon Connect Cases.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y asóciela con un perfil de cliente.
1. Con el AWS CLI, busque el objeto Connect-case debajo del perfil y sustituya los marcadores de posición por los valores correctos.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Si no encuentra ningún elemento en la respuesta a la llamada a la API anterior, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
1. Compruebe si la configuración de eventos de su caso está configurada correctamente.
1. Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
# Configura la integración de Amazon Connect con Salesforce ServiceNow, Marketo o Zendesk
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puede realizar la integración con Salesforce ServiceNow, Marketo o Zendesk mediante Amazon. AppFlow Primero debe configurar la conexión en Amazon Connect y la aplicación de su elección y, a continuación, verificar la integración.
## Configurar la conexión en Amazon Connect y Salesforce ServiceNow, Marketo o Zendesk
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**, como se muestra en la imagen siguiente.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen de datos**, elija de qué aplicación externa desea obtener los datos de los perfiles de clientes. Puede ver los [requisitos de integración](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) para comprender mejor los requisitos de conexión necesarios para su aplicación.
![\[Página Seleccionar origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Utilizar la conexión existente**: esto le permite reutilizar AppFlow los recursos de Amazon existentes que haya creado en su cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puede utilizar las asignaciones de objetos que ha creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Cuando agregue o cree la integración de Salesforce para la asignación de datos creada por el usuario, deberá especificar la asignación de datos específica; de lo contrario, elegirá la asignación de datos predeterminada de Salesforce para el tipo de objeto. Puede crear su asignación de datos y utilizarla cuando establezca un conector de datos destacado.
![\[La página de opciones de integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de esta fecha. De forma predeterminada, la fecha de importación de registros se establece 30 días antes.
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Crear integración**.
![\[Página Revisar e integrar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Una vez configurada la integración, vuelva a la página **Configuración de perfiles de clientes** y seleccione **Ver objetos** para ver qué datos se están agrupando y enviando. Actualmente, este proceso realiza la ingesta de los registros que se crearon o modificaron en los últimos 30 días.
![\[Página Configuración de perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Configuración de la integración de Segment para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puedes integrarlos con Segment mediante Amazon AppFlow. Primero debe configurar la conexión en Amazon Connect y Segment; a continuación, verificar la integración de Segment.
## Configuración de la conexión en Amazon Connect y Segment
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen de datos**, elija **Segment**. Revise los requisitos de solicitud que aparecen en la página **Seleccionar aplicación**.
![\[Página Seleccionar origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Usa la conexión existente**: esto te permite reutilizar EventBridge los recursos de Amazon existentes que hayas creado en tu Cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nombre de la conexión**: proporcione un nombre para la conexión. Las integraciones que utilizan esta conexión hacen referencia al nombre de la conexión.
+ **URL de conexión**: introduzca la URL de conexión de la aplicación. Esta URL se utiliza para establecer enlaces profundos a los objetos creados en la aplicación externa. La URL de conexión es la URL del espacio de trabajo de Segment disponible en el sitio web de la aplicación.
Para encontrar la URL de su espacio de trabajo:
1. Inicie sesión en su cuenta de segment.com.
1. Vaya a **Configuración**, **Configuración general**.
1. Copie la URL del navegador.
1. Customer Profiles utiliza Amazon EventBridge para las integraciones con Segment. En la página de **configuración de Source**, copia tu Cuenta de AWS ID en el portapapeles y, a continuación, selecciona **Log in to Segment** para configurar Amazon EventBridge.
1. Utilice las siguientes instrucciones para configurar Segment:
1. Inicie sesión en Segment.
1. En tu aplicación, selecciona una fuente para configurar el destino en Amazon EventBridge.
1. Pega tu Cuenta de AWS ID y selecciona tu AWS región.
1. Cambie a **ACTIVAR**, para activar el origen de evento de socio.
1. Vaya a **Evaluador de eventos** y envíe un evento de prueba para completar la activación del origen de evento de socio.
1. **ID de cliente**: es una cadena que distingue de forma única al cliente en la aplicación externa. Este ID de cliente es el nombre de origen disponible en el sitio web de la aplicación. Utilizará el ID que especifique para identificar al cliente del que desea que Perfiles de clientes ingiera sus objetos.
Para encontrar el ID de origen:
1. Vaya a **Orígenes** y elija un origen.
1. Vaya a **Configuración**, **Claves de API**.
1. Copie su **ID de origen**.
Tras configurar el destino de origen de evento, vuelva a la consola de Perfiles de clientes y pegue el ID de cliente.
1. Verá una alerta que indica que Amazon Connect se ha conectado correctamente con Segment.
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puedes usar las asignaciones de objetos que has creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[Página Opciones de integración, sección Tipo de objeto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de agregar la integración.
**nota**
Si necesita registros históricos, puede [utilizar Amazon S3 como origen de integración para importarlos](customer-profiles-object-type-mappings.md).
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Agregar integración**.
1. Una vez configurada la integración, de vuelta en la página **Configuración de perfiles de clientes**, la página **Integraciones** muestra las integraciones que están actualmente configuradas. La **Última ejecución** y el **Estado de integración** no están disponibles actualmente para este tipo de integración.
![\[Página Configuración de perfiles de clientes, sección Integraciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver qué datos se están enviando, elija la integración y, a continuación, seleccione **Ver objetos**.
## Verificación de la integración de Segment
Para realizar este paso, necesita los siguientes requisitos previos:
+ Acceda a su espacio de trabajo de Segment.
+ [Acceda al panel de control de contactos de Amazon Connect](amazon-connect-contact-control-panel.md).
**Para verificar la integración de Segment**
1. Vaya al panel de su espacio de trabajo de Segment y elija **Destinos**.
![\[Página de descripción general de Segment.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Verá una lista de destinos a los que Segment envía datos. Elija el EventBridge destino de los perfiles de los clientes.
![\[Página de la lista de destinos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Seleccione la pestaña **Evaluador de eventos**. Desde esta página, enviará un evento de prueba a Perfiles de clientes. Se realiza la ingesta del evento y se convierte en un perfil de cliente que puede consultar en la aplicación del agente de Amazon Connect.
![\[Pestaña del evaluador de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Seleccione **Identificar** como tipo de evento y seleccione **Generador de eventos** como método de entrada.
1. Puede especificar un **seudónimo** y algunas características. Los agentes pueden buscar estas características en la aplicación del agente.
1. Elija **Enviar evento**.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y cree un perfil de cliente.
1. Abra la aplicación de agente de Amazon Connect. Busque el ID de usuario que introdujo en el **Generador de eventos**. Debería ver el perfil del cliente con el ID de usuario y las características que ha introducido.
1. Si no ve el perfil del cliente, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.
# Configuración de la integración de Shopify para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puedes integrarte con Shopify mediante Amazon AppIntegrations. Primero debe configurar la conexión en Amazon Connect y Shopify; a continuación, verificar la integración de Shopify.
## Configuración de la conexión en Amazon Connect y Shopify
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen**, seleccione **Shopify**. Revise los requisitos de solicitud que aparecen en la página **Seleccionar aplicación**.
![\[La página de selección de origen.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Usa la conexión existente**: esto te permite reutilizar EventBridge los recursos de Amazon existentes que hayas creado en tu Cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nombre de la conexión**: proporcione un nombre para la conexión. Las integraciones que utilizan esta conexión hacen referencia al nombre de la conexión.
+ **URL de conexión**: introduzca la URL de conexión de la aplicación. Esta URL se utiliza para establecer enlaces profundos a los objetos creados en la aplicación externa. La URL de conexión es la URL de la aplicación de Shopify Partner disponible en el sitio web de la aplicación.
Para encontrar la URL de su aplicación de Shopify Partner:
+ Inicie sesión en su cuenta de partners.shopify.com.
+ Vaya a la aplicación.
+ Copie la URL del navegador.
+ **ID de cliente**: introduzca el ID de cliente de la aplicación. Es una cadena que distingue de forma única al cliente en la aplicación externa. Este ID de cliente es el nombre de origen disponible en el sitio web de la aplicación. Utilizará el ID que especifique aquí para identificar al cliente del que desea que Perfiles de clientes ingiera sus objetos. Su ID de cliente puede estar disponible después de seguir los pasos de configuración de origen.
Para encontrar su nombre de origen:
+ Inicie sesión en su cuenta de partners.shopify.com.
+ Vaya a la aplicación.
+ Copia el nombre de la fuente de tus EventBridge eventos de Amazon.
1. En la página de **configuración de la fuente**, copia tu Cuenta de AWS ID en el portapapeles y, a continuación, selecciona **Iniciar sesión en Shopify**.
1. Utilice las siguientes instrucciones para configurar Shopify:
1. Inicie sesión en partners.shopify.com.
1. En Amazon EventBridge, selecciona **Crear fuente**.
1. Pega tu Cuenta de AWS ID y selecciona tu AWS región.
1. Tras configurar el destino de origen de evento, vuelva a Perfiles de clientes. Verá una alerta que indica que Amazon Connect se ha conectado correctamente con Shopify.
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puedes usar las asignaciones de objetos que has creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[La página de opciones de integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de agregar la integración.
**nota**
Si necesita registros históricos, puede [utilizar Amazon S3 como origen de integración para importarlos](customer-profiles-object-type-mappings.md).
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Agregar integración**.
**nota**
Tras agregar esta integración, deberá [configurar suscripciones a webhooks](#shopify-webhook-subscriptions) para permitir que los eventos empiecen a fluir hacia esta integración.
![\[Página Revisar e integrar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Una vez configurada la integración, de vuelta en la página **Configuración de perfiles de clientes**, la sección **Integraciones** muestra las integraciones que están actualmente configuradas. La **Última ejecución** y el **Estado de integración** no están disponibles actualmente para este tipo de integración.
![\[La sección Integraciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver qué datos se están enviando, elija la integración y, a continuación, seleccione **Ver objetos**.
1. Vaya al siguiente paso para utilizar la API y configurar las **suscripciones a webhooks** para que los eventos puedan empezar a fluir hacia esta integración.
## Configuración de suscripciones de webhook
1. Utilice la siguiente URL para asegurarse de que su aplicación dispone de los permisos necesarios:
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Donde:
+ `shop` es el nombre de su tienda de Shopify.
+ `api_key` es la clave de API de su aplicación de Shopify. Puede encontrarla en la página de detalles **Aplicación** de Shopify.
+ `scopes` debe tener el valor `read_customers,read_orders,read_draft_orders`.
+ `redirect_uri` es el URI de redireccionamiento que especificó para su aplicación cuando la creó. Para nuestros fines, puede ser cualquier URL válida.
+ `nonce` puede ser cualquier valor único para identificar una solicitud de autorización determinada de otras personas. Recomendamos utilizar una marca temporal.
Después de crear la URL, péguela en el navegador. Aparece una installation/authorization página similar a la siguiente imagen, en la que se pide al propietario de la tienda que otorgue permisos para el ámbito definido.
![\[Un ejemplo de una página de Shopify para instalar y autorizar la aplicación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Elija **Instalar aplicación no incluida en la lista** para instalar y autorizar la aplicación en nombre de su tienda.
Accederá al URI de redirección que introdujo con un código de autorización añadido al URI de redirección como parámetro de consulta. Por ejemplo:
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. Copie el `authorization_code` de este URI. Lo utilizará para obtener un token de acceso permanente en los próximos pasos.
1. Vaya a la herramienta que utilice para realizar llamadas a la API. Por ejemplo, [CURL](https://curl.se/) o [POSTMAN](https://www.postman.com/).
1. Para obtener un token de acceso permanente, haga una solicitud POST a la API `Admin` de Shopify a este punto de conexión:
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
con el siguiente cuerpo de solicitud:
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Esta solicitud devolverá la siguiente respuesta:
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Anote el `access_token`. Se trata de un token permanente que tiene el ámbito proporcionado en un paso anterior. Ahora ya puede crear suscripciones de webhook.
1. Para las siguientes llamadas a la API, asegúrese de establecer la clave del encabezado HTTP `X-Shopify-Access-Token` al `access_token` que recibió de la respuesta de la llamada anterior.
1. Para configurar las suscripciones de webhook, realice la siguiente solicitud POST para cada uno de los valores de `topic` enumerados en el siguiente paso:
Punto de conexión: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Cuerpo de la solicitud:
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. Para cada suscripción, sustituya el valor de `topic` por los siguientes valores:
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
Ahora ya puede recibir eventos de su tienda de Shopify. A continuación, verifique su integración con Shopify.
## Verificación de su integración de Shopify
1. Inicie sesión como administrador en su tienda de Shopify.
1. En el menú de navegación izquierdo, elija **Usuarios**.
1. Seleccione **Agregar cliente**.
1. Introduzca sus datos de cliente. Asegúrese de introducir un número de teléfono y un correo electrónico. No es necesario que pertenezcan a un cliente real. Eliminará esta entrada de cliente tras verificar la integración.
1. Guarde el objeto de cliente.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y cree un perfil de cliente.
1. Abra la experiencia de agente de Amazon Connect y busque al usuario por el correo electrónico o el número de teléfono que introdujo en la tienda de Shopify. Debería poder ver el perfil de cliente con el mismo correo electrónico o número de teléfono.
1. Si no ve el perfil del cliente, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.
# Configura la integración para aplicaciones externas mediante Amazon AppFlow
Estas integraciones utilizan Amazon AppFlow para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect. Los siguientes pasos proporcionan orientación sobre cómo configurar el conector que elijas con Amazon AppFlow, configurar las asignaciones de datos y configurar las integraciones para ingerir los datos de tus clientes.
Para obtener más información sobre los AppFlow precios de Amazon, consulta los AppFlow [precios de](https://aws.amazon.com/appflow/pricing/) Amazon.
Para obtener más información sobre los conectores AppFlow compatibles con Amazon, consulta [Aplicaciones de origen y destino compatibles](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
## Antes de empezar
Al activar Perfiles de clientes de Amazon Connect, se crea un dominio de Perfiles de clientes, que es un contenedor para todos los datos, como los perfiles de clientes, los tipos de objetos, las claves de perfil y las claves de cifrado. A continuación, se indican las directrices para crear dominios de Perfiles de clientes:
+ Cada instancia de Amazon Connect solo puede asociarse a un dominio.
+ Puede crear varios dominios, pero no comparten integraciones de aplicaciones externas ni datos de clientes entre sí.
+ Todas las integraciones de aplicaciones externas que se crean son a nivel de dominio. Todas las instancias de Amazon Connect asociadas a un dominio heredan las integraciones del dominio.
**Requisito previo: habilitar Perfiles de clientes en su instancia de Amazon Connect**
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
1. En el panel de navegación, elija **Perfiles de clientes**.
1. Elija Activar perfiles de clientes.
En el formulario, deberá rellenar todos los campos obligatorios para crear un dominio de Perfiles de clientes mediante los pasos que se indican a continuación:
1. **Configuración del dominio**. Puede crear un nuevo dominio y proporcionar un nombre.
1. **Cifrado**. En Especificar clave de KMS, puede habilitar el cifrado mediante la selección de una clave de AWS KMS existente y la creación de una nueva clave de AWS KMS o puede elegir **Seleccionar dominio existente**.
1. **Informe de errores**. Puede proporcionar una cola de mensajes fallidos, que es una cola de SQS para gestionar los errores de perfil de cliente.
1. Seleccione **Enviar** y se crearán los perfiles de clientes con la información del historial de contactos de su instancia.
### Configurar una aplicación externa con Amazon AppFlow
Puede añadir una integración de aplicación externa a un dominio de perfiles de clientes de Amazon Connect AppFlow mediante Amazon siguiendo los pasos que se indican a continuación. Debe crear un flujo para su fuente de datos en la AppFlow consola de Amazon y configurar Amazon Connect Customer Profiles como destino antes de continuar en la consola Customer Profiles. Si creó un flujo hace más de 14 días, ha caducado y deberá crear un nuevo flujo para su integración.
Si lo desea, puede realizar transformaciones de datos como `Arithmetic``Filter`,`Map`,`Map_all`,`Mask`, `Merge``Truncate`, y `Validate` cuando utilice el CloudFormation `AWS::AppFlow::Flow Task` recurso antes de la ingestión.
1. Inicie sesión en AWS la consola de administración, seleccione Amazon AppFlow y elija **Create flow**.
![\[La AppFlow página de Amazon.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. Introduzca el nombre y una descripción opcional.
![\[La página Detalles del flujo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. Puede dejar la sección de **cifrado de datos** como está, ya que su dominio de perfiles de clientes de Amazon Connect ya tiene una AWS KMS clave existente que se utilizará para este flujo. Si lo desea, puede crear etiquetas y, a continuación, elegir **Siguiente**.
![\[La sección de cifrado de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. Seleccione una aplicación externa de su elección en el menú desplegable **Nombre de origen** y, a continuación, seleccione el siguiente campo pertinente. Por ejemplo, si desea configurar Slack, seleccione Slack en el menú desplegable **Nombre de origen**. Después, puede seleccionar un flujo de Slack existente o crear una conexión nueva.
![\[La página de configuración del flujo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. Si ha elegido crear una nueva conexión, podrá introducir los datos de la aplicación externa, como el nombre de usuario, la contraseña y el subdominio. También puede seleccionar la AWS KMS clave para el cifrado de datos e introducir el nombre de la conexión para identificarla.
![\[La página de conexión a Slack.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. Si decide usar una conexión existente, puede seleccionar el objeto específico de la aplicación externa en el menú desplegable. Por ejemplo, si elige una conexión de Slack existente, puede elegir **Conversaciones** como objeto y, a continuación, elegir el canal de Slack específico que se utilizará.
![\[La página de detalles del origen.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. En la sección **Detalles del destino**, seleccione Amazon Connect como nombre del destino en el menú desplegable y seleccione el dominio del perfil de cliente creado en el anterior paso de requisito previo.
![\[La sección Detalles del destino.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. Elija un desencadenador de flujo; para ello, elija **Ejecutar bajo demanda** o **Ejecutar flujo según la programación**. Elija **Siguiente**.
+ La opción **Ejecutar bajo demanda** ejecuta el flujo solo cuando usted lo activa.
+ **Ejecutar flujo según la programación**: ejecuta el flujo a una hora específica mediante una programación. La frecuencia de programación está limitada a 5 minutos, 15 minutos o 1 hora.
![\[La sección de desencadenador de flujo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. Seleccione **Asignar campos manualmente** en **Método de asignación**. Elija los campos de origen de la aplicación externa y, a continuación, elija **Asignar campos directamente**.
![\[La sección de métodos de asignación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. Revise y elija **Crear flujo**.
Para obtener más información sobre la creación de flujos en la AppFlow consola de Amazon, consulte [Creación de flujos en Amazon AppFlow](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html).
Para obtener más información sobre la configuración de aplicaciones externas y muchas otras aplicaciones compatibles en Amazon AppFlow, consulta [Aplicaciones de AppFlow origen y destino compatibles con Amazon](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html).
### Configuración de asignaciones de datos para definir cómo se asignan los datos de aplicaciones externas a un perfil de cliente
Una vez configurada AppFlow la integración con Amazon, debe configurar las asignaciones de datos en los perfiles de los clientes para definir cómo se asignarán los datos de la aplicación externa al perfil del cliente. Esto le permitirá personalizar los datos que desea utilizar para crear su perfil de cliente unificado. Elija su asignación con cuidado, ya que no podrá elegir una asignación diferente después de crear la integración.
Para obtener más información sobre las asignaciones de datos, consulte [Asignación de tipos de objetos](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html).
1. Inicie sesión en la consola AWS de administración, seleccione **Amazon Connect** y elija Customer Profiles con el alias de su instancia de conexión.
![\[La página Perfiles de clientes de Amazon Connect.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. Elija **Asignaciones de datos** y, a continuación, elija **Crear asignación de datos**. Proporcione un nombre y una descripción a la asignación de datos.
![\[La pestaña de asignación de datos, el botón de crear asignación de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[La página de establecimiento de asignación de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. En **Opciones de asignación**, puede elegir su **Origen de datos** como la aplicación externa, el **Nombre de flujo** que creó en la sección anterior y el **Método de definición de datos** como *Destino de asignación*. En **Destino de asignación** puede elegir los tipos de datos de clientes que desea definir para sus perfiles de clientes unificados. Elija **Siguiente**.
![\[La sección de opciones de asignación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. Agregue atributos de cliente, producto, caso y orden con origen, destino y tipo de contenido y, a continuación, elija **Siguiente**.
![\[La página de asignación de atributos de orden.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. En **Especificar identificadores**, puede seleccionar varios atributos de su objeto de origen de datos que lo ayuden a distinguir sus datos de otros objetos de origen de datos. Puede seleccionar atributos entre identificadores únicos de cliente, producto, caso y orden. Para obtener más información sobre los identificadores, consulte [Identificadores estándar para establecer los atributos de la clave en Perfiles de clientes](standard-identifiers.md).
![\[La página Identificadores estándar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. Revise y elija **Crear asignación de datos**. El estado de asignación de datos se mostrará como *Activo*.
![\[Los identificadores en la página Paso 6: especificar identificadores.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### Configuración de integraciones para la ingesta de los datos de sus clientes desde una aplicación externa
Una vez configurada la asignación de datos para una aplicación externa, configurará la integración del origen de datos para la ingesta de los datos de clientes.
1. Inicie sesión en la consola de administración de AWS, seleccione **Amazon Connect** y elija Perfiles de clientes con el alias de su instancia de conexión.
1. En la sección **Integraciones de orígenes de datos**, seleccione **Agregar integración de origen de datos**.
![\[Pestaña Integraciones de orígenes de datos, botón Agregar integración de origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. En el menú desplegable **Origen de datos**, seleccione la aplicación externa y elija **Siguiente**. También tienes la opción de elegir **Crear nuevo flujo**, que abrirá la AppFlow consola de Amazon en una pestaña nueva.
![\[Sección de origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. En el menú desplegable **Nombre del flujo**, elija el flujo que desee utilizar de su origen de datos y elija **Siguiente**.
![\[Seleccione un nombre de flujo para establecer una conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. En el menú desplegable **Asignación de datos**, seleccione la asignación de datos de aplicación externa correspondiente al objeto para definir cómo se asigna el origen de datos a los perfiles. Elija **Siguiente**.
![\[Seleccione la página de asignación de datos, en el cuadro desplegable de asignaciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. Revise y elija **Agregar integración de origen de datos**. La integración del origen de datos de la aplicación externa se mostrará inicialmente como pendiente antes de pasar a un estado activo.
![\[Página Revisar e integrar, botón Agregar integración de origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### Visualización del perfil de cliente unificado en el CCP de agente de Perfiles de clientes de Amazon Connect
Sus agentes podrán ver ahora los datos de los clientes que se hayan importado desde una aplicación externa si inician sesión en el CCP de agente de Amazon Connect. Para obtener más información sobre la conexión al CCP de agente de Amazon Connect, consulte [Aplicación de agente: todo en un solo lugar](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application).
Su agente deberá tener los permisos de perfil de seguridad adecuados para poder ver Perfiles de clientes y podrá realizar búsquedas mediante un nombre de clave y un valor en la barra de búsqueda de perfiles.
Para obtener más información sobre los permisos de los perfiles de seguridad, consulte [Perfiles de seguridad](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html).
Los usuarios avanzados que deseen crear su propia aplicación de agente personalizada e insertar perfiles de clientes pueden utilizar [StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles), que proporciona una mayor personalización sobre la aplicación del agente.
# Eliminación de Perfiles de clientes o detención de las integraciones
**nota**
Al eliminar asignaciones, solo se eliminarán los objetos y datos asociados a esa asignación específica. Si hay varios objetos asociados a un perfil, es posible que al eliminar una asignación concreta no se borren los datos de perfil. Si deseara eliminar datos específicos, eliminaría la asignación, pero sus perfiles pueden seguir existiendo si contienen datos de otras asignaciones. Esto podría dar lugar a cargos adicionales para los perfiles existentes. Puedes eliminar un dominio y todos los datos de los perfiles de los clientes, incluidos todos los perfiles, mediante la [Amazon Connect consola](delete-customer-profiles-domain.md) o la [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html)API.
**Método de consola**
+ Si en algún momento desea detener la ingestión de los datos del perfil de los clientes, elija integration/mapping y, a continuación, elija **Eliminar**.
+ Para eliminar las integraciones, los perfiles de los clientes y todos los datos de los perfiles de los clientes, puedes eliminar el dominio de tus perfiles de clientes en la Amazon Connect consola. Para obtener más información, consulte [Eliminación de un dominio de Perfiles de clientes de Amazon Connect](delete-customer-profiles-domain.md).
**Método de API**
+ Para eliminar los datos de los perfiles de clientes de una integración concreta, utilice la API `DeleteProfileObjectType`.
+ Para eliminar las integraciones, los perfiles de clientes y todos los datos de los perfiles de clientes, utilice la API `DeleteDomain`.
Para volver a habilitar la ingesta de datos de perfiles de clientes, realice de nuevo los pasos de configuración.
# Asignación de tipos de objetos de perfiles de clientes de Amazon Connect
La asignación de tipos de objetos indica a los perfiles de cliente cómo realizar la incorporación de un tipo específico de datos. Proporciona a Perfiles de clientes información esencial, como:
+ Cómo deben rellenarse los datos procedentes del objeto e incorporarse al objeto de perfil estándar.
+ Qué campos deben indexarse en el objeto y cómo deben utilizarse esos campos para asignar objetos de este tipo a un perfil específico.
Los temas de esta sección proporcionan información y pasos que lo ayudarán a configurar la asignación de tipos de objetos, incluida la forma de crear la asignación de tipos de objetos; los detalles de la definición de la asignación, y los conceptos y terminología clave.
**Topics**
+ [
# Conceptos y terminología de las asignaciones de tipos de objetos de cliente
](customer-profiles-terminology.md)
+ [Creación de una asignación de tipo de objeto](create-object-type-mapping.md)
+ [
# Detalles de la definición de asignación de tipos de objetos en Perfiles de clientes de Amazon Connect
](object-type-mapping-definition-details.md)
+ [
# Propiedades adicionales de los tipos de objeto en Perfiles de clientes
](additional-properties-object-types.md)
+ [
# Perfiles inferidos
](inferred-profiles.md)
+ [Plantillas de registro de contacto](ctr-contact-record-template.md)
+ [
# Asociación del registro de contacto con un perfil encontrado mediante la clave \$1phone en Perfiles de clientes
](auto-associate-profile-using-phone-profile-key.md)
+ [
# Ejemplos de asignaciones de tipos de objetos en Perfiles de clientes de Amazon Connect
](examples-object-type-mappings.md)
+ [
# Tipos de objeto de perfil implícito en Perfiles de clientes de Amazon Connect
](implicit-profile-object-types.md)
+ [Asignación de datos impulsada por la IA generativa](genai-powered-data-mapping.md)
+ [Límites de datos de Perfiles de clientes](customer-profiles-data-limits.md)
# Conceptos y terminología de las asignaciones de tipos de objetos de cliente
Los siguientes términos y conceptos son fundamentales para entender las asignaciones de tipo de objeto.
**Objeto de perfil estándar**
Un *objeto de perfil estándar* es un objeto predefinido que contienen todos los perfiles.
Un objeto de perfil estándar contiene campos estándar, como números de teléfono, direcciones de correo electrónico, nombres y otros datos estándar. Estos datos se pueden recuperar en un formato estándar independientemente de la fuente (por ejemplo, Salesforce o Marketo). ServiceNow
**Objeto de perfil**
Un *objeto de perfil* es una unidad única de información conocida sobre un perfil. Por ejemplo, la información sobre una llamada telefónica, un vale, un caso o incluso un registro de clics de un sitio web.
Un único objeto de perfil puede ocupar hasta 250 KB y puede ser cualquier documento JSON estructurado.
+ Cada objeto de perfil tiene un tipo. Por ejemplo, el objeto de perfil puede ser un registro de contacto de Amazon Connect, ServiceNow Users o Marketo Leads.
+ El tipo se refiere a la asignación de tipo de objeto.
+ La asignación de tipo de objeto define cómo se debe realizar la ingesta de ese objeto específico en Perfiles de clientes.
**Perfil**
Un *perfil* contiene toda la información conocida sobre un cliente o contacto específico. Incluye un único objeto de perfil estándar y cualquier número de objetos de perfil adicionales.
**Asignación de tipo de objeto**
La *asignación de tipo de objeto* indica a los perfiles de cliente cómo realizar la ingesta de un tipo específico de datos. Proporciona a Perfiles de clientes la siguiente información:
+ Cómo deben rellenarse los datos procedentes del objeto e incorporarse al objeto de perfil estándar.
+ Qué campos deben indexarse en el objeto y cómo deben utilizarse esos campos para asignar objetos de este tipo a un perfil específico.
**Plantilla de mapeo**
Una *plantilla de asignación* es una asignación de tipo de objeto predefinido que se incluye en el servicio de Perfiles de clientes.
Los perfiles de clientes incluyen plantillas de mapeo para los registros de contactos de Amazon Connect, las cuentas de Salesforce, ServiceNow los usuarios y los clientes potenciales de Marketo. Para obtener una lista completa de las plantillas de mapeo disponibles, utilice la [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API.
Con las plantillas de asignación puede realizar una rápida ingesta de datos de orígenes bien conocidos sin tener que especificar ninguna información adicional.
# Creación de una asignación de tipos de objetos en Perfiles de clientes de Amazon Connect
Una asignación de tipo de objeto indica a Perfiles de clientes cómo realizar la ingesta de un tipo específico de datos de una aplicación de origen (como Salesforce, Zendesk o S3) en un objeto de perfil estándar unificado. A continuación, puede mostrar los datos de ese objeto (por ejemplo, la dirección y el correo electrónico del cliente) a sus agentes mediante la [aplicación para agentes de Amazon Connect](customer-profile-access.md).
La asignación de tipo de objeto proporciona a Perfiles de clientes la siguiente información:
+ Cómo deben rellenarse los datos procedentes del objeto e incorporarse al objeto de perfil estándar.
+ Qué campos deben indexarse en el objeto y cómo deben utilizarse esos campos para asignar objetos de este tipo a un perfil específico.
Existen dos formas de crear una asignación de tipo de objeto:
+ Utilizar la consola de Amazon Connect. La interfaz de usuario facilita el acceso a las características de asignación de datos. Por ejemplo, puede agregar atributos personalizados y definir identificadores de búsqueda y únicos para los modelos de contacto. No se necesita codificación.
+ Utilizar la API de Perfiles de clientes. Para obtener más información, consulte la [Referencia de la API de Perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
En este tema se explica cómo crear una asignación mediante la consola de Amazon Connect.
## Creación de una asignación de datos mediante la consola de Amazon Connect
Amazon Connect ofrece una experiencia sin código para mapear datos de clientes desde aplicaciones propias y de terceros con Amazon S3, Salesforce ServiceNow, Zendesk y Marketo.
Para crear una asignación de datos, defina una asignación de tipo de objeto que describa el aspecto del objeto de perfil personalizado. Esta asignación define cómo pueden utilizarse los campos de sus datos para rellenar los campos del perfil estándar o cómo pueden utilizarse para asignar los datos a un perfil específico.
### Paso 1: configurar la asignación de datos
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes** y **Asignaciones de datos**.
1. Seleccione **Crear asignación de datos** para empezar.
1. En la página **Configurar asignación de datos**, en la sección **Descripción**, agregue un nombre que lo ayude a identificar el origen o el propósito de esta asignación. Estos son los metadatos del tipo de objeto.
1. En la sección **Origen de datos**:
1. Elija de dónde provienen los datos, por ejemplo, Salesforce o Zendesk. En función de su selección, Amazon Connect selecciona automáticamente los destinos disponibles según la plantilla predefinida.
1. Elija el objeto de origen. Se utiliza para crear su perfil unificado.
1. En la sección **Destino de asignación**, elija los datos que desea utilizar para crear su perfil de cliente unificado. Esta información puede mostrarse a sus flujos y agentes para personalizar las interacciones con los contactos.
Para obtener más información sobre los destinos de asignación admitidos, consulte [Acerca de los destinos de las asignaciones en Amazon Connect](about-mapping-destinations.md).
1. En la sección **Opciones adicionales**, puede elegir cuándo dejar de crear nuevos perfiles y durante cuánto tiempo retenerlos. Estas opciones lo ayudan a administrar los costos.
**nota**
De forma predeterminada, el periodo de retención del dominio es de 366 días. Para cambiar el período de retención establecido en su dominio, utilice la [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API.
1. Si eligió una fuente distinta de S3, en la *application* sección **Establecer una conexión con**, elija una EventBridge conexión de Amazon AppFlow o Amazon existente para conectar sus datos o cree una nueva conexión. Puede crear una nueva conexión si introduce detalles sobre su cuenta para este origen de datos.
Una vez establecida la conexión, elegirá los objetos de los que desea realizar la ingesta desde su origen de datos.
1. Elija **Siguiente**.
### Paso 2: asignar los atributos
En la página **Asignar atributos de *tipo***, verá la tabla de asignaciones de campos rellenada con la plantilla predefinida, según el destino de asignación. Por ejemplo, se rellena con atributos de cliente, producto, caso o pedido. Puede cambiar la plantilla predefinida eligiendo un atributo (por ejemplo AccountNumber) y, a continuación, seleccionando un destino diferente, o bien introduciendo uno de sus propios atributos personalizados.
En la imagen siguiente se muestra un ejemplo de la página rellenada con atributos de cliente procedentes de la plantilla.
![\[El menú de navegación de Amazon Connect y la página Asignar atributos del cliente\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
Puede eliminar lo que no desee que aparezca en el perfil de cliente, cambiar el origen y agregar atributos personalizados.
Esta asignación utiliza su origen de datos para rellenar la información de contacto del cliente, como un número de teléfono, en el perfil del cliente. Utiliza atributos de la plantilla de perfil estándar.
**sugerencia**
Si decide agregar atributos personalizados, al destino siempre se le agregará el prefijo `Attributes.`. Esto permite a Amazon Connect reconocer que se trata de un atributo personalizado.
![\[La interfaz de Asignación de atributos de clientes muestra los campos de origen asignados a los campos de destino.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/custom-attribute-cp.png)
Ahora los agentes pueden ver los atributos personalizados en la aplicación de agente de Connect, en la pestaña **Información adicional**, ordenados alfabéticamente. Puede crear el nombre que desee para cada atributo que se mostrará a los agentes con el siguiente formato: `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
Todos los atributos personalizados ingeridos se mostrarán en la aplicación de agente de Connect. Si no desea mostrar cierta información a sus agentes, no realice la ingesta de atributos personalizados en este momento.
### Paso 3: especificar los identificadores
En la página **Especificar identificadores**, complete las siguientes secciones. En función de los datos que vaya a asignar, es posible que no todos aparezcan en su página.
**nota**
Los nombres `_profileId`, `_orderId`, `_caseId` y `_assetId` están reservados para uso interno. Si decide utilizar estos nombres como uno de sus identificadores, deberá declararlos como `LOOKUP_ONLY`, lo que significa que nuestro sistema no los guardará para hacerlos coincidir con perfiles, activos estándar, pedidos estándar o casos estándar, ni los guardará para buscar en su perfil, activo, caso o pedido. Si desea que estas claves se puedan utilizar para realizar búsquedas y coincidencias, debe cambiar el nombre a la clave. Para obtener más información sobre el identificador estándar `LOOKUP_ONLY`, consulte [Identificadores estándar para establecer los atributos de la clave en Perfiles de clientes](standard-identifiers.md).
+ **Identificador único**: debe tener un identificador único para sus datos a fin de evitar errores en la ingesta. Este identificador también se conoce como clave única. Perfiles de clientes lo utiliza para distinguir estos datos de otros objetos de origen de datos y en la indexación para buscar y actualizar datos.
Solo puede haber un identificador único.
+ **Identificador de cliente**: debe tener al menos un identificador de cliente para sus datos a fin de evitar errores en la ingesta. El identificador también se conoce como clave de perfil.
Perfiles de clientes lo utiliza para determinar si el caso de datos se asocia a un perfil existente o se utiliza para crear un nuevo perfil mediante la búsqueda de este identificador en otros perfiles.
Puede tener varios identificadores de cliente.
**sugerencia**
Los agentes pueden utilizar cualquiera de estos identificadores de cliente en el espacio de trabajo del agente para encontrar el perfil que pertenece al cliente en la interacción.
+ **Identificador de producto**: debe tener al menos un identificador de producto para sus datos a fin de evitar errores en la ingesta. El identificador también se conoce como clave de activo.
Perfiles de clientes lo utiliza para distinguir estos datos de otros datos de compra de productos de clientes. También se utiliza para determinar si los datos se pueden asociar a un perfil existente o se utiliza para crear un nuevo perfil mediante la búsqueda de este identificador en otros perfiles.
Puede tener varios identificadores de producto.
+ **Identificador de caso**: debe tener al menos un identificador de caso para sus datos a fin de evitar errores en la ingesta. El identificador también se conoce como clave de caso.
Perfiles de clientes lo utiliza para distinguir estos datos de otros datos de caso de clientes. También se utiliza para determinar si los datos se pueden asociar a un perfil existente o se utiliza para crear un nuevo perfil mediante la búsqueda de este identificador en otros perfiles.
Puede tener varios identificadores de caso.
+ **Identificador de pedido**: debe tener al menos un identificador de pedido para sus datos a fin de evitar errores en la ingesta. El identificador también se conoce como clave de pedido.
Perfiles de clientes lo utiliza para distinguir estos datos de otros datos de pedido de clientes. También se utiliza para determinar si los datos se pueden asociar a un perfil existente o se utiliza para crear un nuevo perfil mediante la búsqueda de este identificador en otros perfiles.
Puede tener varios identificadores de pedido.
+ **Atributos de búsqueda adicionales (opcional)**: puede elegir los atributos de su objeto de origen de datos que desee indexar para que se puedan realizar búsquedas. De forma predeterminada, todos los identificadores están indexados.
**sugerencia**
Si los atributos de búsqueda de los objetos del origen de datos contienen prácticamente el mismo valor, es posible que la ingesta de datos sea más lenta. Se recomienda crear atributos de búsqueda que sean únicos en los objetos del origen de datos.
+ **Marca temporal del objeto de datos**: la marca temporal del objeto de datos se utiliza para resolver conflictos de perfiles cuando está activada la resolución de identidades para consolidar perfiles similares. Cuando dos o más perfiles similares tengan registros en conflicto, se utilizarán los registros del perfil con la marca temporal actualizada más recientemente.
Puede elegir un atributo de su objeto como referencia para saber cuándo se actualizó por última vez.
### Paso 4: Revisar y crear
Una vez creada la asignación de datos, puede elegir **Agregar integración de origen de datos** para utilizar este tipo de objeto.
![\[Interfaz de Perfiles de clientes de Amazon Connect que muestra ejemplos de los detalles de asignación de datos y el estado de integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# Acerca de los destinos de las asignaciones en Amazon Connect
Un destino de asignación es su asignación desde un origen a una definición estándar ya definida en Amazon Connect.
En la tabla siguiente se enumeran los destinos de asignación admitidos.
| Objeto de origen | Destino: cliente, producto, pedido, caso |
| --- | --- |
| S3 | Cualquiera |
| Salesforce-Account | Cliente |
| Salesforce-Contact | Cliente |
| Salesforce-Asset | Producto |
| Zendesk-users | Cliente |
| Marketo-leads | Cliente |
| Servicenow-sys\$1user | Cliente |
| Segment-Identify | Cliente |
| Segment-Customer | Cliente |
| Shopify-Customer | Cliente |
| Shopify- DraftOrder | Order |
| Zendesk-tickets | Caso |
| Servicenow-task | Caso |
| Servicenow-incident | Caso |
# Asignación de tipo de objeto para Perfiles de clientes
La siguiente información debe figurar en su asignación de tipo de objeto para que Perfiles de clientes pueda procesar los datos entrantes:
+ Una definición de todos los campos del objeto de ingesta que deben asignarse al perfil estándar o utilizarse para asignar los datos a un perfil. Indica a Perfiles de clientes qué campos del objeto de **origen** de ingesta deben asignarse a determinados campos del objeto de perfil estándar.
+ Qué campos del objeto de origen de sus datos personalizados deben indexarse y cómo.
Cuando Perfiles de clientes realiza la ingesta de los datos de origen, los campos indexados determinan:
+ A qué perfil pertenece un objeto concreto.
+ Qué objetos están relacionados entre sí y deben colocarse en el mismo perfil. Por ejemplo, un número de cuenta o un identificador de contacto en un registro de contacto.
+ Qué valores se pueden usar para buscar un perfil. Por ejemplo, se puede indexar el nombre del contacto. Esto permitiría a los agentes encontrar todos los perfiles que pertenecen a los clientes con un nombre específico.
## Requisitos de la clave
Debe definir al menos una clave. Perfiles de clientes utiliza esta clave para asignar su objeto de perfil personalizado a un perfil.
La asignación de objetos de perfil personalizado también necesita al menos una clave que identifique de forma exclusiva el objeto para que pueda actualizarse mediante la especificación del mismo valor de este campo (estos requisitos pueden satisfacerse con una sola clave).
Cada clave puede estar formada por uno o varios campos.
## Requisitos de campo
Una definición de campo especifica cómo leer un valor para ese nombre de campo desde un objeto de origen. La definición del campo también especifica el tipo de los datos que se almacenan en el campo.
Los nombres de tipo de objeto pueden ser cualquier cadena alfanumérica o los caracteres “-” y “\$1”. Tampoco pueden empezar por un carácter “\$1”, que se utiliza para los tipos de objeto estándar reservados.
# Detalles de la definición de asignación de tipos de objetos en Perfiles de clientes de Amazon Connect
La definición de asignación de tipo de objeto consta de dos partes: la definición de campo y la definición de clave.
**sugerencia**
Para obtener información sobre cómo crear un asignador de tipo de objeto, consulte esta entrada de blog: [Unificar y organizar la información de los clientes con Perfiles de clientes de Amazon Connect con el conector de Amazon S3 prediseñado](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/). O bien, echa un vistazo a este vídeo sobre YouTube: [Cómo integrar los datos del perfil de los clientes en las experiencias de tu centro de contacto](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s).
## Detalles de la definición de campo
La definición de campo define el origen, el destino y el tipo de campo. Por ejemplo:
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source`: puede ser un descriptor de acceso JSON para el campo o una macro Handlebar para generar el valor del campo.
El objeto de origen que se está analizando se denomina ` _source`, por lo que todos los campos de origen deben ir precedidos de esta cadena. Solo se admite el objeto `_source`.
Utilice la solución de macros Handlebar para generar constantes y combinar varios campos de objetos de origen en un solo campo. Esto resulta útil para la indexación.
+ `Target`: especifica en qué parte de un tipo de objeto estándar deben asignarse los datos de este campo.
Rellenar el perfil estándar le permite utilizar datos de ingesta de cualquier origen de datos con aplicaciones creadas a partir de Perfiles de clientes sin ningún conocimiento específico del formato de los datos de ingesta.
Este campo es opcional. Puede que desee definir campos con el único propósito de incluirlos en una clave.
El formato de este campo es siempre un descriptor de acceso JSON. El único objeto de destino admitido es `_profile`.
+ `ContentType`: se admiten los valores STRING, NUMBER, PHONE\$1NUMBER, EMAIL\$1ADDRESS y NAME. Si no se especifica `ContentType` se asume STRING.
`ContentType` se utiliza para determinar cómo indexar el valor para que los agentes puedan buscarlo. Por ejemplo, si `ContentType` se establece a PHONE\$1NUMBER, se procesa un número de teléfono para que los agentes puedan buscarlo en cualquier formato: la cadena “\$115551234567” coincide con “(555)-123-4567”.
## Detalles de la definición de clave
Una clave contiene uno o más campos que, en conjunto, definen una clave que se puede usar para buscar objetos (o los perfiles a los que pertenecen) mediante la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API. La clave también se puede definir para identificar de forma exclusiva un perfil o identificar de forma exclusiva el objeto en sí.
```
"Keys": {
"{keyName}": [{
"StandardIdentifiers": [...],
"FieldNames": [ "{fieldname}", ...]
}], ...
}, ...
```
Los nombres de clave son globales para un dominio. Si tiene dos claves con el mismo nombre en dos asignaciones de tipo de objeto diferentes:
+ Esas claves deben ocupar el mismo espacio de nombres.
+ Se pueden utilizar para enlazar potencialmente perfiles entre diferentes objetos. Si coinciden entre los objetos, Perfiles de clientes coloca los dos objetos en el mismo perfil.
Para expresarlo de otra manera: las claves deben tener el mismo nombre de clave en un dominio si, y solo si, el mismo valor significa que están relacionadas. Por ejemplo, un número de teléfono especificado en un tipo de objeto estaría relacionado con el mismo número de teléfono especificado en otro tipo de objeto. Un identificador interno especificado para un objeto importado de Salesforce podría no estar relacionado con otro objeto importado de Marketo, aunque tengan exactamente el mismo valor.
Las definiciones de clave se utilizan de dos formas:
+ En Perfiles de clientes durante la ingesta, se utilizan para averiguar a qué perfil debe asignarse el objeto.
+ Permiten utilizar la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar el valor de la clave y encontrar el perfil.
## Teclas de búsqueda predeterminadas
Las teclas de búsqueda predeterminadas, como `_phone` y `_email`, están predefinidas en las plantillas de objetos de [perfil estándar](standard-profile-definition.md), [activo estándar](standard-asset-definition.md), [pedido estándar](standard-order-definition.md) y [caso estándar](standard-case-definition.md). Puedes usar las claves de búsqueda predeterminadas como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil.
# Identificadores estándar para establecer los atributos de la clave en Perfiles de clientes
Los identificadores estándar le permiten establecer atributos en la clave. Decida qué identificadores utilizar en función de cómo desee que se realice la ingesta de los datos en los perfiles. Por ejemplo, marca el número de teléfono con el identificador PROFILE. Esto significa que el número de teléfono debe tratarse como un identificador único. Si Perfiles de clientes obtiene dos contactos con el mismo número de teléfono, los contactos se van a combinar en un único perfil.
| Nombre del identificador | Description (Descripción) |
| --- | --- |
| AIR\$1PREFERENCE | Este identificador inicia que esta clave identifica de forma exclusiva una preferencia de vuelo. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier preferencia de vuelo que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | Este identificador indica que esta clave identifica de forma exclusiva una reserva aérea. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier reserva aérea que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | Este identificador indica que esta clave identifica de forma exclusiva un segmento aéreo. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier segmento aéreo que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | Este identificador indica que esta clave identifica de forma exclusiva una preferencia de hotel. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier preferencia de hotel que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1STAY\$1REVENUE | Este identificador indica que esta clave identifica de forma exclusiva un ingreso por estancia en hotel. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier ingreso por estancia en hotel que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | Este identificador indica que esta clave identifica de forma exclusiva una reserva de hotel. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier reserva de hotel que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | Este identificador indica que esta clave identifica de forma exclusiva un programa de fidelización. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier programa de fidelización que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | Este identificador indica que esta clave identifica de forma exclusiva una transacción de fidelización. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier transacción de fidelización que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | Este identificador indica que esta clave identifica de forma exclusiva una promoción de fidelización. Cuando se especifica este identificador, significa que durante la ingesta, Perfiles de clientes busca cualquier promoción de fidelización que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | Este identificador debe especificarse exactamente con un índice para cada tipo de objeto. Esta clave se utiliza para identificar de forma unívoca los objetos del tipo de objeto, ya sea para recuperarlos o, en caso necesario, para actualizar un objeto enviado posteriormente. Es obligatorio especificar todos los campos que componen las claves UNIQUE al enviar un nuevo objeto; de lo contrario, se rechazará. |
| PROFILE | Este identificador significa que esta clave identifica de forma exclusiva un perfil. Cuando se especifica este identificador, significa que durante la ingesta Perfiles de clientes busca cualquier perfil que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| LOOKUP\$1ONLY | Este identificador indica que la clave no se almacena tras realizar la ingesta del objeto. La clave solo debe utilizarse para determinar el perfil durante la ingesta. El valor de la clave no se asocia al perfil durante la ingesta, lo que significa que no puede utilizarse para permitir su búsqueda o la coincidencia de objetos ingeridos posteriormente con la misma clave. No puede especificar una clave como identificador `UNIQUE` y como identificador `LOOKUP_ONLY` a la vez. Solo se puede usar `PROFILE` junto con `LOOKUP_ONLY` si hay al menos otra clave que tenga el identificador `PROFILE` sin los identificadores `NEW_ONLY` o `LOOKUP_ONLY`. La única excepción es la `_profileId` clave, que puede tener la combinación `PROFILE` e `LOOKUP_ONLY` identificador por sí sola. |
| NEW\$1ONLY | Si el perfil aún no existe antes de realizar la ingesta del objeto, la clave se asocia al perfil. De lo contrario, la clave solo se utiliza para la coincidencia de objetos con perfiles. No puede especificar una clave como identificador `UNIQUE` y como identificador `NEW_ONLY` a la vez. Solo se puede usar `PROFILE` junto con `NEW_ONLY` si hay al menos otra clave que tenga el identificador `PROFILE` sin los identificadores `NEW_ONLY` o `LOOKUP_ONLY`. |
| SECONDARY | Durante la coincidencia de un objeto con un perfil, Perfiles de clientes busca primero todas las claves de PROFILE que no tengan el identificador SECONDARY. Estas se consideran en primer lugar. Las claves SECONDARY solo se tienen en cuenta si no se encuentra ningún perfil coincidente mediante estas claves. |
| ASSET | Este identificador significa que esta clave identifica de forma exclusiva un activo. Cuando se especifica este identificador, significa que durante la ingesta Perfiles de clientes busca cualquier activo que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | Este identificador significa que esta clave identifica de forma exclusiva un pedido. Cuando se especifica este identificador, significa que durante la ingesta Perfiles de clientes busca cualquier pedido que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
| CASE | Este identificador significa que esta clave identifica de forma exclusiva un caso. Cuando se especifica este identificador, significa que durante la ingesta Perfiles de clientes busca cualquier caso que tenga asociada esta clave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/standard-identifiers.html) |
## Identificadores compatibles
![\[Matriz que muestra los identificadores y nombres clave permitidos y restringidos para diferentes tipos de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Cómo procesa Perfiles de clientes las definiciones clave
Cuando Perfiles de clientes realiza la ingesta de las asignaciones de objetos personalizadas, procesa las definiciones de clave. En el siguiente diagrama se muestra cómo procesa los identificadores estándar en las definiciones clave para determinar a qué perfil asignar el objeto.
![\[Diagrama de flujo que muestra el proceso de verificación de las claves del perfil para asignar objetos o ponerlos en cola.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-template1.png)
# Cómo agrega Perfiles de clientes claves al índice para las búsquedas
En el siguiente diagrama se muestra cómo Perfiles de clientes procesa los identificadores estándar para determinar si debe persistir la clave.
![\[Un diagrama de flujo que muestra el proceso de toma de decisiones para conservar las claves en Perfiles de clientes en función de los criterios de búsqueda y de nuevos objetos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-template2.png)
En el diagrama se muestran los siguientes pasos:
1. ¿La clave tiene especificada la condición `LOOKUP_ONLY`?
+ En caso afirmativo, no conserve la clave.
1. En caso negativo, ¿la clave tiene especificada la condición `NEW_ONLY`?
+ En caso negativo, guarde la clave en el índice para poder utilizarla en las búsquedas.
1. En caso afirmativo, ¿la ingesta del objeto ha generado la creación de un perfil nuevo?
+ En caso afirmativo, guarde la clave en el índice para poder utilizarla en las búsquedas.
+ En caso negativo, no conserve la clave en el índice para futuras búsquedas.
# Asignación de tipos de objetos para el perfil estándar de Perfiles de clientes de Amazon Connect
En los temas de esta sección se proporciona la definición del perfil estándar y la asignación de tipo de objeto de las aplicaciones externas al perfil estándar.
**Topics**
+ [Requisitos de AppFlow acceso a Amazon](appflow-access-requirements-profile.md)
+ [Requisitos de AppIntegrations acceso a Amazon](standard-profile-appintegrations-requirements.md)
+ [
# Requisitos de EventBridge acceso a Amazon en los perfiles de los clientes
](standard-profile-eventbridge-requirements.md)
+ [Definición de perfil estándar](standard-profile-definition.md)
+ [Asignación de objetos de Salesforce](mapping-salesforce-objects.md)
+ [Asignación de objetos de Zendesk](mapping-zendesk-objects.md)
+ [Asignación de objetos de Marketo](mapping-marketo-objects.md)
+ [Mapeo de ServiceNow objetos](mapping-servicenow-objects.md)
+ [Asignación de objetos de Segment](mapping-segment-objects.md)
+ [Asignación de objetos de Shopify](mapping-shopify-objects.md)
# Requisitos de AppFlow acceso a Amazon en los perfiles de los clientes
Utilice los siguientes requisitos de AppFlow acceso a Amazon para crear y eliminar los perfiles de clientes de Zendesk, Marketo, Salesforce y las ServiceNow integraciones con Amazon Connect:
+ flujo de aplicaciones: CreateFlow
+ flujo de aplicaciones: DeleteFlow
# Requisitos de AppIntegrations acceso a Amazon en los perfiles de los clientes
Usa los siguientes requisitos de AppIntegrations acceso a Amazon para crear y eliminar integraciones de Segment y Shopify con los perfiles de clientes de Amazon Connect:
+ integraciones de aplicaciones: GetEventIntegration
+ integraciones de aplicaciones: ListEventIntegrationAssociations
+ integraciones de aplicaciones: CreateEventIntegrationAssociation
+ integraciones de aplicaciones: DeleteEventIntegrationAssociation
# Requisitos de EventBridge acceso a Amazon en los perfiles de los clientes
Usa los siguientes requisitos de EventBridge acceso a Amazon para crear y eliminar integraciones de Segment y Shopify con los perfiles de clientes de Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Definición de perfil estándar en los perfiles de clientes de Amazon Connect
En la tabla siguiente se enumeran todos los campos del objeto de perfil estándar de Perfiles de clientes.
| Campo de perfil estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| ProfileId | Cadena | El identificador único de un perfil de cliente. |
| AccountNumber | Cadena | Un número de cuenta único que ha asignado al cliente. |
| AdditionalInformation | Cadena | Cualquier información adicional pertinente para el perfil del cliente. |
| PartyType | Cadena | Tipo de perfil utilizado para describir al cliente. Valores válidos: INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | Cadena | Nombre de la empresa del cliente. |
| FirstName | Cadena | El nombre del cliente. |
| MiddleName | Cadena | El segundo nombre del cliente. |
| LastName | Cadena | Los apellidos del cliente. |
| BirthDate | Cadena | La fecha de nacimiento del cliente. |
| Gender | Cadena | El género con el que se identifica el cliente. |
| PhoneNumber | Cadena | El número de teléfono del cliente, que no se ha especificado como número de móvil, casa o empresa. |
| MobilePhoneNumber | Cadena | El número de teléfono móvil del cliente. |
| HomePhoneNumber | Cadena | El número de teléfono particular del cliente. |
| BusinessPhoneNumber | Cadena | El número de teléfono empresarial del cliente. |
| EmailAddress | Cadena | La dirección de correo electrónico del cliente, que no se ha especificado como dirección personal ni empresarial |
| PersonalEmailAddress | Cadena | Dirección de correo electrónico personal del cliente. |
| BusinessEmailAddress | Cadena | La dirección de correo electrónico empresarial del cliente. |
| Dirección | Dirección | Una dirección genérica asociada al cliente que no es de correo, envío ni facturación. |
| ShippingAddress | Dirección | La dirección de envío del cliente. |
| MailingAddress | Dirección | La dirección postal del cliente. |
| BillingAddress | Dirección | La dirección de facturación del cliente. |
| Atributos | String-to-string mapa | Par de clave-valor de los atributos de un perfil de cliente. |
| ProfileType | Cadena | Es el tipo de perfil. Valores válidos: PROFILE \$1 ACCOUNT\$1PROFILE |
| EngagementPreferences | EngagementPreferences | Son las preferencias de interacción del cliente o de la cuenta. |
Los objetos de perfil estándar se indexan mediante las claves de la siguiente tabla.
| Nombre de índice estándar | Campo de perfil estándar |
| --- | --- |
| \$1phone | PhoneNumber, MobilePhoneNumber HomePhoneNumber, o BusinessPhoneNumber |
| \$1email | EmailAddress, PersonalEmailAddress, o BusinessEmailAddress |
| \$1account | AccountNumber |
| \$1ProfileID | ProfileId |
| \$1fullName | "FirstName MiddleName LastName" |
Por ejemplo, puede usarlo `_phone` como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil cuyo PhoneNumber, MobilePhoneNumber HomePhoneNumber, o BusinessPhoneNumber atributo coincida con el valor de búsqueda.
## Tipo de datos de dirección
| Campo de perfil estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Address1 | Cadena | La primera línea de una dirección de cliente. |
| Address2 | Cadena | La segunda línea de una dirección de cliente. |
| Address3 | Cadena | La tercera línea de una dirección de cliente. |
| Address4 | Cadena | La cuarta línea de una dirección de cliente. |
| Ciudad | Cadena | La ciudad en la que vive el cliente. |
| País | Cadena | El país en la que vive el cliente. |
| County | Cadena | El condado en la que vive el cliente. |
| PostalCode | Cadena | El código postal de la dirección del cliente. |
| Province | Cadena | La provincia en la que vive el cliente. |
| Estado | Cadena | El estado en el que vive el cliente. |
## EngagementPreferences tipo de datos
| Campo de perfil estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Correo electrónico | Matriz de ContactPreference objetos | Es una lista de preferencias de contacto por correo electrónico. |
| Teléfono | Matriz de ContactPreference objetos | Es una lista de preferencias de contacto por teléfono. |
## ContactPreference tipo de datos
| Campo de perfil estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| KeyName | Cadena | Es un identificador único y que se puede buscar de un perfil de cliente. |
| KeyValue | Cadena | Es el valor clave utilizado para buscar el perfil en función de keyName. |
| ProfileId | Cadena | El identificador único de un perfil de cliente. |
| ContactType | Cadena | Es el tipo de contacto utilizado para la interacción. Valores válidos: PhoneNumber MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# Asignación de objetos de Salesforce al perfil estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Salesforce que se asignan a los campos del objeto de perfil estándar en Perfiles de clientes.
## Objeto Salesforce-Account
A continuación, encontrará una lista de todos los campos de un objeto Salesforce-Account. Los campos del objeto Salesforce-Account pueden variar en función de la configuración de su instancia de Salesforce.
+ Id
+ IsDeleted
+ MasterRecordId
+ Name
+ Tipo
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.Ciudad
+ BillingAddress.País
+ BillingAddress. Precisión de geocodificación
+ BillingAddress.latitud
+ BillingAddress.longitud
+ BillingAddress. Código postal
+ BillingAddress.estado
+ BillingAddress.calle
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.city
+ ShippingAddress.país
+ ShippingAddress.latitud
+ ShippingAddress.longitud
+ ShippingAddress. Código postal
+ ShippingAddress.estado
+ ShippingAddress.calle
+ Teléfono
+ Fax
+ AccountNumber
+ Sitio web
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ Description (Descripción)
+ Rating
+ Sitio
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Jigsaw
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer
## Asignación de un objeto Salesforce-Account a un perfil estándar
Un subconjunto de los campos de la asignación del objeto Salesforce-Account al objeto de perfil estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Salesforce-Account al perfil estándar. (La tabla incluye la asignación para una instancia de Salesforce que se ha configurado para incluir campos de persona).
| Campo de origen de Salesforce-Account | Campo de destino de perfil estándar |
| --- | --- |
| Id | Atributos. sfdcAccountId |
| Name | BusinessName |
| Teléfono | PhoneNumber |
| BillingStreet | BillingAddress.Dirección 1 |
| BillingCity | BillingAddress.Ciudad |
| BillingState | BillingAddress.Estado |
| BillingCountry | BillingAddress.País |
| BillingPostalCode | BillingAddress.PostalCode |
| ShippingStreet | ShippingAddress.Dirección 1 |
| ShippingCity | ShippingAddress.Ciudad |
| ShippingState | ShippingAddress.Estado |
| ShippingCountry | ShippingAddress.País |
| ShippingPostalCode | ShippingAddress.PostalCode |
| IsPersonAccount | PartyType |
| PersonMobilePhone | MobilePhoneNumber |
| PersonHomePhone | HomePhoneNumber |
| PersonEmail | PersonalEmailAddress |
| PersonMailingAddress.Calle | MailingAddress.Dirección 1 |
| PersonMailingAddress.Ciudad | MailingAddress.Ciudad |
| PersonMailingAddress.Estado | MailingAddress.Estado |
| PersonMailingAddress.País | MailingAddress.País |
| PersonMailingAddress.PostalCode | MailingAddress.PostalCode |
| PersonBirthDate | BirthDate |
| PersonOtherStreet | Address.Address1 |
| PersonOtherCity | Address.City |
| PersonOtherState | Address.State |
| PersonOtherCountry | Address.Country |
| PersonOtherPostalCode | Dirección. PostalCode |
| FirstName | FirstName |
| LastName | LastName |
| MiddleName | MiddleName |
| AccountNumber | AccountNumber |
Los datos de cliente de Salesforce-Account del objeto de Salesforce se asocian con un perfil de cliente de Amazon Connect mediante los índices de la tabla siguiente.
| Nombre de índice estándar | Campo de origen de Salesforce-Account |
| --- | --- |
| \$1salesforceAccountId | Id |
Por ejemplo, puedes usarlo `_salesforceAccountId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil. Puede encontrar los objetos de la cuenta de Salesforce asociados a un perfil específico utilizando la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Salesforce-Account`
## Objeto Salesforce-Contact
A continuación, encontrará una lista de todos los campos de un objeto Salesforce-Contact.
+ Id
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ Name
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.city
+ OtherAddress.país
+ OtherAddress. Precisión de geocodificación
+ OtherAddress.latitud
+ OtherAddress. Código postal
+ OtherAddress.estado
+ OtherAddress.calle
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.city
+ MailingAddress.país
+ MailingAddress. Precisión de geocodificación
+ MailingAddress.latitud
+ MailingAddress.longitud
+ MailingAddress. Código postal
+ MailingAddress.estado
+ MailingAddress.calle
+ Teléfono
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ Correo electrónico
+ Title
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ Description (Descripción)
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ Última fecha CURequest
+ Última CUUpdate fecha
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## Asignación de un objeto Salesforce-Contact a un perfil estándar
Un subconjunto de los campos de la asignación del objeto Salesforce-Contact al objeto de perfil estándar en Perfiles de clientes. En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Salesforce-Contact al objeto de perfil estándar.
| Campo de origen de Salesforce-Contact | Campo de destino de perfil estándar |
| --- | --- |
| Id | Atributos. sfdcContactId |
| AccountId | Atributos. sfdcAccountId |
| LastName | LastName |
| FirstName | FirstName |
| MiddleName | MiddleName |
| OtherStreet | Address.Address1 |
| OtherCity | Address.City |
| OtherState | Address.State |
| OtherCountry | Address.Country |
| OtherPostalCode | Dirección. PostalCode |
| MailingStreet | MailingAddress.Dirección 1 |
| MailingCity | MailingAddress.Ciudad |
| MailingState | MailingAddress.Estado |
| MailingCountry | MailingAddress.País |
| MailingPostalCode | MailingAddress.PostalCode |
| Teléfono | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| Correo electrónico | EmailAddress |
| Birthdate | BirthDate |
Los datos de cliente de Salesforce-Contact de un objeto de Salesforce se asocian con un perfil de cliente de Amazon Connect mediante los índices de la tabla siguiente.
| Nombre de índice estándar | Campo de origen de Salesforce-Contact |
| --- | --- |
| \$1salesforceContactId | Id |
| \$1salesforceAccountId | AccountId |
Por ejemplo, puedes usar `_salesforceAccountId` y `_salesforceContactId` como nombre clave en la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil. Para encontrar los objetos de Salesforce-Contact asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Salesforce-Contact`
# Asignación de objetos de Zendesk al perfil estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Zendesk que se asignan a los campos del perfil estándar en Perfiles de clientes.
## Objeto Zendesk-users
A continuación, se muestra una lista de todos los campos de un objeto Zendesk-users.
+ id
+ url
+ external\$1id
+ correo electrónico
+ active
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ details
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ rol
+ shared
+ etiquetas
+ firma
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## Asignación de usuarios de Zendesk a un perfil estándar
Un subconjunto de los campos de la asignación del objeto Zendesk-users al perfil estándar en Perfiles de clientes. En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Zendesk-users al perfil estándar.
| Campo de origen de Zendesk-users | Campo de destino de perfil estándar |
| --- | --- |
| id | Atributos. ZendeskUserId |
| external\$1id | Atributos. ZendeskExternalId |
| correo electrónico | EmailAddress |
| phone | PhoneNumber |
Los datos de cliente de Zendesk-users del objeto de Zendesk se asocian a un perfil de cliente de Amazon Connect mediante los siguientes índices.
| Nombre de índice estándar | Campo de origen de Zendesk-user |
| --- | --- |
| \$1zendeskUserId | Id |
| \$1zendeskExternalId | external\$1id |
Por ejemplo, puedes usar `_zendeskUserId` y `_zendeskExternalId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil de cliente de Amazon Connect. Para encontrar los objetos de los usuarios de Zendesk asociados a un perfil de cliente específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Zendesk-users`
# Asignación de objetos de Marketo al perfil estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Marketo que se asignan a los campos del objeto de perfil estándar en Perfiles de clientes.
## Objeto Marketo-leads
A continuación, se muestra una lista de todos los campos de un objeto Marketo-leads.
+ id
+ firstName
+ lastName
+ middleName
+ correo electrónico
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ dirección
+ ciudad
+ estado
+ país
+ postalcode
+ gender
+ dateOfBirth
## Asignación de Marketo-leads a un perfil estándar
Un subconjunto de campos de la asignación del objeto Marketo-leads al perfil estándar.
| Campo de origen de Marketo-leads | Campo de destino de perfil estándar |
| --- | --- |
| id | Atributos. MarketoLeadId |
| sfdcAccountId | Atributos. sfdcAccountId |
| sfdcContactId | Atributos. sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| correo electrónico | EmailAddress |
| phone | PhoneNumber |
| mobilePhone | MobilePhoneNumber |
| mobilePhone | MobilePhoneNumber |
| billingStreet | BillingAddress.Dirección 1 |
| billingCity | BillingAddress.Ciudad |
| billingState | BillingAddress.Estado |
| billingCountry | BillingAddress.País |
| billingPostalCode | BillingAddress.PostalCode |
| dirección | Address.Address1 |
| ciudad | Address.City |
| estado | Address.State |
| país | Address.Country |
| postalcode | Dirección. PostalCode |
| gender | Gender |
| dataOfBirth | BirthDate |
Los datos de cliente de Marketo-leads de Marketo se asocian con un perfil de cliente de Amazon Connect mediante los índices de la tabla siguiente.
| Nombre de índice estándar | Campo de origen de Marketo-leads |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
Por ejemplo, puedes usar `_marketoLeadId``_salesforceAccountId`, y `_salesforceContactId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil de cliente de Amazon Connect. Para encontrar los objetos de Marketo-leads asociados a un perfil de cliente específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Marketo-leads`
# Asignación de ServiceNow objetos al objeto de perfil estándar en los perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los ServiceNow objetos que se asignan a los campos del objeto de perfil estándar de los perfiles de clientes de Amazon Connect.
## Objeto Servicenow-sys\$1user
A continuación, se muestra una lista de todos los campos de un objeto Servicenow-sys\$1user.
+ sys\$1id
+ active
+ building
+ calendar\$1integration
+ ciudad
+ company
+ cost\$1center
+ país
+ date\$1format
+ default\$1perspective
+ departamento
+ edu\$1status
+ correo electrónico
+ employee\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ ubicación
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ name
+ notificación
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ roles
+ horario
+ origen
+ estado
+ street
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ sys\$1domain.link
+ sys\$1domain.value
+ sys\$1domain\$1path
+ sys\$1id
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1udpated\$1on
+ time\$1format
+ time\$1zone
+ título
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip
## Asignación de ServiceNow-SYS\$1Users a un objeto de perfil estándar
Un subconjunto de los campos de la asignación del objeto Servicenow-sys\$1users al perfil estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Servicenow-sys\$1users al perfil estándar.
| Campo de origen de Servicenow-sys\$1users | Campo de destino de perfiles de clientes |
| --- | --- |
| sys\$1id | Atributos. ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | Gender |
| correo electrónico | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| ciudad | Address.City |
| estado | Address.State |
| país | Address.Country |
| zip | Dirección. PostalCode |
Los datos de cliente de Servicenow-sys\$1user del objeto de Servicenow se asocian a un perfil de cliente de Amazon Connect mediante los índices de la siguiente tabla.
| Nombre de índice estándar | Campo de origen de Servicenow-sys\$1user |
| --- | --- |
| \$1 serviceNowSystem Identificación | sys\$1id |
Por ejemplo, puedes usar `_serviceNowSystemId` y `_serviceNowIncidentId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil de cliente de Amazon Connect. Para encontrar los objetos ServiceNow-SYS\$1User asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el y establecido en. `ProfileId` `ObjectTypeName` `Servicenow-sys_user`
# Asignación de objetos de Segment al perfil estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Segment que están asignados a los campos del perfil estándar en Perfiles de clientes de Amazon Connect.
## Objeto Segment-Identify
A continuación, se muestra una lista de todos los campos de un objeto Segment-Identify.
+ userId
+ campos comunes; consulte [Especificación: campos comunes](https://segment.com/docs/connections/spec/common/) en la documentación de Segment
+ características reservadas de Segment; consulte [Características](https://segment.com/docs/connections/spec/identify/#traits) en la documentación de Segment
+ traits.address.street
+ traits.address.city
+ traits.address.state
+ traits.address.postalCode
+ traits.address.country
+ traits.age
+ traits.avatar
+ traits.birthday
+ traits.company.name
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website
## Asignación de Segment-Identify a un objeto de perfil estándar
Un subconjunto de los campos de la asignación del objeto Segment-Identify al objeto de perfil estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Segment-Identify al perfil estándar.
| Campo de origen de Segment-Identify | Campo de destino de perfil estándar |
| --- | --- |
| | Campo de destino de perfil estándar |
| userId | Atributos. SegmentUserId |
| traits.company.name | BusinessName |
| traits.firstName | FirstName |
| traits.lastName | LastName |
| traits.birthday | BirthDate |
| traits.gender | Gender |
| traits.phone | PhoneNumber |
| traits.email | EmailAddress |
| traits.address.street | Address.Address1 |
| traits.address.city | Address.City |
| traits.address.state | Address.State |
| traits.address.country | Address.Country |
| traits.address.postalCode | Dirección. PostalCode |
### Ejemplo
En el siguiente ejemplo se muestra cómo asignar un campo de origen a un campo de destino.
```
"segmentUserId": {
"Source": "_source.detail.event.detail.userId",
"Target": "_profile.Attributes.SegmentUserId"
}
```
Los datos de cliente de Segment-Identify del objeto de Segment se asocian a un perfil de cliente de Amazon Connect mediante el siguiente índice.
| Nombre de índice estándar | Campo de origen de Segment-Identify |
| --- | --- |
| \$1segmentUserId | userId |
Por ejemplo, puedes usarlo `_segmentUserId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil de cliente de Amazon Connect. Para encontrar los objetos de identificación de segmentos asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Segment-Identify`
# Asignación de objetos de Shopify al perfil estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Shopify que están asignados a los campos del perfil estándar en Perfiles de clientes de Amazon Connect.
## Objeto de Shopify-Customer
A continuación, se muestra una lista de todos los campos de un objeto Shopify-Customer.
+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ direcciones
+ divisa
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ correo electrónico
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ phone
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ estado
+ etiquetas
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## Asignación de un objeto Shopify-Cliente a un perfil estándar
Un subconjunto de los campos de la asignación del objeto Shopify-Customer al objeto de perfil estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Shopify-Customer al perfil estándar.
| Campo de origen de Shopify-Customer | Campo de destino de perfil estándar |
| --- | --- |
| id | Atributos. ShopifyCustomerId |
| email | EmailAddress |
| first\$1name | FirstName |
| last\$1name | LastName |
| note | AdditionalInformation |
| phone | PhoneNumber |
| default\$1address.address1 | Address.Address1 |
| default\$1address.address2 | Address.Address2 |
| default\$1address.city | Address.City |
| default\$1address.province | Address.Province |
| default\$1address.country | Address.Country |
| default\$1address.zip | Dirección. PostalCode |
### Ejemplo
En el siguiente ejemplo se muestra cómo asignar un campo de origen a un campo de destino.
```
"shopifyCustomerId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_profile.Attributes.ShopifyCustomerId"
}
```
Los datos de cliente de Shopify-Customer del objeto de Shopify se asocian a un perfil de cliente de Amazon Connect mediante el siguiente índice.
| Nombre de índice estándar | Campo de origen de Shopify-Customer |
| --- | --- |
| \$1shopifyCustomerId | id |
Por ejemplo, puedes usarlo `_shopifyCustomerId` como nombre clave con la [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API para buscar un perfil de cliente de Amazon Connect. Para encontrar los objetos de Shopify Customer asociados a un perfil específico, usa la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y establecido en. `ObjectTypeName` `Shopify-Customer`
# Asignación de tipos de objetos de pedidos estándar en Perfiles de clientes de Amazon Connect
En los temas de esta sección se proporciona la definición del pedido estándar y la asignación de tipo de objeto de las aplicaciones externas al pedido estándar.
**Topics**
+ [Requisitos de AppIntegrations acceso a Amazon](standard-order-appintegrations-requirements.md)
+ [Requisitos de EventBridge acceso a Amazon](standard-order-eventbridge-requirements.md)
+ [Definición de pedido estándar](standard-order-definition.md)
+ [Asignación de objetos de Shopify](mapping-shopify-objects-standard-order.html.md)
# Requisitos de AppIntegrations acceso a Amazon
Usa los siguientes requisitos de AppIntegrations acceso a Amazon para crear y eliminar integraciones de Shopify con los perfiles de clientes de Amazon Connect:
+ integraciones de aplicaciones: GetEventIntegration
+ integraciones de aplicaciones: ListEventIntegrationAssociations
+ integraciones de aplicaciones: CreateEventIntegrationAssociation
+ integraciones de aplicaciones: DeleteEventIntegrationAssociation
# Requisitos de EventBridge acceso a Amazon
Usa los siguientes requisitos de EventBridge acceso a Amazon para crear y eliminar integraciones de Shopify con los perfiles de clientes de Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Campos del objeto de pedido estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de pedido estándar de Perfiles de clientes.
| Campo de pedido estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| OrderId | Cadena | Identificador único de un pedido estándar. |
| CustomerEmail | Cadena | Es la dirección de correo electrónico del cliente. |
| CustomerPhone | Cadena | El número de teléfono del cliente. |
| CreatedDate | Cadena | Es la fecha de creación del pedido. |
| UpdatedDate | Cadena | Es la fecha actualizada del pedido. |
| ProcessedDate | Cadena | Es la fecha en que se procesó el pedido. |
| ClosedDate | Cadena | Es la fecha de cierre del pedido. |
| CancelledDate | Cadena | Es la fecha de cancelación del pedido. |
| CancelReason | Cadena | Es el motivo de cancelación del pedido. |
| Name | Cadena | Es el nombre del pedido. |
| AdditionalInformation | Cadena | Cualquier información adicional pertinente para el pedido. |
| Puerta de enlace | Cadena | Es la puerta de enlace de pago del pedido. |
| Status | Cadena | Es el estado del pedido. |
| StatusCode | Cadena | Es el código de estado del pedido. Valores válidos: DRAFT \$1 ACTIVATED |
| StatusUrl | Cadena | Es la URL del estado del pedido. |
| CreditCardNumber | Cadena | Son los cuatro últimos dígitos de la tarjeta de crédito del cliente. |
| CreditCardCompany | Cadena | Es la empresa emisora de la tarjeta de crédito del cliente. |
| FulfillmentStatus | Cadena | Es el estado de cumplimiento del pedido. |
| TotalPrice | Cadena | Es el precio total del pedido. |
| TotalTax | Cadena | Es el valor total de los impuestos del pedido. |
| TotalDiscounts | Cadena | Son los descuentos totales del pedido. |
| TotalItemsPrice | Cadena | Es el precio total de los artículos del pedido. |
| TotalShippingPrice | Cadena | Es el precio total del envío del pedido. |
| TotalTipReceived | Cadena | Es la propina total recibida por el pedido. |
| Currency (Divisa) | Cadena | Es la divisa del pedido. |
| TotalWeight | Cadena | Es el peso total del pedido. |
| BillingAddress | OrderAddress | La dirección de facturación del cliente. |
| ShippingAddress | OrderAddress | La dirección de envío del cliente. |
| OrderItems | OrderItem lista | Son los artículos del pedido. |
| Atributos | String-to-string mapa | Par de clave-valor de los atributos de un pedido estándar. |
Los objetos de pedido estándar se indexan mediante las claves de la siguiente tabla.
| Nombre de índice estándar | Campo de pedido estándar |
| --- | --- |
| \$1orderId | OrderId |
Por ejemplo, puedes usarlo `_orderId` como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil que tenga un orden que OrderId coincida con el valor de búsqueda. Para encontrar los objetos de pedido estándar asociados a un perfil específico, utilice la [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con el `ProfileId` y `ObjectTypeName` establecido en`_order`.
## OrderAddress tipo de datos
| Campo de pedido estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Es el nombre asociado a la dirección de un pedido. |
| Address1 | Cadena | Es la primera línea de la dirección de un pedido. |
| Address2 | Cadena | Es la segunda línea de la dirección de un pedido. |
| Address3 | Cadena | Es la tercera línea de la dirección de un pedido. |
| Address4 | Cadena | Es la cuarta línea de la dirección de un pedido. |
| Ciudad | Cadena | Es la ciudad de la dirección de un pedido. |
| County | Cadena | Es el condado de la dirección de un pedido. |
| Estado | Cadena | Es el estado de la dirección de un pedido. |
| Province | Cadena | Es la provincia de la dirección de un pedido. |
| País | Cadena | Es el país de la dirección de un pedido. |
| PostalCode | Cadena | Es el código postal de la dirección de un pedido. |
## OrderItem tipo de datos
| Campo de pedido estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Title | Cadena | Es el título de un artículo del pedido. |
| Precio | Cadena | Es el precio de un artículo del pedido. |
| Cantidad | Cadena | Es la cantidad de un artículo del pedido. |
# Asignación de objetos de Shopify al pedido estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Shopify que están asignados a los campos del objeto de pedido estándar en Perfiles de clientes.
## Shopify: objeto DraftOrder
Para ver una lista de todos los campos de un objeto de Shopify, consulta [El DraftOrder DraftOrder objeto en la documentación](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) de Shopify.
## Asignar un DraftOrder objeto de Shopify a un pedido estándar
Un subconjunto de los campos del objeto de Shopify se corresponde con el DraftOrder objeto de pedido estándar de los perfiles de clientes.
La siguiente tabla muestra los campos que se pueden asignar desde el DraftOrder objeto de Shopify al pedido estándar.
El `StatusCode` es `ACTIVATED` si `order_status_url` existe en el origen. De lo contrario, `StatusCode` es `DRAFT`.
| Shopify: campo fuente DraftOrder | Campo de destino del pedido estándar |
| --- | --- |
| id | Atributos. ShopifyOrderId |
| customer.id | Atributos. ShopifyCustomerId |
| note | AdditionalInformation |
| correo electrónico | CustomerEmail |
| divisa | Currency (Divisa) |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| name | Name |
| status | Status |
| order\$1status\$1url | StatusCode |
| billing\$1address.address1 | BillingAddress.Dirección 1 |
| billing\$1address.address2 | BillingAddress.Dirección 2 |
| billing\$1address.city | BillingAddress.Ciudad |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Provincia |
| billing\$1address.country | BillingAddress.País |
| billing\$1address.name | BillingAddress.Nombre |
| shipping\$1address.address1 | ShippingAddress.Dirección 1 |
| shipping\$1address.address2 | ShippingAddress.Dirección 2 |
| shipping\$1address.city | ShippingAddress.Ciudad |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Provincia |
| shipping\$1address.country | ShippingAddress.País |
| shipping\$1address.name | ShippingAddress.Nombre |
| invoice\$1url | StatusUrl |
| total\$1price | TotalPrice |
| total\$1tax | TotalTax |
| line\$1items[].title | OrderItems[] .Título |
| line\$1items[].price | OrderItems[] .Precio |
| line\$1items[].quantity | OrderItems[] .Cantidad |
### Ejemplo
En el siguiente ejemplo se muestra cómo asignar un campo de origen a un campo de destino.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Los datos de los DraftOrder clientes de Shopify del objeto de Shopify se asocian a un pedido estándar de Amazon Connect mediante el siguiente índice.
| Nombre de índice estándar | Shopify: campo de origen DraftOrder |
| --- | --- |
| \$1shopifyOrderId | id |
Por ejemplo, puedes usarlo `_shopifyOrderId` `ObjectFilter.KeyName` junto con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un pedido estándar. Para encontrar los DraftOrder objetos de Shopify asociados a un perfil específico, usa la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` y `ObjectTypeName` configurados en. `Shopify-DraftOrder`
## Objeto Shopify-Order
Para obtener una lista de todos los campos de un objeto Shopify-Order consulte [El objeto Order](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object) en la documentación de Shopify.
## Asignación de un objeto Shopify-Order a un pedido estándar
Un subconjunto de los campos de la asignación del objeto Shopify-Order al objeto de pedido estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Shopify-Order al pedido estándar.
El `StatusCode` es `ACTIVATED` si `order_status_url` existe en el origen. De lo contrario, `StatusCode` es `DRAFT`.
| Campo de origen de Shopify-Order | Campo de destino del pedido estándar |
| --- | --- |
| id | Atributos. ShopifyOrderId |
| customer.id | Atributos. ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| divisa | Currency (Divisa) |
| correo electrónico | CustomerEmail |
| financial\$1status | Status |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| gateway | Puerta de enlace |
| name | Name |
| note | AdditionalInformation |
| order\$1status\$1url | StatusUrl |
| phone | CustomerPhone |
| processed\$1at | ProcessedDate |
| total\$1discounts | TotalDiscounts |
| total\$1line\$1items\$1price | TotalItemsPrice |
| total\$1price | TotalPrice |
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice |
| total\$1tax | TotalTax |
| total\$1tip\$1received | TotalTipReceived |
| total\$1weight | TotalWeight |
| updated\$1at | UpdatedDate |
| billing\$1address.address1 | BillingAddress.Dirección 1 |
| billing\$1address.address2 | BillingAddress.Dirección 2 |
| billing\$1address.city | BillingAddress.Ciudad |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Provincia |
| billing\$1address.country | BillingAddress.País |
| billing\$1address.name | BillingAddress.Nombre |
| payment\$1details.credit\$1card\$1number | CreditCardNumber |
| payment\$1details.credit\$1card\$1company | CreditCardCompany |
| shipping\$1address.address1 | ShippingAddress.Dirección 1 |
| shipping\$1address.address2 | ShippingAddress.Dirección 2 |
| shipping\$1address.city | ShippingAddress.Ciudad |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Provincia |
| shipping\$1address.country | ShippingAddress.País |
| shipping\$1address.name | ShippingAddress.Nombre |
| line\$1items[].title | OrderItems[] .Título |
| line\$1items[].price | OrderItems[] .Precio |
| line\$1items[].quantity | OrderItems[] .Cantidad |
### Ejemplo
En el siguiente ejemplo se muestra cómo asignar un campo de origen a un campo de destino.
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Los datos de cliente de Shopify-Order del objeto de Shopify se asocian a un pedido estándar de Amazon Connect mediante el siguiente índice.
| Nombre de índice estándar | Campo de origen de Shopify-Order |
| --- | --- |
| \$1shopifyOrderId | id |
Por ejemplo, puedes utilizarla `_shopifyOrderId` como una `ObjectFilter.KeyName` con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un pedido estándar. Para encontrar los objetos de Shopify-Order asociados a un perfil específico, usa la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y establecido en. `ObjectTypeName` `Shopify-Order`
# Asignación de tipo de objeto para el registro de comunicación estándar
En los temas de esta sección se proporciona la definición del registro de comunicación estándar y la asignación de tipo de objeto de los eventos de la campaña al registro de comunicación estándar.
**Topics**
+ [Campos del objeto de registro de comunicación estándar de Perfiles de clientes](customer-profiles-standard-communication-record-object-fields.md)
+ [Asignación de objetos de campaña al registro de comunicación estándar en Perfiles de clientes de Amazon Connect](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)
# Campos del objeto de registro de comunicación estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de registro de comunicación estándar de Perfiles de clientes.
| Campo communicationRecord estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| CommunicationRecordId | Cadena | Es el identificador único de un registro de comunicación estándar. |
| Canal | Cadena | Es el método utilizado para contactar con su centro de contacto. Por ejemplo: VOICE, CHAT, EMAIL |
| ConnectInstanceArn | Cadena | El ARN de la instancia de AWS Connect. |
| CreatedDate | Cadena | Marca de tiempo que indica cuándo se creó el registro de comunicación. |
| UpdatedDate | Cadena | Marca de tiempo que indica cuándo se actualizó el registro de comunicación por última vez. |
| LastEventType | Cadena | Es el tipo de evento del último evento ingerido para esta comunicación. |
| Campaña | Campaña | Detalles sobre la campaña asociada a esta comunicación. |
| Punto de conexión | Punto de conexión | Información sobre el punto de conexión utilizado para esta comunicación. |
| Events (Eventos) | Mapa | Es un mapa de eventos en el que la clave es el tipo de evento, como el correo electrónico entregado, abierto o en el que se ha hecho clic. Se realiza un seguimiento del último evento de cada tipo de evento único que se produjo durante esta comunicación. |
| Atributos | Mapa | Par de clave-valor de los atributos de un registro de comunicación estándar. |
Los objetos de registro de comunicación estándar se indexan mediante las claves de la siguiente tabla.
| Nombre de índice estándar | Campo de registro de comunicación estándar |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
Por ejemplo, puede usarlo `_communicationRecordId` como nombre clave en la [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API para buscar un perfil que tenga un registro de comunicación que `CommunicationRecordId` coincida con el valor de búsqueda. Para encontrar los `communicationRecord` objetos estándar asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en`_communicationRecord`.
## Tipo de datos de campaña
| Campo | Tipo de datos: | Descripción |
| --- | --- | --- |
| CampaignId | Cadena | Es el ID único de la campaña externa. |
| CampaignName | Cadena | Es el nombre de la campaña externa. |
| CampaignRunId | Cadena | Es el ID único de una ejecución específica de la campaña. |
| CampaignActivityId | Cadena | El ID único de la actividad dentro de la campaña. |
| SegmentArn | Cadena | Es el ARN de un segmento de usuarios. |
## Tipo de datos de punto de conexión
| Campo | Tipo de datos: | Descripción |
| --- | --- | --- |
| EndpointAddress | Cadena | Es la dirección del punto de conexión (por ejemplo, dirección de correo electrónico o número de teléfono). |
| EndpointType | Cadena | Es el tipo de punto de conexión, como el correo electrónico predeterminado o el correo electrónico empresarial. |
## Tipo de datos de eventos
| Campo | Tipo de datos: | Descripción |
| --- | --- | --- |
| UpdatedDate | Cadena | Marca de tiempo que indica cuándo se produjo el evento de comunicación. |
| EventId | Cadena | Identificador único para cada evento de comunicación. |
| EventType | Cadena | Es el tipo de evento de comunicación específico. |
| Atributos | Mapa | Par de clave-valor de atributos específicos del tipo de evento. |
# Asignación de objetos de campaña al registro de comunicación estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de campaña que están asignados a los campos del objeto de pedido estándar en Perfiles de clientes.
## Objeto Campaign-Email
Para obtener una lista de todos los campos de un objeto Campaign-Email, consulte el [objeto Email](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html) en la documentación de Amazon SES.
**Asignación de un objeto Campaign-Email a un registro de comunicación estándar**
Es un subconjunto de los campos de la asignación del objeto Campaign-Email al registro de comunicación estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Campaign-Email al registro de comunicación estándar.
| Campo de origen Campaign-Email | Campo de destino del registro de comunicación estándar |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint\$1address | Punto final. EndpointAddress |
| endpoint\$1type | Punto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campaña. CampaignName |
| campaign\$1id | Campaña. CampaignId |
| campaign\$1run\$1id | Campaña. CampaignRunId |
| campaign\$1activity\$1id | Campaña. CampaignActivityId |
| segment\$1arn | Campaña. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| email.bounce.bounceType | Eventos.Rebot.Atributos. BounceType |
| correo electrónico.bounce. bounceSubType | Eventos.Rebot.Atributos. BounceSubType |
| email.click.link | Events.Click.Attributes.Link |
| email.click.ipAddress | Eventos.Click.Attributes. IpAddress |
| email.open.ipAddress | Events.Open.Attributes. IpAddress |
| email.reject.reason | Events.Reject.Attributes.Reason |
| email.renderingFailure.templateName | Eventos. RenderingFailure.Atributos. TemplateName |
| email.renderingFailure.errorMessage | Eventos. RenderingFailure.Atributos. ErrorMessage |
| email.deliveryDelay.delayType | Eventos. DeliveryDelay.Atributos. DelayType |
| correo electrónico.queja. complaintFeedbackType | Eventos. Queja. Atributos. ComplaintFeedbackType |
| correo electrónico.queja. complaintSubType | Eventos. Queja. Atributos. ComplaintSubType |
| email.mail.commonHeaders.subject | Attributes.Subject |
## Objeto Campaign-SMS
Para obtener una lista de todos los campos de un objeto Campaign-SMS, consulte [Objeto SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) en la documentación de Mensajes SMS para usuarios finales de AWS .
**Asignación de un objeto Campaign-SMS a un registro de comunicación estándar**
Es un subconjunto de los campos de la asignación del objeto Campaign-SMS al registro de comunicación estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Campaign-SMS al registro de comunicación estándar.
| Campo de origen Campaign-SMS | Campo de destino del registro de comunicación estándar |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint\$1address | Punto final. EndpointAddress |
| endpoint\$1type | Punto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campaña. CampaignName |
| campaign.campaign\$1id | Campaña. CampaignId |
| campaign.campaign\$1run\$1id | Campaña. CampaignRunId |
| campaign\$1activity\$1id | Campaña. CampaignActivityId |
| segment\$1arn | Campaña. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| sms.messageType | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageType |
| sms.messageStatus | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageStatus |
| sms. messageStatusDescription | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. MessageStatusDescription |
| sms. totalMessagePrice | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. TotalMessagePrice |
| sms. totalCarrierFee | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. TotalCarrierFee |
| sms. isoCountryCode | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. IsoCountryCode |
## Objeto Campaign-Telephony
Para obtener una lista de todos los campos de un objeto Campaign-Telephony, consulte el [objeto Voice en la documentación](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) de SMS de AWS End User Messaging.
**Asignación de un objeto Campaign-Telephony a un registro de comunicación estándar**
Es un subconjunto de los campos de la asignación del objeto Campaign-Telephony al registro de comunicación estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Campaign-Telephony al registro de comunicación estándar.
| Campo de origen de Campaign-Telephony | Campo de destino del registro de comunicación estándar |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| outbound\$1request\$1id | Atributos. OutboundCampaignRequestId |
| campaign\$1message\$1id | Atributos. CampaignMessageId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| endpoint.endpoint\$1address | Punto final. EndpointAddress |
| endpoint.endpoint\$1type | Punto final. EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campaña. CampaignName |
| campaign.campaign\$1id | Campaña. CampaignId |
| campaign.campaign\$1run\$1id | Campaña. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campaña. CampaignActivityId |
| campaign.segment\$1arn | Campaña. SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| Información de Voice.AgentInfo. connectedToAgentMarca de tiempo | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. ConnectedToAgentTimestamp |
| voz. customerVoiceActivity. greetingEndTimestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. GreetingEndTimestamp |
| voz. answeringMachineDetectionEstado | Eventos. \$1\$1campaign\$1event\$1type\$1\$1 .Atributos. AnsweringMachineDetectionStatus |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Objeto Campaign-Orchestration
**Asignación de un objeto Campaign-Orchestration a un registro de comunicación estándar**
Es un subconjunto de los campos de la asignación del objeto Campaign-Orchestration al registro de comunicación estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Campaign-Orchestration al registro de comunicación estándar.
| Campo de origen de Campaign-Orchestration | Campo de destino del registro de comunicación estándar |
| --- | --- |
| campaign\$1event\$1id | Atributos. LastCampaignEventId |
| channel.name | Canal |
| channel.subtype | Atributos. ChannelSubType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campaña. CampaignName |
| campaign.campaign\$1id | Campaña. CampaignId |
| campaign.campaign\$1run\$1id | Campaña. CampaignRunId |
| campaign.campaign\$1activity\$1id | Campaña. CampaignActivityId |
| campaign.segment\$1arn | Campaña. SegmentArn |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate |
| campaign\$1event\$1id | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventId |
| campaign\$1event\$1type | Eventos. \$1\$1campaign\$1event\$1type\$1\$1. EventType |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Ejemplo
En el siguiente ejemplo se muestra cómo asignar un campo de origen a un campo de destino:
```
"channel": {
"source": "_source.engagement.channel.name",
"target": "_communicationRecord.Channel"
}
```
# Asignación de tipo de objeto para el activo estándar de Perfiles de clientes
En los temas de esta sección se proporciona la definición del activo estándar y la asignación de tipo de objeto de las aplicaciones externas al activo estándar.
**Topics**
+ [Requisitos de AppFlow acceso a Amazon](appflow-access-requirements-asset.md)
+ [Definición de activo estándar](standard-asset-definition.md)
+ [Asignación de objetos de Salesforce al activo estándar](mapping-salesforce-objects-to-asset.md)
# Requisitos de AppFlow acceso a Amazon en los perfiles de los clientes
Utilice los siguientes requisitos de AppFlow acceso a Amazon para crear y eliminar integraciones de Salesforce con los perfiles de clientes de Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Definición de activo estándar en Perfiles de clientes de Amazon Connect
En la tabla siguiente se enumeran todos los campos del objeto de activo estándar de Perfiles de clientes.
| Campo de activo estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| AssetId | Cadena | Identificador único de un activo estándar. |
| AssetName | Cadena | Nombre del activo. |
| SerialNumber | Cadena | Número de serie del activo. |
| ModelNumber | Cadena | El número de modelo del activo. |
| ModelName | Cadena | Nombre de modelo del activo. |
| ProductSKU | Cadena | La unidad de mantenimiento de stock del activo. |
| PurchaseDate | Cadena | Fecha de compra del activo. |
| UsageEndDate | Cadena | Fecha de finalización del uso del activo. |
| Status | Cadena | Estado del activo. |
| Precio | Cadena | Precio del activo. |
| Cantidad | Cadena | Cantidad del activo. |
| Description (Descripción) | Cadena | Descripción del activo. |
| AdditionalInformation | Cadena | Cualquier información adicional pertinente para el activo. |
| DataSource | Cadena | Origen de datos del activo. |
| Atributos | String-to-string mapa | Par de clave-valor de los atributos de un activo estándar. |
Los objetos de activo estándar se indexan mediante las claves de la tabla siguiente.
| Nombre de índice estándar | Campo de activo estándar |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
Por ejemplo, puedes usarlo `_assetName` como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil que tenga un activo que AssetName coincida con el valor de búsqueda. Para encontrar los objetos de activos estándar asociados a un perfil específico, utilice la [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con el `ProfileId` y `ObjectTypeName` establecido en`_asset`.
# Asignación de objetos de Salesforce al activo estándar en Perfiles de clientes
En este tema se enumeran los campos de los objetos de Salesforce que se asignan a los campos del objeto de activo estándar en Perfiles de clientes.
## Objeto Salesforce-Asset
A continuación, encontrará una lista de todos los campos de un objeto Salesforce-Asset.
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Name
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Status
+ Precio
+ Cantidad
+ Description (Descripción)
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## Asignación de un objeto Salesforce-Asset a un activo estándar
Un subconjunto de los campos de la asignación del objeto Salesforce-Asset al objeto de activo estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Salesforce-Asset al activo estándar.
| Campo de origen de Saleforce-Asset | Campo de destino de activo estándar |
| --- | --- |
| Id | Atributos. sfdcAssetId |
| ContactId | Atributos. sfdcContactId |
| AccountId | Atributos. sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| Status | Status |
| Precio | Precio |
| Cantidad | Cantidad |
| Description (Descripción) | Description (Descripción) |
Los datos de cliente de Salesforce-Asset del objeto de Salesforce se asocian con un perfil estándar de Amazon Connect mediante los índices de la tabla siguiente.
| Nombre de índice estándar | Campo de origen de Salesforce-Asset |
| --- | --- |
| \$1salesforceAssetId | Id |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
Por ejemplo, puedes usar `_salesforceAssetId` y `_salesforceAccountId` `ObjectFilter.KeyName` junto con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un activo estándar. Para encontrar los objetos de Salesforce-Asset asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Salesforce-Asset`
# Asignación de tipo de objeto para el caso estándar en Perfiles de clientes
En los temas de esta sección se proporciona la definición del caso estándar y la asignación de tipo de objeto de las aplicaciones externas al caso estándar.
**Topics**
+ [Requisitos de AppFlow acceso a Amazon](appflow-access-requirements-case.md)
+ [Definición de caso estándar](standard-case-definition.md)
+ [Asignación de objetos de Zendesk](mapping-zendesk-objects-case.md)
+ [Mapeo de ServiceNow objetos](mapping-servicenow-objects-standard-case.md)
# Requisitos de AppFlow acceso a Amazon en los perfiles de los clientes
Utilice los siguientes requisitos de AppFlow acceso a Amazon para crear y eliminar Zendesk y ServiceNow las integraciones con los perfiles de clientes de Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Campos de objetos de casos estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de caso estándar de Perfiles de clientes.
| Campo de caso estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| CaseId | Cadena | Identificador único de un caso estándar. |
| Title | Cadena | Título del caso |
| Resumen | Cadena | Resumen del caso. |
| Status | Cadena | Estado del caso. |
| Motivo | Cadena | Motivo del caso. |
| CreatedBy | Cadena | Creador del caso. |
| CreatedDate | Cadena | Fecha de creación del caso. |
| UpdatedDate | Cadena | Fecha actualizada del caso. |
| ClosedDate | Cadena | Fecha de cierre del caso. |
| AdditionalInformation | Cadena | Cualquier información adicional pertinente para el caso. |
| DataSource | Cadena | Origen de datos del caso. |
| Atributos | String-to-string mapa | Par de clave-valor de los atributos de un caso estándar. |
Los objetos de caso estándar se indexan mediante las claves de la siguiente tabla.
| Nombre de índice estándar | Campo de caso estándar |
| --- | --- |
| \$1caseId | CaseId |
Por ejemplo, puedes usarlo `_caseId` como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil que tenga mayúsculas y minúsculas y que CaseId coincida con el valor de búsqueda. Para encontrar los objetos de mayúsculas y minúsculas estándar asociados a un perfil específico, utilice la [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con el `ProfileId` y `ObjectTypeName` establecido en`_case`.
# Asignación de objetos de Zendesk al caso estándar en Perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los objetos de Zendesk que se asignan a los campos del caso estándar en Perfiles de clientes.
## Objeto Zendesk-tickets
A continuación, se muestra una lista de todos los campos de un objeto Zendesk-tickets.
+ id
+ url
+ type
+ subject
+ raw\$1subject
+ description
+ priority
+ status
+ destinatario
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organization\$1id
+ group\$1id
+ collaborator\$1ids
+ email\$1cc\$1ids
+ follower\$1ids
+ forum\$1topic\$1id
+ problem\$1id
+ has\$1incidents
+ due\$1at
+ etiquetas
+ via.channel
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1ids
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachments
+ is\$1public
+ created\$1at
+ updated\$1at
## Asignación de un objeto Zendesk-tickets a un caso estándar
Un subconjunto de los campos de la asignación del objeto Zendesk-tickets al caso estándar en Perfiles de clientes. En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Zendesk-tickets al caso estándar.
| Campo de origen de Zendesk-tickets | Campo de destino de caso estándar |
| --- | --- |
| requester\$1id | Atributos. ZendeskUserId |
| id | Atributos. ZendeskTicketId |
| subject | Title |
| description | Resumen |
| status | Status |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
Los datos de cliente de Zendesk-tickets del objeto de Zendesk se asocian a un caso estándar de Amazon Connect mediante los siguientes índices.
| Nombre de índice estándar | Campo de origen de Zendesk-tickets |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
Por ejemplo, puedes usar `_zendeskUserId` y `_zendeskTicketId` `ObjectFilter.KeyName` junto con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un caso estándar. Para encontrar los objetos de Zendesk-Tickets asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y `ObjectTypeName` establecido en. `Zendesk-tickets`
# Asignación de ServiceNow objetos al caso estándar en los perfiles de clientes de Amazon Connect
En este tema se enumeran los campos de los ServiceNow objetos que se asignan a campos en el caso estándar de los perfiles de clientes de Amazon Connect.
## Objeto Servicenow-task
A continuación, se muestra una lista de todos los campos de un objeto Servicenow-task.
+ sys\$1id
+ active
+ activity\$1due
+ additional\$1assignee\$1list
+ approval
+ approval\$1history
+ approval\$1set
+ assigned\$1to
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ calendar\$1duration
+ closed\$1at
+ closed\$1by
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ comentarios
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contrato
+ correlation\$1display
+ active
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ description
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impacto
+ knowledge
+ ubicación
+ made\$1sla
+ número
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ estado
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ active
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1worked
+ upon\$1approval
+ upon\$1reject
+ urgency
+ user\$1input
+ watch\$1list
+ work\$1end
+ work\$1notes
+ work\$1notes\$1list
+ work\$1start
## Asignación de Servicenow-task a un caso estándar
Un subconjunto de los campos de la asignación del objeto Servicenow-task al caso estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Servicenow-task al caso estándar.
| Campo de origen de Servicenow-task | Campo de destino de caso estándar |
| --- | --- |
| sys\$1id | Atributos. ServiceNowTaskId |
| opened\$1by.link | Atributos. ServiceNowSystemUserId |
| short\$1description | Title |
| description | Resumen |
| status | Status |
| sys\$1created\$1by | CreatedBy |
| sys\$1created\$1on | CreatedDate |
| sys\$1updated\$1on | UpdatedDate |
Los datos de cliente de Servicenow-task de Servicenow se asocian a un caso estándar de Amazon Connect mediante los índices de la siguiente tabla.
| Nombre de índice estándar | Campo de origen de Servicenow-task |
| --- | --- |
| \$1 serviceNowTask Identificación | sys\$1id |
| \$1 serviceNowSystem ID | open\$1by.link |
Por ejemplo, puedes usar `_serviceNowTaskId` y `_serviceNowSystemId` `ObjectFilter.KeyName` junto con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un caso estándar. Para encontrar los objetos ServiceNow-Task asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y establecido en. `ObjectTypeName` `Servicenow-task`
## Objeto Servicenow-incident
A continuación, se muestra una lista de todos los campos de un objeto Servicenow-incident.
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ categoría
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severity
+ subcategory
## Asignación de Servicenow-incident a un caso estándar
Un subconjunto de los campos de la asignación del objeto Servicenow-incident al caso estándar en Perfiles de clientes.
En la tabla siguiente se enumeran los campos que se pueden asignar del objeto Servicenow-incident al caso estándar.
| Campo de origen de Servicenow-Incident | Campo de destino de caso estándar |
| --- | --- |
| sys\$1id | Atributos\$1 ServiceNowIncidentId |
| caller\$1id.link | Atributos\$1 ServiceNowSystemUserId |
| incident\$1status | Status |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| categoría | Motivo |
Los datos de cliente de Servicenow-incident del objeto de Servicenow se asocian a un caso estándar de Amazon Connect mediante los índices de la siguiente tabla.
| Nombre de índice estándar | Campo de origen de Servicenow |
| --- | --- |
| \$1 ID serviceNowIncident | sys\$1id |
| \$1 serviceNowSystem ID | caller\$1id.link |
Por ejemplo, puede usar `_serviceNowIncidentId` y `_serviceNowSystemId` como ObjectFilter. KeyName con la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API para encontrar un caso estándar. Para encontrar los objetos de ServiceNow-Incident asociados a un perfil específico, utilice la [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con el `ProfileId` y establecido en. `ObjectTypeName` `Servicenow-incident`
# Asignación de tipo de objeto para la preferencia aérea estándar
En los temas de esta sección se define el concepto de preferencia aérea estándar.
**Topics**
+ [
# Campos de objeto de preferencia aérea estándar de Perfiles de clientes
](standard-air-preference-object-fields.md)
# Campos de objeto de preferencia aérea estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de preferencia aérea estándar de Perfiles de clientes.
**Preferencia aérea**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| PreferenceId | Cadena | Es el identificador único de una preferencia aérea estándar. |
| Name | Cadena | Nombre de la preferencia |
| CreatedDate | Cadena | Es la fecha en la que se creó la preferencia. |
| CreatedBy | Cadena | Es el identificador del creador. |
| UpdatedDate | Cadena | Es la fecha de la última actualización. |
| UpdatedBy | Cadena | Es el identificador de la persona que actualizó por última vez. |
| StartDate | Cadena | Es la fecha de inicio de la preferencia. |
| EndDate | Cadena | Es la fecha de fin de la preferencia. |
| Status | Cadena | Es el estado actual de la preferencia. |
| ReferenceId | Cadena | Es el ID del objeto al que se hace referencia. |
| ReferenceType | Cadena | Es el tipo de objeto al que se hace referencia. |
| TravelType | Cadena | Es el tipo de viaje (por ejemplo, vuelos directos). |
| Transferir | Cadena | Es el tipo de traslado preferido. |
| ArrivalAirport | Cadena | Es el aeropuerto de llegada preferido. |
| ArrivalTerminal | Cadena | Es la terminal de llegada preferida. |
| DepartureAirport | Cadena | Es el aeropuerto de salida preferido. |
| DepartureTerminal | Cadena | Es la terminal preferida del aeropuerto de salida. |
| HomeAirport | Cadena | Es el aeropuerto de origen. |
| CheckInChannel | Cadena | Es el modo de facturación. |
| CheckInChannelDevice | Cadena | Es el dispositivo utilizado para facturar. |
| Idioma | Idioma | Información sobre los idiomas preferidos para la comunicación. |
| Seat | Seat | Información sobre la selección de asientos. |
| Journey | Journey | Preferencias de viaje |
| Accesibilidad | Accesibilidad | Información sobre las solicitudes de accesibilidad |
| Seguros | Seguros | Información sobre el seguro |
| Interest | Interest | Detalles sobre los intereses |
| Loyalty | Loyalty | Información sobre la fidelización |
| Comedor | Comedor | Preferencias de comida |
| MediaEntertainment | MediaEntertainment | Preferencias de entretenimiento |
| PaymentForm | PaymentForm | Preferencias de método de pago |
| PetInfo | PetInfo | Información sobre la mascota |
| SpecialRequest | SpecialRequest | Detalles de la solicitud especial |
| TicketDistribution | TicketDistribution | Preferencias de distribución de billetes |
| Marketing | Marketing | Preferencias de marketing |
| Medical | Medical | Preferencias médicas |
| Baggage | Baggage | Preferencias sobre equipaje |
| ContactDetail | ContactDetail | Detalles sobre el contacto preferente |
| ContactDetailAddress | ContactDetailAddress | Dirección de los datos de contacto |
| ContactDetailCommunication | ContactDetailCommunication | Preferencias de comunicación |
| Atributos | Mapa | Par de clave-valor de una preferencia aérea |
Los objetos de la preferencia aérea estándar se indexan mediante las claves de la siguiente tabla.
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
Por ejemplo, puedes utilizarlos `_airPreferenceId` como nombre clave en la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil que tenga una preferencia aérea que PreferenceId coincida con el valor de búsqueda. Para encontrar los objetos AirPreference estándar asociados a un perfil específico, utilice la [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con el `ProfileId` y `ObjectTypeName` establecido en. `_airPreference`
**ContactDetail tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de contacto (por ejemplo, personal, de emergencia) |
| PreferenceLevel | Cadena | Nivel de prioridad de este contacto |
| PhoneNumber | Cadena | Número de teléfono |
| Relación | Cadena | Relación con el perfil |
| EmailAddress | Cadena | Dirección de correo electrónico |
| EmailLanguage | Cadena | Idioma preferido para la comunicación por correo electrónico en los detalles de contacto |
| PhoneLanguage | Cadena | Idioma preferido para la comunicación por teléfono en los detalles de contacto |
**ContactDetailAddress tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de dirección para el contacto |
| Address1 | Cadena | Primera línea de la dirección de contacto |
| Address2 | Cadena | Segunda línea de la dirección de contacto |
| Address3 | Cadena | Tercera línea de la dirección de contacto |
| Address4 | Cadena | Cuarta línea de la dirección de contacto |
| Ciudad | Cadena | Ciudad de la dirección de contacto |
| País | Cadena | País de la dirección de contacto |
| County | Cadena | Condado de la dirección de contacto |
| PostalCode | Cadena | Código postal de la dirección de contacto |
| Province | Cadena | Provincia de la dirección de contacto |
| Estado | Cadena | Estado de la dirección de contacto |
**ContactDetailCommunication tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Método | Cadena | Método de comunicación (por ejemplo, SMS o correo electrónico) |
| PreferenceLevel | Cadena | Nivel de preferencia por método de comunicación |
**Tipo de datos de idioma**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| PhoneLanguage | Cadena | Idioma preferido para la comunicación telefónica |
| EmailLanguage | Cadena | Idioma preferido para la comunicación por correo electrónico |
| InPersonLanguage | Cadena | Idioma preferido para la comunicación en persona |
| PreferenceLevel | Cadena | Nivel de preferencia de idioma |
**Tipo de datos de asiento**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| PreferenceLevel | Cadena | Prioridad de la preferencia de asiento |
| Dirección | Cadena | Dirección preferida del asiento (por ejemplo, delantero o trasero) |
| Ubicación | Cadena | Ubicación preferida del asiento (por ejemplo, ventanilla o pasillo) |
| Posición | Cadena | Posición del asiento (por ejemplo, izquierda o derecha) |
| Fila | Cadena | Fila de asientos deseada |
| ClassOfService | Cadena | Clase de viaje (por ejemplo, turista, business) |
| NeighborFree | Cadena | Preferencia por un asiento sin vecinos |
| Infant | Cadena | Preferencia por asiento para bebés |
| ExtraSeat | Cadena | Preferencia por un asiento adicional |
**Tipo de datos de viaje**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| MaxConnections | Cadena | Número máximo de conexiones permitido |
| PreferredAirline | Cadena | Aerolínea preferida |
| UpgradeAuction | Cadena | Suscripción a subastas de mejora |
| FlightTime | Cadena | Hora de vuelo preferida |
| FlightMaxDuration | Cadena | Duración máxima del viaje preferida |
**Tipo de datos de accesibilidad**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Wheelchair | Cadena | Información de accesibilidad para sillas de ruedas |
| Baño | Cadena | Información de accesibilidad del baño |
| Assistance | Cadena | Información de asistencia |
| DisabilityType | Cadena | Información sobre discapacidad |
| SupportAnimal | Cadena | Información sobre animales de asistencia |
| ProximityToFacilities | Cadena | Necesita estar cerca de las instalaciones |
**Tipo de datos de seguros**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre del plan o proveedor de seguros |
| PreferenceLevel | Cadena | Nivel de preferencia en materia de seguros |
**Tipo de datos de interés**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Área de interés específica |
| PreferenceLevel | Cadena | Prioridad de este interés |
**Tipo de datos de fidelización**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre del programa de fidelización |
| MembershipId | Cadena | ID de membresía del programa de fidelización |
| PreferenceLevel | Cadena | Nivel de preferencia del programa de fidelización |
**Tipo de datos de comidas**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| MealType | Cadena | Tipo de comida preferido |
| FavoriteCuisine | Cadena | Tipos de cocina favoritos |
| Beverage | Cadena | Bebidas preferidas |
| DietaryRestriction | Cadena | Restricciones dietéticas |
| AllergyInfo | Cadena | Información sobre alergias |
| PreferenceLevel | Cadena | Nivel de preferencia de comidas |
**Tipo de datos de entretenimiento**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre del entretenimiento preferido |
| PreferenceLevel | Cadena | Nivel de preferencia del entretenimiento |
**PaymentForm tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre del método de pago |
| Tipo | Cadena | Tipo de pago (p. ej., tarjeta de crédito PayPal) |
| PreferenceLevel | Cadena | Nivel de preferencia del método de pago |
| UsageContext | Cadena | Dónde se utiliza el método de pago |
**PetInfo tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de mascota |
| PreferenceLevel | Cadena | Nivel de preferencia con respecto a las mascotas |
**SpecialRequest tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de solicitud especial |
| Name | Cadena | Nombre o descripción de la solicitud |
| PreferenceLevel | Cadena | Nivel de prioridad de la solicitud |
**TicketDistribution tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| PreferenceLevel | Cadena | Nivel de preferencia para la distribución de los billetes |
| Método | Cadena | Método de entrega de los billetes (por ejemplo, correo electrónico o en papel) |
| TicketTime | Cadena | Hora preferida para la entrega de los billetes |
**Tipo de datos de marketing**
| Campo airPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| ChannelType | Cadena | Tipo de canal de marketing (por ejemplo, SMS o correo electrónico) |
| OptIn | Cadena | Estado de la inscripción para comunicaciones de marketing |
| Frecuencia | Cadena | Frecuencia de las comunicaciones de marketing |
| StartDate | Cadena | Fecha de inicio de la preferencia de marketing |
| EndDate | Cadena | Fecha de finalización de la preferencia de marketing |
**Tipo de datos médicos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Oxygen | Cadena | (Suministrado por la aerolínea, propiedad del pasajero, concentrador, etc.) |
| MedicalEquipment | Cadena | Información sobre el material médico (por ejemplo, máquina CPAP o concentrador de oxígeno) |
| Assistance | Cadena | Especifica si el viajero necesita asistencia médica general durante el viaje (por ejemplo, asistencia durante el vuelo o ayuda con los medicamentos). |
| Stretcher | Cadena | Indica si el viajero necesita una camilla durante el vuelo. Se suele utilizar para casos de transporte médico. |
| WheelChair | Cadena | Detalles de la silla de ruedas (no derramable, celda húmeda, inmóvil, asistencia de escaleras RampNeeded, compañía aérea proporcionada, etc.) |
**Tipo de datos de equipaje**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Animal | Cadena | Indica si el viajero viaja con un animal de asistencia o una mascota e incluye las especificaciones o restricciones pertinentes (en la falda, en cabina) |
| BaggageType | Cadena | Especifica el tipo de manejo de equipaje preferido (por ejemplo, solo equipaje de mano, equipaje facturado o de grandes dimensiones) |
| Assistance | Cadena | Indica si el viajero necesita ayuda para transportar o manipular el equipaje, por ejemplo, servicios de maleteros del aeropuerto o ayuda con el equipaje en la acera. |
| PreferenceLevel | Cadena | Nivel de preferencia para los campos de equipaje |
# Asignación de tipo de objeto para la preferencia de hotel estándar
En los temas de esta sección se define el concepto de preferencia de hotel estándar.
**Topics**
+ [
# Campos de objeto de preferencia de hotel estándar de Perfiles de clientes
](standard-hotel-preference-object-fields.md)
# Campos de objeto de preferencia de hotel estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de preferencia de hotel estándar de Perfiles de clientes.
**Preferencia de hotel**
| Campo hotelPreference estándar | Tipo de datos: | Descripción |
| --- | --- | --- |
| PreferenceId | Cadena | Identificador único de una preferencia de hotel estándar |
| Name | Cadena | Nombre de la preferencia |
| CreatedDate | Cadena | Fecha en que se creó la preferencia |
| CreatedBy | Cadena | Es el identificador del creador. |
| UpdatedDate | Cadena | Es la fecha de la última actualización. |
| UpdatedBy | Cadena | Es el identificador de la persona que actualizó por última vez. |
| StartDate | Cadena | Es la fecha de inicio de la preferencia. |
| EndDate | Cadena | Es la fecha de fin de la preferencia. |
| Status | Cadena | Es el estado actual de la preferencia. |
| Fumar | Cadena | Preferencia fumadores |
| CleaningTime | Cadena | Hora de limpieza |
| CheckInType | Cadena | Tipo de facturación |
| CheckOutType | Cadena | Tipo de salida |
| ReferenceId | Cadena | Es el ID del objeto al que se hace referencia. |
| ReferenceType | Cadena | Es el tipo de objeto al que se hace referencia. |
| Ubicación | Ubicación | Preferencias sobre la ubicación de la habitación de hotel |
| Bedding | Bedding | Preferencias sobre la ropa de cama |
| Tour | Tour | Preferencias sobre tours |
| ContactDetail | ContactDetail | Detalles sobre el contacto preferente |
| ContactDetailAddress | ContactDetailAddress | Dirección de los datos de contacto |
| ContactDetailCommunication | ContactDetailCommunication | Preferencias de comunicación |
| Idioma | Idioma | Preferencias de idioma |
| CarRental | CarRental | Preferencias de alquiler de automóviles |
| Accesibilidad | Accesibilidad | Preferencias de accesibilidad |
| Interest | Interest | Información sobre intereses |
| Loyalty | Loyalty | Preferencias sobre fidelización |
| Comedor | Comedor | Preferencias de comida |
| MediaEntertainment | MediaEntertainment | Preferencias de entretenimiento |
| PaymentForm | PaymentForm | Preferencias sobre el método de pago |
| PetInfo | PetInfo | Preferencias de información sobre mascotas |
| SpecialRequest | SpecialRequest | Detalles sobre solicitudes especiales |
| Marketing | Marketing | Preferencias de marketing |
| Medical | Medical | Preferencias médicas |
| Baggage | Baggage | Preferencias de equipaje |
| Atributos | Mapa | Par de clave-valor de los atributos de una preferencia de hotel |
Los objetos de la preferencia de hotel estándar se indexan mediante las claves de la siguiente tabla.
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
Por ejemplo, puedes usarlo `_hotelPreferenceId` como nombre clave con la [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) para buscar un perfil que tenga una preferencia de hotel que coincida con el valor de búsqueda. PreferenceId Para encontrar los objetos HotelPreference estándar asociados a un perfil específico, utilice la [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con el `ProfileId` y `ObjectTypeName` establecido en. `_hotelPreference`
**ContactDetail tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de contacto (por ejemplo, personal, de emergencia) |
| PreferenceLevel | Cadena | Nivel de prioridad de este contacto |
| PhoneNumber | Cadena | Número de teléfono |
| Relación | Cadena | Relación con el perfil |
| EmailAddress | Cadena | Dirección de correo electrónico |
| EmailLanguage | Cadena | Idioma preferido para la comunicación por correo electrónico en los detalles de contacto |
| PhoneLanguage | Cadena | Idioma preferido para la comunicación por teléfono en los detalles de contacto |
**ContactDetailAddress tipo de datos**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de dirección para el contacto |
| Address1 | Cadena | Primera línea de la dirección de contacto |
| Address2 | Cadena | Segunda línea de la dirección de contacto |
| Address3 | Cadena | Tercera línea de la dirección de contacto |
| Address4 | Cadena | Cuarta línea de la dirección de contacto |
| Ciudad | Cadena | Ciudad de la dirección de contacto |
| País | Cadena | País de la dirección de contacto |
| County | Cadena | Condado de la dirección de contacto |
| PostalCode | Cadena | Código postal de la dirección de contacto |
| Province | Cadena | Provincia de la dirección de contacto |
| Estado | Cadena | Estado de la dirección de contacto |
**ContactDetailCommunication tipo de datos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Método | Cadena | Método de comunicación |
| PreferenceLevel | Cadena | Nivel de preferencia del método de comunicación |
| Frecuencia | Cadena | Frecuencia de la comunicación |
**Tipo de datos de idioma**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| PhoneLanguage | Cadena | Idioma de preferencia para el teléfono |
| EmailLanguage | Cadena | Idioma de preferencia para el correo electrónico |
**CarRental tipo de datos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Proveedor | Cadena | Proveedor de vehículos de alquiler preferido |
| VehicleType | Cadena | Tipo de vehículo preferido |
| PreferenceLevel | Cadena | Nivel de preferencia para el alquiler de vehículos |
**Tipo de datos de ubicación**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| PreferredFloor | Cadena | Preferencia por la planta de la habitación |
| ElevatorProximity | Cadena | Preferencia por la proximidad a los ascensores |
| QuietZone | Cadena | Preferencia por zona tranquila |
| LobbyProximity | Cadena | Preferencia por proximidad al vestíbulo |
| Visualización | Cadena | Vista deseada desde la habitación |
| RoomType | Cadena | Tipo de habitación preferida |
| PreferenceLevel | Cadena | Nivel de preferencia de la ubicación |
**Tipo de datos de ropa de cama**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| BedType | Cadena | Tipo de habitación preferido |
| MattressType | Cadena | Tipo de colchón preferido |
| PillowType | Cadena | Tipo de almohada preferido |
| NumberOfPillows | Cadena | Número de almohadas preferido |
| BeddingMaterial | Cadena | Tejido de la ropa de cama |
| Allergy | Cadena | Preferencias de ropa de cama relacionadas con alergias |
**Tipo de datos del tour**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Ciudad | Cadena | Ciudades preferidas para las visitas |
| Cultural | Cadena | Intereses por visitas culturales |
| Adventure | Cadena | Intereses por visitas de aventura |
| Nightlife | Cadena | Intereses por visitas de vida nocturna |
| GuideLanguage | Cadena | Idioma preferido del guía turístico |
| StartTime | Cadena | Hora de inicio preferida para las visitas |
| GroupSize | Cadena | Tamaño preferido del grupo para las visitas |
| PreferenceLevel | Cadena | Importancia de las preferencias de las visitas |
**Tipo de datos de accesibilidad**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Wheelchair | Cadena | Información de accesibilidad para sillas de ruedas |
| Baño | Cadena | Información de accesibilidad del baño |
| Assistance | Cadena | Información de asistencia |
| DisabilityType | Cadena | Información sobre discapacidad |
| SupportAnimal | Cadena | Información sobre animales de asistencia |
| ProximityToFacilities | Cadena | Necesita estar cerca de las instalaciones |
**Tipo de datos de interés**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| NameOfInterest | Cadena | Nombre del interés |
| PreferenceLevel | Cadena | Nivel de preferencia del interés |
**Tipo de datos de fidelización**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| LoyaltyName | Cadena | Nombre del programa de fidelización |
| MembershipId | Cadena | ID de membresía a programa de fidelización |
| PreferenceLevel | Cadena | Nivel de preferencia de fidelización |
| PriorityServices | Cadena | Preferencia de servicios de prioridad |
**Tipo de datos de comidas**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| MealType | Cadena | Tipos de comida preferidos |
| FavoriteCuisine | Cadena | Preferencias de cocina favoritas |
| Beverage | Cadena | Preferencias de bebidas |
| DietaryRestriction | Cadena | Restricciones dietéticas |
| AllergyInfo | Cadena | Información sobre alergias |
| PreferenceLevel | Cadena | Nivel de preferencia de comidas |
**MediaEntertainment tipo de datos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre del entretenimiento preferido |
| PreferenceLevel | Cadena | Nivel de preferencia del entretenimiento |
**PaymentForm tipo de datos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre asociado al método de pago |
| Tipo | Cadena | Tipo de método de pago |
| PreferenceLevel | Cadena | Nivel de preferencia del método de pago |
| UsageContext | Cadena | Contexto en el que se utiliza el formulario de pago |
**PetInfo tipo de datos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de mascota |
| PreferenceLevel | Cadena | Nivel de preferencia para mascota |
**Tipo de datos de solicitud especial**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de solicitud especial |
| Name | Cadena | Nombre de la solicitud especial |
| PreferenceLevel | Cadena | Nivel de preferencia de la solicitud |
**Tipo de datos de marketing**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ChannelType | Cadena | Tipo de canal de marketing (por ejemplo, SMS o correo electrónico) |
| OptIn | Cadena | Estado de la inscripción para comunicaciones de marketing |
| Frecuencia | Cadena | Frecuencia de las comunicaciones de marketing |
| StartDate | Cadena | Fecha de inicio de la preferencia de marketing |
| EndDate | Cadena | Fecha de finalización de la preferencia de marketing |
**Tipo de datos médicos**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Oxygen | Cadena | Preferencias de suministro de oxígeno |
| MedicalEquipment | Cadena | Detalles sobre el equipo médico |
| Assistance | Cadena | Tipo de asistencia médica requerida |
| Stretcher | Cadena | Requisito de camilla |
| WheelChair | Cadena | Tipo de silla de ruedas y asistencia necesaria |
**Tipo de datos de equipaje**
| Campo hotelPreference estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Bicycle | Cadena | Necesidades relacionadas con el equipaje de bicicleta |
| BaggageType | Cadena | Detalles del equipaje (por ejemplo, equipaje voluminoso) |
| Courier | Cadena | Preferencia de equipaje relacionada con el servicio de mensajería |
| Fragile | Cadena | Preferencias sobre objetos frágiles |
| Intervalo de preferencia | Cadena | Nivel de preferencia de equipaje |
# Asignación de tipo de objeto para la reserva aérea estándar
En los temas de esta sección se define el concepto de reserva aérea estándar.
**Topics**
+ [
# Campos de objetos de reserva aérea estándar de Perfiles de clientes
](standard-air-booking-object-fields.md)
# Campos de objetos de reserva aérea estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de reserva aérea estándar de Perfiles de clientes.
**AirBooking**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| BookingId | Cadena | Identificador único de la reserva aérea estándar |
| ContextId | Cadena | Identificador específico del contexto para rastrear el origen de las reservas |
| PreferenceRef | Cadena | Identificador que hace referencia al objeto de preferencia de la reserva |
| BookingName | Cadena | Nombre asociado a la reserva |
| PassengerIndex | Cadena | Índice del pasajero incluido en la reserva |
| TravellerId | Cadena | Identificador único del viajero asociado a la reserva |
| GroupBooking | Cadena | Indica si la reserva es para un grupo |
| NumberOfPassengers | Cadena | Número total de pasajeros de la reserva |
| NumberOfAdults | Cadena | Número total de adultos de la reserva |
| NumberOfChildren | Cadena | Número total de niños de la reserva |
| ProcessedDate | Cadena | Fecha en que se procesó la reserva |
| CreatedDate | Cadena | Fecha en que se creó la reserva |
| CreatedBy | Cadena | Identidad del creador |
| UpdatedDate | Cadena | Fecha de la última actualización |
| UpdatedBy | Cadena | Identificador de la persona que actualizó por última vez |
| Status | Cadena | Estado de la reserva actual |
| PriorityStatus | Cadena | Nivel de prioridad de la reserva |
| ReservationStatus | Cadena | Estado de la reserva |
| MarketingCode | Cadena | Código que representa el origen o la campaña de marketing |
| MarketingName | Cadena | Nombre de la campaña de marketing |
| TravelAgent | Cadena | Agente de viajes asociado a la reserva |
| TravelAgency | Cadena | Nombre de la agencia de viajes corporativa |
| TravelCorpNumber | Cadena | Número de cliente de empresa |
| Booker | Cadena | Indica si la persona es la que ha realizado la reserva |
| AdditionalInformation | Cadena | Información adicional de formato libre |
| Correo electrónico | Cadena | Correo electrónico de contacto para recibir actualizaciones sobre el día del viaje |
| PhoneNumber | Cadena | Teléfono de contacto para recibir actualizaciones sobre el día del viaje |
| CancelledDate | Cadena | Fecha de cancelación de la reserva (si corresponde) |
| Diplomat | Cadena | Indica el estado diplomático |
| Secundario | Cadena | Indica si el pasajero es un menor |
| Deshabilitado | Cadena | Indica el estado de discapacidad |
| Oxygen | Cadena | Indica la necesidad de oxígeno |
| PetOnly | Cadena | La reserva es solo para el transporte de mascotas |
| CancellationCharge | Cadena | Cargo de cancelación si corresponde. 0 significaría ningún cargo |
| Refundable | Cadena | Datos sobre el reembolso de la reserva |
| Inventario de | Inventario | Datos del inventario para la reserva |
| Loyalty | Loyalty | Datos de fidelización de la reserva |
| Canal | Canal | Datos del canal de la reserva |
| Pago | Pago | Datos de pago de la reserva |
| BillingAddress | Dirección | Datos de la dirección de facturación para la reserva |
| Precio | Precio | Datos del precio de la reserva |
| PaymentStatus | PaymentStatus | Estado del pago de la reserva |
| Atributos | Mapa | Atributos personalizados o de extensión |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**Tipo de datos de fidelización**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ProgramName | Cadena | Nombre del programa de fidelización |
| MembershipId | Cadena | Número de membresía del programa de fidelización |
| Nivel | Cadena | Nivel de membresía del programa de fidelización |
**Tipo de datos de Channel**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| CreationChannelId | Cadena | ID del canal utilizado para crear la reserva |
| LastUpdatedChannelId | Cadena | ID del canal utilizado para actualizar la reserva |
| Método | Cadena | Método utilizado a través del canal (por ejemplo, web, aplicación, teléfono) |
**Tipo de datos de pago**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de método de pago (por ejemplo, tarjeta o vale) |
| CreditCardToken | Cadena | Tarjeta de tokenización para disponer de una referencia segura |
| CreditCardType | Cadena | Tipo de tarjeta de crédito utilizada |
| CreditCardExpiration | Cadena | Fecha de caducidad de la tarjeta |
| Cvv | Cadena | Número CVV |
| NameOnCreditCard | Cadena | Nombre del titular de la tarjeta |
| RoutingNumber | Cadena | Número de ruta bancaria (si corresponde) |
| AccountNumber | Cadena | Número de cuenta bancaria (si corresponde) |
| VoucherId | Cadena | Cupón que se utiliza para pagar |
| DiscountCode | Cadena | Código de descuento promocional aplicado |
| DiscountPercent | Cadena | Porcentaje de descuento aplicado al pago |
**Tipo de datos de dirección de facturación**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Address1 | Cadena | La primera línea de una dirección de cliente. |
| Address2 | Cadena | La segunda línea de una dirección de cliente. |
| Address3 | Cadena | La tercera línea de una dirección de cliente. |
| Address4 | Cadena | La cuarta línea de una dirección de cliente. |
| Ciudad | Cadena | Ciudad de la dirección del cliente. |
| País | Cadena | País de la dirección del cliente. |
| County | Cadena | Condado de la dirección del cliente. |
| PostalCode | Cadena | El código postal de la dirección del cliente. |
| Province | Cadena | Provincia de la dirección del cliente. |
| Estado | Cadena | Estado de la dirección del cliente. |
**Tipo de datos de precios**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| TotalPrice | Cadena | Precio total de la reserva |
| BasePrice | Cadena | Precio básico de la reserva |
| TravellerPrice | Cadena | Precio pagado por la persona que viaja |
| DiscountAmount | Cadena | Descuento que se aplica a la tarifa base |
| Currency (Divisa) | Cadena | Moneda en la que se ha pagado |
**Tipo de datos sobre el estado del pago**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| PaidAt | Cadena | Marca temporal en la que se ha completado el pago |
| AwaitingPayment | Cadena | Indica que el pago está pendiente |
| RequiredBy | Cadena | Fecha de vencimiento del pago |
**Tipo de datos de inventario**
| Campo airBooking estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Asientos | Cadena | Número total de asientos de la reserva |
# Asignación de tipo de objeto para el segmento aéreo estándar
En los temas de esta sección se define el concepto de segmento aéreo estándar.
**Topics**
+ [
# Campos de objetos de segmento aéreo estándar de Perfiles de clientes
](standard-air-segment-object-fields.md)
# Campos de objetos de segmento aéreo estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de segmento aéreo estándar de Perfiles de clientes.
**Segmento aéreo**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| SegmentId | Cadena | Identificador único del segmento aéreo estándar |
| BookingRef | Cadena | Identificador de la referencia de la reserva |
| SegmentName | Cadena | Nombre o descripción del segmento |
| PassengerIndex | Cadena | Número del índice del pasajero |
| SegmentIndex | Cadena | Número del índice del segmento |
| SeatSelection | Cadena | Información sobre la selección de asientos |
| NumberOfPassengers | Cadena | Número total de pasajeros |
| NumberOfLegs | Cadena | Número de etapas del vuelo |
| Nivel | Cadena | tier/status Nivel de pasajeros |
| Origen | Cadena | Código del aeropuerto de salida |
| OriginCountryCode | Cadena | Código del país de salida |
| Dest | Cadena | Código del aeropuerto de destino |
| DestCountryCode | Cadena | Código del país de destino |
| ProcessedDate | Cadena | Fecha de procesamiento del segmento |
| CreatedDate | Cadena | Fecha de creación del registro |
| CreatedBy | Cadena | Usuario que ha creado el registro |
| UpdatedDate | Cadena | Fecha de la última actualización del registro |
| UpdatedBy | Cadena | Usuario que actualizó el registro por última vez |
| Status | Cadena | Estado actual del segmento |
| FlightNumber | Cadena | Número de vuelo |
| Carrier | Cadena | Código del operador |
| CarrierType | Cadena | Tipo de operador |
| IsInternational | Cadena | Indica si el vuelo es internacional |
| IsEticket | Cadena | Indica si es un billete electrónico |
| IsArmed | Cadena | Indica si el pasajero está armado |
| LapInfant | Cadena | Información sobre bebés en el regazo |
| Pet | Cadena | Indica si se viaja con mascota |
| PrisonerOrGuard | Cadena | Indica si viaja un preso o guardia |
| Secundario | Cadena | Indica si el pasajero es un menor |
| Married | Cadena | Indica si los segmentos están casados |
| CheckinEligible | Cadena | Indica los requisitos para facturar |
| InEligibleReason | Cadena | Motivo por el que no es elegible para facturación |
| UnEscortedMinor | Cadena | Indica que se trata de menor no acompañado |
| PremiumAccess | Cadena | Indica que es una compra con acceso premium |
| MissingData | Cadena | Indica que faltan datos |
| CurrentClassOfService | Cadena | Clase de servicio actual |
| BookedClassOfService | Cadena | Clase de servicio reservada originalmente |
| CodeShare | Cadena | Indica que es un vuelo con código compartido |
| ReverseCodeShare | Cadena | Indica que se ha revertido el código compartido |
| MarketCarrierCode | Cadena | Código de operador de marketing |
| OpCarrierCode | Cadena | Código del operador |
| InConnection | Cadena | Información sobre la conexión entrante |
| OutConnection | Cadena | Información sobre la conexión saliente |
| MilesToEarn | Cadena | Millas que se pueden acumular |
| Duración | Cadena | Duración del vuelo |
| DurationTimeUnit | Cadena | Unidad de tiempo de duración |
| Distancia | Cadena | Distancia del vuelo |
| DistanceUnit | Cadena | Unidad de medición de distancia |
| SellType | Cadena | Indica si se trata de una venta forzosa |
| GoShow | Cadena | Indica si se trata de un pasajero que quiere embarcar en un vuelo anterior |
| Incapacitated | Cadena | Indica si el pasajero está incapacitado |
| Upgraded | Cadena | Indica si se ha mejorado el vuelo |
| Downgraded | Cadena | Indica si se ha rebajado el vuelo |
| BaggageInsurance | Cadena | Seguro de equipaje |
| MaxAllowedBaggage | Cadena | Número máximo de maletas permitido |
| BaggageQuantity | Cadena | Número de maletas |
| BaggageFee | Cadena | Tasa total de equipaje |
| Arrival | Puerto | Información de llegada del segmento |
| Departure | Puerto | Información de salida del segmento |
| Seat | Seat | Información del asiento |
| Priority (Prioridad) | Priority (Prioridad) | Información sobre prioridad |
| Doc | Doc | Información del documento adjunto para viajar |
| Baggage | Lista de equipaje | Información sobre el equipaje |
| Pets | Lista de mascotas | Información sobre la mascota |
| OtherServices | OtherService Lista | Información sobre otros servicios |
| Atributos | Mapa | Atributos adicionales |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**Tipo de datos de equipaje**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Id | Cadena | Identificador de equipaje |
| TagNumber | Cadena | Número de etiqueta de equipaje |
| DepartureDate | Cadena | Fecha de salida |
| BaggageType | Cadena | Tipo de equipaje |
| Peso | Cadena | Peso del equipaje |
| Longitud | Cadena | Longitud del equipaje |
| Ancho | Cadena | Ancho del equipaje |
| Alto | Cadena | Peso del equipaje |
| PriorityBagDrop | Cadena | Servicio de entrega prioritaria de equipaje |
| PriorityBagReturn | Cadena | Servicio de devolución prioritaria de equipaje |
| HandsFreeBaggage | Cadena | Servicio de equipaje manos libres |
| Cuota | Cadena | Tarifa de equipaje |
| IsGateBag | Cadena | Indica que es equipaje facturado en la puerta |
| IsHeavy | Cadena | Indica que es equipaje pesado |
**Tipo de datos de asiento**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| SeatNumber | Cadena | Número de asiento |
| SeatZone | Cadena | Zona del asiento |
| SeatType | Cadena | Tipo de asiento |
| Precio | Cadena | Precio del asiento |
| NeighborFree | Cadena | Indica si el asiento de al lado está libre |
| UpgradeAuction | Cadena | Indica que hay posibilidad de participar en subasta de mejora |
| Disponible | Cadena | Indica la disponibilidad de asientos |
| ExtraSeat | Cadena | Indica que hay un asiento adicional |
| AdditionalInformation | Cadena | Información de asiento adicional |
**Tipo de datos de puerto**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Ubicación | Cadena | Nombre de la ubicación |
| Código | Cadena | Código del aeropuerto |
| Terminal | Cadena | Terminal del aeropuerto |
| País | Cadena | País del aeropuerto |
| Date | Cadena | Date |
| Time | Cadena | Time |
| EstimatedTime | Cadena | Tiempo estimado |
| ScheduledTime | Cadena | Hora programada |
**Tipo de datos de prioridad**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| TransactionId | Cadena | Identificador de la transacción |
| PriorityServiceType | Cadena | Tipo de servicio prioritario |
| LoungeAccess | Cadena | Indica que tiene acceso a la sala |
| Precio | Cadena | Precio del servicio prioritario |
| AdditionalInformation | Cadena | Información adicional sobre prioridad |
**Tipo de datos sobre mascotas**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Species | Cadena | Especie de mascota |
| Breed | Cadena | Raza de la mascota |
| Peso | Cadena | Peso de la mascota |
| WeightUnit | Cadena | Unidad de peso de medida |
| TransportType | Cadena | Tipo de transporte de mascotas |
**OtherService tipo de datos**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ServiceType | Cadena | Tipo de servicio |
| Description (Descripción) | Cadena | Descripción del servicio |
| Precio | Cadena | Precio del servicio |
**Tipo de datos del documento**
| Campo airSegment estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| DocType | Cadena | Tipo de documento |
| DocTypeNeeded | Cadena | Indica si se requiere el documento |
| Nationality | Cadena | Nacionalidad en el documento |
| DateOfBirth | Cadena | Fecha de nacimiento |
| AppId | Cadena | Identificador de la aplicación |
| AgentId | Cadena | Identificador de agente |
| VerifiedDateTime | Cadena | Hora de verificación de los documentos |
# Asignación de tipo de objeto para la reserva de hotel estándar
En los temas de esta sección se define el concepto de reserva de hotel estándar.
**Topics**
+ [
# Campos de objeto de reserva de hotel estándar de Perfiles de clientes
](standard-hotel-reservation-object-fields.md)
# Campos de objeto de reserva de hotel estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de reserva de hotel estándar de Perfiles de clientes.
**Reserva de hotel**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ReservationId | Cadena | Identificador único de la reserva de hotel estándar |
| ConfirmationNumber | Cadena | Número de confirmación proporcionado por el hotel o el motor de reservas |
| PreferenceRef | Cadena | Identificador que hace referencia al objeto de preferencia de la reserva |
| Status | Cadena | Estado actual de la reserva (por ejemplo, confirmada o cancelada) |
| TripType | Cadena | Propósito o naturaleza del viaje (por ejemplo, placer o negocios) |
| BrandCode | Cadena | Código que representa la marca del hotel |
| HotelCode | Cadena | Código que identifica el hotel en concreto |
| PhoneNumber | Cadena | Número de teléfono de contacto para la reserva |
| EmailAddress | Cadena | Dirección de correo electrónico de contacto para la reserva |
| GroupId | Cadena | ID que vincula la reserva a una reserva de grupo |
| ContextId | Cadena | Identificador específico del contexto para rastrear el origen de las reservas |
| ProcessedDate | Cadena | Marca temporal en la que se ha procesado la reserva |
| CreatedDate | Cadena | Marca temporal en la que se ha creado la reserva |
| CreatedBy | Cadena | Identificador de la user/system persona que creó la reserva |
| UpdatedDate | Cadena | Marca temporal de la última actualización de la reserva |
| UpdatedBy | Cadena | Identificador del user/system que actualizó la reserva |
| AgentId | Cadena | ID del agente que gestiona la reserva |
| Reserver | Cadena | Indica si es el perfil del que hace la reserva |
| SameDayRate | Cadena | Indica si la reserva se ha realizado para el mismo día |
| Refundable | Cadena | Indica si la reserva es reembolsable |
| CancellationCharge | Cadena | Cargo de cancelación si corresponde. 0 significaría ningún cargo |
| TransactionId | Cadena | Identificador único de la transacción |
| AmountPerNight | Cadena | Importe cobrado por noche por habitación |
| AdditionalNote | Cadena | Notas o instrucciones especiales |
| NumberOfNights | Cadena | Número de noches de la reserva |
| NumberOfGuests | Cadena | Número total de huéspedes de la reserva |
| TotalAmountBeforeTax | Cadena | Costo total antes de impuestos |
| TotalAmountAfterTax | Cadena | Costo total después de impuestos |
| Checkout | CheckOut | Información de salida |
| Loyalty | Loyalty | Información sobre la fidelización |
| Sala | Sala | Información sobre la habitación |
| CheckIn | CheckIn | Detalles del registro |
| Pago | Pago | Información del pago |
| Currency (Divisa) | Currency (Divisa) | Información de la divisa |
| Cancelación | Cancelación | Detalles de la cancelación |
| Canal | Canal | Información del canal |
| RatePlan | RatePlan | Información sobre el plan de tarifas |
| Invitados | Invitados | Información del huésped |
| Services | Lista de servicios | Lista de servicios |
| Atributos | Mapa | Atributos adicionales |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**Tipo de datos de salida**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Early | Cadena | Salida temprano programada o solicitada |
| Late | Cadena | Salida tardía programada o solicitada |
| Auto | Cadena | Salida autogestionada programada o solicitada |
| Date | Cadena | Fecha de salida de la reserva |
**Tipo de datos de fidelización**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ProgramName | Cadena | Nombre del programa de fidelización |
| MembershipId | Cadena | ID del miembro del programa de fidelización |
| Nivel | Cadena | Nivel o categoría de fidelización |
**Tipo de datos de la habitación**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| TypeCode | Cadena | Código del tipo o categoría de habitación |
| TypeName | Cadena | Nombre del tipo de habitación |
| TypeDesc | Cadena | Descripción del tipo de habitación |
| Número | Cadena | Número de habitación asignado |
| Capacidad | Cadena | Capacidad máxima de la habitación |
| AccessibilityType | Cadena | Funciones de accesibilidad |
| SmokingAllowed | Cadena | Indica si se permite fumar en la habitación |
**CheckIn tipo de datos**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Fecha | Cadena | Fecha de salida de la reserva |
| DigitalKey | Cadena | Indica si se ha emitido una llave de habitación digital |
| Early | Cadena | Indica si se ha solicitado un registro temprano |
| Late | Cadena | Indica si se ha solicitado un registro tardío |
| RoomKeys | Cadena | Número de llaves de la habitación emitidas |
| UserSelectedRoom | Cadena | Es verdadero si el huésped ha seleccionado su propia habitación |
**Tipo de datos de pago**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de método de pago (por ejemplo, crédito, débito o cupón) |
| CreditCardToken | Cadena | Número de tarjeta de crédito con token |
| CreditCardType | Cadena | Tipo de tarjeta de crédito (por ejemplo, Visa o Amex) |
| CreditCardExpiration | Cadena | Fecha de caducidad de la tarjeta |
| Cvv | Cadena | Valor de verificación de la tarjeta |
| NameOnCreditCard | Cadena | Nombre impreso en la tarjeta de crédito |
| RoutingNumber | Cadena | Número de ruta bancaria |
| AccountNumber | Cadena | Número de cuenta bancaria |
| VoucherId | Cadena | Identificador del cupón, si se utiliza |
| DiscountCode | Cadena | Código de descuento aplicado |
| DiscountPercent | Cadena | Porcentaje de descuento aplicado |
**Tipo de datos de divisa**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Código | Cadena | Código ISO de la divisa (por ejemplo, USD) |
| Name | Cadena | Nombre completo de la divisa (por ejemplo, dólar estadounidense) |
| Símbolo | Cadena | Símbolo de la divisa (por ejemplo, \$1) |
**Tipo de datos de cancelación**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Motivo | Cadena | Motivo de la cancelación |
| Comment | Cadena | Notas adicionales sobre la cancelación |
**Tipo de datos de Channel**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| CreationChannelId | Cadena | ID del canal a través del que se ha realizado la reserva |
| LastUpdatedChannelId | Cadena | ID del canal que ha actualizado la reserva por última vez |
| Método | Cadena | Método utilizado para hacer la reserva (por ejemplo, web o aplicación móvil) |
**RatePlan tipo de datos**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Código | Cadena | Código identificador del plan de tarifas reservado |
| Name | Cadena | Nombre del plan de tarifas reservado |
| Description (Descripción) | Cadena | Descripción del plan de tarifas |
**Tipo de datos de servicio**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| ServiceType | Cadena | Tipo de servicio (por ejemplo, spa o desayuno) |
| Description (Descripción) | Cadena | Descripción del servicio |
| Costo | Cadena | Costo del servicio |
**Tipo de datos del huésped**
| Campo hotelReservation estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Adults | Cadena | Número de huéspedes adultos |
| Children | Cadena | Número de huéspedes menores |
# Asignación de tipo de objeto para el programa de fidelización estándar
En los temas de esta sección se define el concepto de programa de fidelización estándar.
**Topics**
+ [
# Campos de objetos de programa de fidelización estándar de Perfiles de clientes
](standard-loyalty-object-fields.md)
# Campos de objetos de programa de fidelización estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto del programa de fidelización estándar de Perfiles de clientes.
**Loyalty**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| LoyaltyId | Cadena | Identificador único del programa de fidelización estándar |
| ProgramId | Cadena | Identificador del programa de fidelización |
| MembershipId | Cadena | Identificador alternativo dentro del programa |
| ProgramName | Cadena | Nombre del programa de fidelización |
| Group | Cadena | Grupo o categoría del programa de fidelización |
| Canal | Cadena | Canal a través del cual se accede al programa de fidelización |
| CreatedDate | Cadena | Fecha en que se creó la cuenta de fidelización |
| EnrollmentDate | Cadena | Fecha en que el cliente se inscribió en el programa |
| CreatedBy | Cadena | Usuario o sistema que ha creado la cuenta de fidelización |
| UpdatedDate | Cadena | Fecha en que se actualizó por última vez la cuenta de fidelización |
| LastUpdatedBy | Cadena | Usuario o sistema que actualizó la cuenta de fidelización por última vez |
| UpgradeDate | Cadena | Fecha en la que se actualizó el nivel por última vez |
| RenewalDate | Cadena | Fecha de renovación de la membresía del programa de fidelización |
| AdditionalInformation | Cadena | Cualquier información adicional |
| EmailAddress | Cadena | Dirección de correo electrónico del cliente |
| EmailAddressVerified | Cadena | Indica si el correo electrónico está verificado |
| PhoneNumber | Cadena | Número de teléfono del cliente |
| PhoneNumberVerified | Cadena | Indica si el número de teléfono está verificado |
| Status | Cadena | Estado actual de la cuenta de fidelización |
| Nivel | Nivel | Información sobre el nivel |
| Points | Points | Información sobre los puntos |
| PointExpirations | PointExpiration Lista | Información sobre el vencimiento de los puntos |
| Pago | Pago | Información del pago |
| PaymentInformation | PaymentInformation | Detalles sobre la información de pago |
| BillingAddress | Dirección de fidelización | Información de la dirección |
| Atributos | Mapa | Atributos adicionales que no se incluyen por otros medios |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**Tipo de datos de dirección del programa de fidelización**
| Campo airPreference estándar | Tipo de datos: | Description (Descripción) |
| --- | --- | --- |
| Address1 | Cadena | La primera línea de una dirección de cliente. |
| Address2 | Cadena | La segunda línea de una dirección de cliente. |
| Address3 | Cadena | La tercera línea de una dirección de cliente. |
| Address4 | Cadena | La cuarta línea de una dirección de cliente. |
| Ciudad | Cadena | La ciudad en la que vive el cliente. |
| País | Cadena | El país en la que vive el cliente. |
| County | Cadena | El condado en la que vive el cliente. |
| PostalCode | Cadena | El código postal de la dirección del cliente. |
| Province | Cadena | La provincia en la que vive el cliente. |
| Estado | Cadena | El estado en el que vive el cliente. |
**Tipo de datos de nivel**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| CurrentTier | Cadena | Nivel de actual del cliente en el programa de fidelización |
| NextTier | Cadena | Siguiente nivel disponible para el cliente |
| PointsToNextTier | Cadena | Puntos necesarios para alcanzar el siguiente nivel |
**Tipo de datos de puntos**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Points.Unit | Cadena | Unidad de medida de los puntos |
| Points.Lifetime | Cadena | Total de puntos acumulados hasta el momento |
| Points.Balance | Cadena | Saldo de puntos actual |
| Points.Redeemed | Cadena | Total puntos canjeados |
**PointExpiration tipo de datos**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Points | Cadena | Puntos que vencen |
| Date | Cadena | Fecha de vencimiento de los puntos |
**Tipo de datos de pago**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de pago |
| CreditCardToken | Cadena | Referencia de tarjeta de crédito con token |
| CreditCardType | Cadena | Tipo de tarjeta de crédito (por ejemplo, Visa) |
| CreditCardExpiration | Cadena | Fecha de caducidad de la tarjeta de crédito |
| Cvv | Cadena | Valor de verificación de la tarjeta |
| NameOnCreditCard | Cadena | Nombre que figura en la tarjeta |
| RoutingNumber | Cadena | Número de ruta bancaria |
| AccountNumber | Cadena | Número de cuenta bancaria |
| VoucherId | Cadena | Identificador del cupón |
**PaymentInformation tipo de datos**
| Campo de programa de fidelización estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Schedule | Cadena | Calendario de pagos |
| LastPaymentDate | Cadena | Fecha del último pago |
| NextPaymentDate | Cadena | Fecha del próximo pago |
| NextBillAmount | Cadena | Importe de la próxima factura |
| CurrencyCode | Cadena | Código de la divisa (por ejemplo, USD) |
| CurrencyName | Cadena | Nombre completo de la divisa |
| CurrencySymbol | Cadena | Símbolo de la divisa (por ejemplo, \$1) |
# Asignación de tipo de objeto para la transacción de fidelización estándar
En los temas de esta sección se define el concepto de transacción de fidelización estándar.
**Topics**
+ [
# Campos de objetos de transacción de fidelización estándar de Perfiles de clientes
](standard-loyalty-transaction-object-fields.md)
# Campos de objetos de transacción de fidelización estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de la transacción de fidelización estándar de Perfiles de clientes.
**Transacción de fidelización**
| Campo loyaltyTransaction estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| TransactionId | Cadena | Identificador único de la transacción de fidelización estándar |
| TransactionName | Cadena | Nombre o etiqueta de la transacción |
| TransactionType | Cadena | Tipo de transacción (por ejemplo, ganar, canjear o ajustar) |
| ProgramRef | Cadena | Referencia al programa de fidelización asociado |
| MembershipRef | Cadena | Referencia a la membresía de fidelización utilizada en la transacción |
| PromotionRef | Cadena | Referencia a una promoción que ha influido en esta transacción |
| CreatedDate | Cadena | Fecha en que se ha creado la transacción |
| TransactionDate | Cadena | Fecha en que se ha producido la transacción |
| Industry | Cadena | Sector asociado a la transacción (por ejemplo, línea aérea u hotel) |
| Ubicación | Cadena | Ubicación en la que se ha producido la transacción |
| CreatedBy | Cadena | Identificador del autor de la transacción |
| UpdatedDate | Cadena | Fecha en la que se actualizó por última vez la transacción |
| UpdatedBy | Cadena | Identificador de la última vez que se actualizó la transacción |
| Status | Cadena | Estado actual de la transacción |
| AccrualType | Cadena | Método de devengo (manual, automatizado, etc.) |
| Categoría | Cadena | Categoría de la transacción (por ejemplo, vuelo o estancia en hotel) |
| Canal | Cadena | Canal en el que se inició la transacción (por ejemplo, en línea o en la tienda) |
| ProductId | Cadena | Identificador del producto o servicio vinculado a la transacción |
| Amount | Cadena | Importe gastado o transaccionado en la transacción |
| OriginValue | Cadena | Valor original antes de cualquier conversión o compensación |
| OriginValueCurrency | Cadena | Divisa del valor original de la transacción |
| OriginValueOffset | Cadena | Ajuste al valor original para promociones, reembolsos, etc. |
| PointsEarned | Cadena | Total de puntos acumulados en esta transacción |
| PointOffset | Cadena | Puntos ajustados (por ejemplo, bonificaciones o penalizaciones) |
| QualifyingPointsEarned | Cadena | Los puntos se tienen en cuenta para la clasificación de nivel |
| TierBefore | Cadena | Nivel de cliente antes de la transacción |
| TierAfter | Cadena | Nivel de cliente después de la transacción |
| Brand | Cadena | Marca asociada con la transacción |
| Description (Descripción) | Cadena | Descripción narrativa de la transacción |
| AdditionalInformation | Cadena | Información adicional de formato libre relacionada con la transacción |
| PaymentMethod | Cadena | Método de pago utilizado (por ejemplo, tarjeta o cupón) |
| PointTransfer | PointTransfer | Información sobre la transferencia de puntos |
| Atributos | Mapa | Atributos adicionales |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer tipo de datos**
| Campo loyaltyTransaction estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| TransferId | Cadena | Identificador para la transacción de transferencia |
| SourceProgramId | Cadena | ID del programa de fidelización de origen |
| DestinationProgrmId | Cadena | ID del programa de fidelización de destino |
| SourceMembershipId | Cadena | ID de membresía del programa de origen |
| DestinationMembershipId | Cadena | ID de membresía del programa de destino |
| PointsTransferred | Cadena | Puntos deducidos del programa de origen |
| PointsReceived | Cadena | Puntos que se acreditan al programa de destino |
# Asignación de tipo de objeto para la promoción del programa de fidelización estándar
En los temas de esta sección se define el concepto de promoción del programa de fidelización estándar.
utilización
**Topics**
+ [
# Campos de objetos de la promoción del programa de fidelización estándar de Perfiles de clientes
](standard-loyalty-promotion-object-fields.md)
# Campos de objetos de la promoción del programa de fidelización estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de la promoción del programa de fidelización estándar de Perfiles de clientes.
**Promoción del programa de fidelización**
| Campo loyaltyPromotion estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| PromotionId | Cadena | Identificador único de la promoción del programa de fidelización estándar |
| PromotionName | Cadena | Nombre de la promoción |
| PromotionType | Cadena | Tipo o categoría de la promoción (por ejemplo, bonificación, aumento de nivel o cupón) |
| ProgramType | Cadena | Indica el tipo de programa de fidelización al que está vinculada la promoción |
| ProgramRef | Cadena | ID de referencia del programa de fidelización relacionado |
| PartnerId | Cadena | ID de referencia de una organización asociada que participa en la promoción |
| PartnerNumber | Cadena | Identificador o número relacionado con el socio |
| Nivel | Cadena | Nivel al que se dirige la promoción o se ve afectado por ella |
| StartDate | Cadena | Cuando se active la promoción |
| EnrolledDate | Cadena | Fecha en que el usuario se inscribió en la promoción |
| EndDate | Cadena | Fin de la promoción |
| Amount | Cadena | Valor monetario o en puntos asociado a la promoción |
| Periodo | Cadena | Periodo de la promoción (por ejemplo, semanal, mensual o basado en una campaña) |
| Status | Cadena | Estado actual de la promoción (por ejemplo, activa, caducada o finalizada) |
| CreatedDate | Cadena | Fecha en que se creó el registro de la promoción |
| CreatedBy | Cadena | Usuario o sistema que ha cifrado el registro de la promoción |
| UpdatedDate | Cadena | Fecha en la que se actualizó por última vez el registro de la promoción |
| UpdatedBy | Cadena | Usuario o sistema que ha actualizado la promoción por última vez |
| CampaignRef | Cadena | Referencia externa a una campaña más amplia a la que pertenece esta promoción |
| AdditionalInformation | Cadena | Notas diversas o textos de marketing sobre la promoción |
| TriggerLimit | TriggerLimit | Información sobre el límite de activación |
| De uso | De uso | Información de uso |
| Reglas | Reglas | Información sobre las reglas de la promoción |
| Incentive | Incentive | Información sobre el incentivo de la promoción |
| Atributos | Mapa | Metadatos adicionales o valores específicos del programa |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**Tipo de datos de reglas**
| Campo loyaltyPromotion estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Name | Cadena | Nombre de la regla dentro de las reglas de la promoción |
| Description (Descripción) | Cadena | Descripción de la regla dentro de las reglas de la promoción |
**Tipo de datos de incentivos**
| Campo loyaltyPromotion estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Tipo | Cadena | Tipo de incentivo (por ejemplo, bonusPoints, voucher o tierUpgrade) |
| Valor | Cadena | Valor del incentivo, como la cantidad de puntos o el valor del cupón |
| Unidad | Cadena | Unidad del valor del incentivo (por ejemplo, puntos, % o USD) |
**TriggerLimit tipo de datos**
| Campo loyaltyPromotion estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| Times | Cadena | Número de veces que se puede activar una promoción |
| Interval | Cadena | Intervalo del límite de activación |
**Tipo de datos de uso**
| Campo loyaltyPromotion estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| UsageProgressPercent | Cadena | Porcentaje de progreso del uso de la promoción |
| UsageCompleted | Cadena | Número de usos completados |
| UsageTarget | Cadena | Número objetivo de usos. |
# Mapeo de tipos de objeto para el objeto de análisis web
**WebAnalytics Esquema de objetos estándar**
| Campo | Tipo | Description (Descripción) |
| --- | --- | --- |
| Atributos del evento |
| EventId | Cadena | Identificador único para un evento de análisis web. |
| EventType | Cadena | Tipo de evento de análisis web, por ejemplo: vista de página, envío del formulario, clics en botones,Abre la línea principal\$1u0000Interacción con la barra de búsqueda, mensajes de error de la aplicación, interacciones con el carrito, compras, pergaminos, etc. |
| EventTimestamp | Número | Época y milisegundo, marca temporal del evento. |
| EventDuration | Número | EventDuration representa la cantidad de tiempo que un usuario pasó durante una interacción determinada, medido en segundos. Los casos de uso más comunes incluyen: el tiempo dedicado a ver un producto, la duración de una sesión de navegación en una página en particular, el tiempo dedicado a una función, etc. |
| EventValue | Número | EventValue es un atributo numérico que representa el valor o la importancia de un evento de interacción. Los casos de uso más comunes incluyen: el importe de la compra para los eventos de transacción, los valores de valoración para las valoraciones de los productos, el porcentaje de reproducciones de vídeo completadas, etc. |
| Atributos de sesión |
| ID de sesión | Cadena | Identificador único de la sesión. |
| Sesión. StartTimestamp | Número | Milisegundo de época que indica la marca de tiempo de inicio de la sesión. |
| Atributos de página/pantalla |
| Título de la página | Cadena | Título del App/Screen nombre web de una aplicación móvil. |
| Página. Ubicación | Cadena | URL de una página web. Para dispositivos móviles, puede ser un enlace directo o una ruta a la pantalla. |
| Página. Referrer | Cadena | Pantalla/página anterior. |
| Página. Categoría | Cadena | Agrupación lógica de ubicaciones. screen/page. Might be useful to group nested URLs/app |
| Elementos HTML/DOM |
| ID del elemento | Cadena | ID del elemento HTML |
| Tipo de elemento | Cadena | Tipo de elemento: botón, eslabones de anclaje, etc. |
| Elemento. Clases | Cadena | Clases de estilo CSS del elemento |
| Elemento.Texto | Cadena | Texto del elemento (útil para botones, campos de entrada, marcadores de posición, etc.). |
| Elemento. AltText | Cadena | AltText de un elemento HTML (generalmente usado para imágenes). |
| Element.Fuente | Cadena | Fuente de cualquier vídeo, imagen, etc. |
| Formulario |
| ID del formulario | Cadena | Identificador único para un formulario de entrada |
| Nombre del formulario | Cadena | Nombre del formulario |
| Forma. Longitud | Cadena | Número de campos de entrada en un formulario. |
| Formulario. ValidationErrors | Número | Número de errores de validación en el formulario. |
| Formulario. FieldsCompleted | Número | Número de campos completados. |
| Formulario. FieldsRequired | Número | Número de campos obligatorios. |
| Search |
| Search.Query | Cadena | Cadena de consulta utilizada en la entrada |
| Búsqueda. TotalMatchingResults | Número | Número total de resultados de búsqueda. |
| Búsqueda. ResultsPerPage | Número | Número de resultados mostrados por página. |
| Búsqueda. CurrentResultsPage | Número | Página de resultados actual que está viendo el usuario. |
| Búsqueda. FilterExpression | Cadena | Cualquier expresión de filtro adicional utilizada. |
| Búsqueda. SortCriteria | Cadena | Criterios para ordenar el resultado de la búsqueda. Por ejemplo: relevancia, precio, etc. |
| Búsqueda. SortOrder | Cadena | Orden de clasificación de los resultados de la búsqueda: ascendente/descendente. |
| Elemento/lista de artículos |
| Elemento | Elemento | Artículo enfocado en un evento, que indica el artículo agregado al carrito, el artículo visto, etc. |
| ItemsList | Lista - | Lista específica de los artículos de un evento, que indica los artículos comprados, los artículos del carrito, los resultados de la búsqueda de artículos, etc. |
| Impresiones de artículos |
| AdditionalItemImpressions | Lista
- | Lista de impresiones de artículos adicionales |
| Carrito |
| Cart.Id | Cadena | Identificador único para un carrito. |
| Carrito. ItemsCount | Número | Número de artículos en el carrito. |
| Carrito. Moneda | Cadena | Moneda del valor del carrito. |
| Carrito. Valor | Número | Valor monetario de los artículos del carrito. |
| Información del pedido |
| OrderId | Cadena | Identificador único de un pedido. Aquí solo almacenaremos el identificador del pedido, el resto de la información relacionada con el pedido se almacenará en el objeto de pedido estándar. |
| Dispositivo |
| DeviceId | Cadena | Identificador único del dispositivo del usuario. |
| Atributos de desplazamiento |
| Pergamino. DepthPercentage | Cadena | Porcentaje de profundidad de desplazamiento vertical. Esto ayuda a comprender qué tan lejos se desplazan los usuarios por una página web. |
| Desplázate. Posición X | Número | Posición de desplazamiento horizontal en píxeles desde la izquierda. |
| Desplázate. Posición Y | Número | Posición de desplazamiento vertical en píxeles desde la parte superior. |
| Error |
| Error. Descripción | Cadena | Breve descripción del error. |
| Tipo de error | Cadena | Error de entrada del usuario. Error/Server |
| Usuario |
| ID de usuario | Cadena | Identificador único del usuario |
| Usuario. AnonymousId | Cadena | Anónimo UserId. Sería un identificador único asignado a un usuario cuando no ha iniciado sesión. |
| Usuario. IsReturning | Cadena | Un valor booleano que indica si un usuario vuelve a visitarlo. |
| Usuario. IsLoggedIn | Cadena | Un valor booleano que indica si un usuario ha iniciado sesión. |
| Activity Location (Ubicación de actividad) |
| Location.Country | Cadena | País de actividad del usuario. |
| Ubicación. Estado | Cadena | Estado de actividad del usuario. |
| Ubicación. Provincia | Cadena | Provincia de actividad del usuario. |
| Ubicación. Condado | Cadena | Condado de actividad del usuario. |
| Ubicación. Ciudad | Cadena | Ciudad de actividad del usuario. |
| Ubicación. Latitud | Cadena | Coordenadas de ubicación de la actividad del usuario |
| Ubicación. Longitud | Cadena | Coordenadas de ubicación de la actividad del usuario |
| Atributos de aplicación |
| Application.Name | Cadena | Nombre de la aplicación. |
| Application.Version | Cadena | Si el dispositivo es móvil, podemos capturar la versión de la aplicación aquí. El usuario también podría considerar usarlo para A/B pruebas de población o atributos de experimentación. |
| Aplicación. Medio ambiente | Cadena | Entornos de aplicaciones, como Beta, Gamma, Prod. |
| Atributos personalizados |
| Atributos | Mapa | Cualquier atributo o metadato personalizado que desee añadir al evento. |
**WebAnalytics Esquema del objeto del elemento**
| Campo | Tipo | Description (Descripción) |
| --- | --- | --- |
| Id | Cadena | Identificador único del artículo. |
| Title | Cadena | Título del artículo. |
| Categoría | Cadena | Categoría del artículo. |
| Valor | Cadena | Valor monetario del artículo. |
| Currency (Divisa) | Cadena | Moneda del artículo. |
| Cantidad | Número | Cantidad del artículo. |
| ImpressionType | Cadena | Cadena que identifica el tipo de impresión de un evento. Por ejemplo: Destacados, Patrocinados, Mejores selecciones, etc. |
| ImpressionId | Cadena | Un identificador de cadena para identificar de forma única una impresión. |
**Esquema de objetos estándar del dispositivo**
| Campo | Tipo | Description (Descripción) |
| --- | --- | --- |
| DeviceId | Cadena | Un identificador único para el dispositivo. |
| Tipo | Cadena | Tipo de dispositivo (p. ej., ordenador de sobremesa, móvil) |
| Modelo | Cadena | Modelo de dispositivo, como Macbook Pro/Air, IPhone 16, etc. |
| Manufacturer (Fabricante) | Cadena | Fabricante del dispositivo. |
| OperatingSystem | Cadena | Indica Windows MacOs, IOS y Android. |
| OperatingSystemVersion | Cadena | Versión del sistema operativo |
| ScreenWidth | Número | Ancho de la pantalla ViewPort |
| ScreenHeight | Número | Altura de la pantalla ViewPort |
| Navegador | Cadena | Nombre del navegador con el que interactúa el usuario. |
| BrowserVersion | Cadena | Versión del navegador |
| Locale | Cadena | Configuración regional del dispositivo o la aplicación. |
| Atributos | Mapa | Cualquier atributo personalizado de un dispositivo. |
# Mapeo de tipos de objetos para el catálogo de artículos
| Campo | Tipo | Description (Descripción) |
| --- | --- | --- |
| Id | Cadena | Identificador único del artículo del catálogo. |
| Name | Cadena | Nombre del artículo |
| Código | Cadena | Código del artículo del catálogo |
| Tipo | Cadena | Tipo de artículo del catálogo |
| Categoría | Cadena | Categoría del artículo del catálogo |
| Description (Descripción) | Cadena | Descripción del artículo |
| AdditionalInformation | Cadena | Cualquier información adicional relacionada con el artículo. |
| ImageLink | Cadena | Enlace a la imagen del artículo |
| Link | Cadena | URL del artículo |
| Precio | Cadena | Precio del artículo |
| CreatedAt | Largo | Época y hora para la que se creó el artículo |
| UpdatedAt | Largo | Época y hora para la que se actualizó el artículo |
| Atributos | Mapa | Atributos adicionales del artículo |
**nota**
Solo puede eliminar el tipo de objeto de dominio mediante APIs. Puedes eliminar la integración del catálogo de artículos después de eliminar primero todos los recomendantes. Esto evita problemas de dependencia de los datos.
**Pasos para eliminar:**
1. Elimina todos los recomendantes existentes en tu dominio
2. Navega hasta la integración del catálogo de artículos.
3. Seleccione la opción de eliminación.
# Asignación de tipo de objeto para la reserva de la estancia en hotel estándar
En los temas de esta sección se define el concepto de ingreso por estancia en hotel estándar.
**Topics**
+ [
# Campos de objeto de ingreso por estancia en hotel estándar de Perfiles de clientes
](standard-hotel-stay-revenue-object-fields.md)
# Campos de objeto de ingreso por estancia en hotel estándar de Perfiles de clientes
En la tabla siguiente se enumeran todos los campos del objeto de ingreso por estancia en hotel estándar de Perfiles de clientes.
**Ingreso por estancia en hotel**
| hotelStayRevenue Campo estándar | Tipo | Description (Descripción) |
| --- | --- | --- |
| StayRevenueId | Cadena | Identificador único de los ingresos por estancia en hotel estándar |
| CurrencyCode | Cadena | Código ISO de la divisa (por ejemplo, USD) |
| CurrencyName | Cadena | Nombre completo de la divisa (por ejemplo, dólar estadounidense) |
| CurrencySymbol | Cadena | Símbolo de la divisa (por ejemplo, \$1) |
| ReservationId | Cadena | Identificador único de la reserva de hotel |
| GuestId | Cadena | Identificador único del huésped |
| LastUpdatedOn | Cadena | Marca de tiempo de la última actualización del registro de estancia |
| CreatedOn | Cadena | Marca de tiempo de la creación del registro de estancia |
| LastUpdatedBy | Cadena | Identificador del user/system que actualizó por última vez el registro de estancia |
| CreatedBy | Cadena | Identificador de la user/system persona que creó el registro de estancia |
| StartDate | Cadena | Fecha de inicio de la estancia en el hotel |
| HotelCode | Cadena | Código que identifica el hotel en concreto |
| Tipo | Cadena | Tipo de ingreso (por ejemplo, tarifa de habitación, gastos imprevistos o impuestos) |
| Description (Descripción) | Cadena | Descripción de la partida de ingresos |
| Amount | Cadena | Importe de la partida de ingresos |
| ProcessedDate | Cadena | Fecha en que se procesaron los ingresos |
| Status | Cadena | Estado de la partida de ingresos |
| Atributos | Mapa | Metadatos adicionales o valores específicos del programa |
**Campos de índice estándar**
| Nombre de índice estándar | Campo de registro de preferencias estándar |
| --- | --- |
| \$1 hotelStayRevenue Identificador | StayRevenueId |
# Propiedades adicionales de los tipos de objeto en Perfiles de clientes
Un tipo de propiedad define qué clave debe utilizarse para cifrar cualquier dato del tipo de objeto.
Existe una opción que define si se pueden crear nuevos perfiles mediante la ingesta de este objeto. Normalmente, cuando se realiza la ingesta de un objeto que no se puede hacer coincidir con un perfil existente, se crea un nuevo perfil siempre que esta opción sea verdadera. Si no es verdadera, se crea el objeto de ingesta y se escribe en la cola de mensajes fallidos del dominio.
También contiene cuánto tiempo deben retenerse los datos de este tipo de objeto en Perfiles de clientes.
**nota**
La retención en objetos individuales se establece en el momento de la ingesta de datos. La modificación de la retención para un tipo de objeto específico solo se aplica a los nuevos datos de los que se realiza la ingesta. No se aplica a los datos existentes de los que ya se ha realizado la ingesta.
**nota**
Si este objeto coincide con un perfil existente, no sobrescribirá los campos rellenados manualmente mediante una llamada a la API o el espacio de trabajo del agente, para evitar que las ingestas automatizadas sobrescriban a las manuales.
Por ejemplo, supongamos que un agente crea manualmente un perfil con FirstName «John» en el espacio de trabajo del agente. Se ingiere un objeto que mapea datos al FirstName campo del perfil estándar. Si este objeto se asocia al perfil, no sobrescribirá el FirstName «John».
# Perfiles inferidos
Cuando se crea un perfil mediante la ingesta de un objeto que no tiene campos, el objeto de perfil estándar de este nuevo perfil está vacío. Este objeto de perfil estándar vacío es un **perfil inferido**.
Al crear un perfil inferido, los dos campos siguientes se rellenan en el objeto estándar a partir del objeto de perfil, si está disponible.
+ Si hay algún campo definido con el tipo de contenido de `EMAIL_ADDRESS` en el objeto de ingesta, este valor se rellenará en el campo `EmailAddress` del perfil estándar.
+ Si hay algún campo con el tipo de contenido de `PHONE_NUMBER` en el objeto de ingesta, este valor se rellenará en el campo `PhoneNumber` del perfil estándar.
Los valores de estos campos se rellenan en el perfil estándar aunque los campos no tengan un objetivo definido en la definición de campo.
Para obtener más información sobre los tipos de plantillas de registros de contactos y sobre cómo ajustar la plantilla utilizada en su dominio, consulte [Ejemplos de uso de plantillas de registro de contacto](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples).
# Plantillas de registro de contactos en Perfiles de clientes de Amazon Connect
Un registro de contacto sirve como objeto de perfil que captura metadatos esenciales de varios eventos de contacto, como llamadas telefónicas o chats. Desempeña un rol vital en la documentación y el análisis de las interacciones con los clientes.
Cuando se produce un evento de contacto, se pueden aplicar tres plantillas predeterminadas distintas a su dominio. Estas plantillas sirven como opciones de configuración, que rigen cómo se gestiona el evento de contacto en el sistema. Cada plantilla define reglas y acciones específicas, lo que le permite adaptar el procesamiento de los eventos de contacto a sus necesidades empresariales.
**Topics**
+ [
## Cree perfiles inferidos y asocie perfiles automáticamente (CTR-) NoInferred
](#ctr-contact-record-template-no-inferred)
+ [
## Asocie automáticamente solo perfiles (CTR-) AutoAssociateOnly
](#ctr-contact-record-template-auto-associate)
+ [
## Creación solo de perfiles inferidos (CTR)
](#ctr-contact-record-template-inferred-only)
+ [
## Ejemplos de uso de plantillas de registro de contacto
](#ctr-contact-record-template-usage-examples)
+ [
## Cómo actualizar el tipo de registro de contacto en la consola de AWS
](#ctr-contact-record-template-usage-examples-console)
+ [
## Adición automática de los nombres de los contactos de correo electrónico a un perfil
](#add-email-names-to-profile)
## Cree perfiles inferidos y asocie perfiles automáticamente (CTR-) NoInferred
**Descripción**
Cuando se utiliza la NoInferred plantilla CTR- y se produce un evento de contacto, como una llamada telefónica, se inicia un proceso específico para gestionar los datos. Inicialmente, el sistema utiliza la clave `_ctrContactId` para buscar un perfil existente asociado al evento de contacto. Si se encuentra un perfil coincidente, el evento de contacto se asocia automáticamente a ese perfil. No obstante, si no se encuentra ningún perfil existente mediante la clave `_ctrContactId`, el sistema procede a buscar un perfil con una clave secundaria denominada `_phone`. Esta clave se utiliza para localizar un perfil existente a partir del número de teléfono asociado al evento de contacto. Cuando se encuentra un perfil coincidente, el evento de contacto se asocia automáticamente a ese perfil.
En los casos en los que ni la clave `_ctrContactId` ni la clave `_phone` dan lugar a un perfil existente, el sistema crea un nuevo perfil inferido. A continuación, este perfil inferido se rellena con los metadatos del evento de contacto, lo que garantiza que la información se captura y almacena en el sistema.
Este proceso garantiza una gestión eficaz de los eventos de contacto, mediante la promoción de la asociación automática con los perfiles existentes y la creación de perfiles inferidos cuando sea necesario. Al aprovechar estos mecanismos, las organizaciones pueden mantener un registro exhaustivo de las interacciones con los clientes y administrar eficazmente sus datos de eventos de contacto dentro del sistema.
Se recomienda utilizar la NoInferred plantilla CTR- como comportamiento predeterminado debido a sus importantes ventajas, especialmente a la hora de reducir los perfiles duplicados
![\[El diagrama de la NoInferred plantilla CTR de Contact Record.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## Asocie automáticamente solo perfiles (CTR-) AutoAssociateOnly
**Descripción**
La AutoAssociateOnly plantilla CTR funciona de manera similar a la NoInferred plantilla CTR con una diferencia importante: no crea un perfil inferido cuando no se puede encontrar ningún perfil existente para la asociación automática.
Cuando se produce un evento de contacto, como una llamada telefónica, la AutoAssociateOnly plantilla CTR- utiliza la `_ctrContactId` tecla para buscar un perfil existente que coincida. Si se encuentra un perfil, el evento de contacto se asocia automáticamente a ese perfil.
No obstante, si no se encuentra ningún perfil existente mediante la clave `_ctrContactId`, la plantilla utiliza un mecanismo de búsqueda secundario con la clave `_phone`. Busca un perfil existente asociado al mismo número de teléfono que el evento de contacto. Si se encuentra un perfil coincidente, el evento de contacto se asocia automáticamente a ese perfil.
El objetivo de utilizar la AutoAssociateOnly plantilla CTR- es permitir la asociación automática con los perfiles existentes y, al mismo tiempo, mantener un control estricto sobre la creación de perfiles. A diferencia de la NoInferred plantilla CTR-, esta plantilla impide la creación de perfiles inferidos cuando no se encuentra ninguna coincidencia. Garantiza que los perfiles solo se creen manualmente, lo que proporciona a las organizaciones un mayor nivel de control y precisión en la administración de perfiles.
Al utilizar la AutoAssociateOnly plantilla CTR-, las organizaciones pueden aprovechar la asociación automática y, al mismo tiempo, cumplir con reglas específicas relacionadas con la creación de perfiles. Este enfoque permite agilizar la gestión de los eventos de contacto y controlar con precisión el ecosistema de perfiles, lo que garantiza una representación exacta de los datos y facilita una administración eficaz de los clientes.
![\[El diagrama de la plantilla CTR de Contact Record. AutoAssociateOnly\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## Creación solo de perfiles inferidos (CTR)
**Descripción**
La plantilla CTR se basa únicamente en la clave `_ctrContactId` para buscar un perfil existente y asocia automáticamente el evento de contacto con el perfil si se encuentra una coincidencia. No obstante, en los casos en los que no se encuentra ningún perfil existente, la plantilla crea un perfil inferido y lo rellena con los metadatos del evento de contacto.
Aunque este comportamiento garantiza que se capturen los eventos de contacto incluso cuando no existe un perfil previo, puede dar lugar a la creación de numerosos perfiles inferidos. Esta abundancia de perfiles inferidos puede provocar la aparición de perfiles duplicados en el sistema.
Para abordar este problema y promover mejores prácticas de gestión de perfiles, recomendamos encarecidamente utilizar la NoInferred plantilla CTR- como opción predeterminada. Al utilizar la NoInferred plantilla CTR-, el sistema elimina la creación de perfiles inferidos y, por lo tanto, reduce la aparición de perfiles duplicados. Esta plantilla permite una gestión más ágil y eficaz de los eventos de contacto, lo que se traduce en una mejora de la integridad y la precisión de los datos.
Al adoptar la NoInferred plantilla CTR- como opción predeterminada, las organizaciones pueden optimizar sus procesos de gestión de perfiles, minimizar la duplicación de datos y garantizar una representación más fiable de las interacciones con los clientes.
![\[El diagrama de la plantilla CTR del registro de contacto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## Ejemplos de uso de plantillas de registro de contacto
**Amazon Connect sitio web de administración**
+ En el sitio web de Amazon Connect administración, al crear un nuevo dominio, tienes la opción de seleccionar el comportamiento de CTR deseado. Esto puede hacerse a través de las opciones de los botones de opción disponibles en la sección **Creación de perfiles y asociación automática**. Del mismo modo, al seleccionar un dominio existente, la opción del botón de opción reflejará el comportamiento previamente asociado a ese dominio.
+ Al editar un dominio activado actualmente, la página de detalles del dominio mostrará el comportamiento aplicado actualmente en la sección **Creación de perfiles y asociación automática**. Al elegir el botón **Editar** en el encabezado de esta sección, se le redirigirá a la página **Creación y asociación automática de perfiles** en **Editar**. Aquí puede elegir un comportamiento diferente en función de sus necesidades.
+ Como alternativa, si está visualizando la asignación de CTR desde la página **Asignación de datos**, puede elegir el botón **Plantilla de cambio**. Esta acción también lo llevará a la página **Creación y asociación automática de perfiles** de **Editar**, donde podrá seleccionar un comportamiento diferente que se adapte a sus necesidades.
Estas opciones le proporcionan flexibilidad a la hora de administrar el comportamiento de CTR para sus dominios, lo que le permite personalizar y modificar fácilmente la configuración en función de sus preferencias específicas o de la evolución de los requisitos empresariales.
**AWS CLI**
+ Para usar la NoInferred plantilla **CTR-**, ejecute el siguiente comando en la CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ Para usar la AutoAssociateOnly plantilla **CTR-**, ejecute el siguiente comando en la CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ Para utilizar la plantilla **CTR**, ejecute el siguiente comando en la CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `
**API**
Para obtener información sobre el uso de la API, consulte [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
## Cómo actualizar el tipo de registro de contacto en la consola de AWS
1. En la consola de Perfiles de clientes, seleccione **Ver detalles** en la sección del **dominio de perfiles de clientes**.
![\[Elija Ver detalles en la sección del dominio de Perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. En la página **Detalles del dominio**, seleccione **Editar** en la sección **Creación de perfiles y asociación automática**.
![\[Elija Editar en la sección Creación de perfiles y asociación automática.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. Seleccione el comportamiento del registro de contactos que desee aplicar a su dominio y seleccione **Guardar**.
![\[Seleccione el comportamiento del registro de contactos que desee aplicar a su dominio y seleccione Guardar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## Adición automática de los nombres de los contactos de correo electrónico a un perfil
Puede configurar un flujo para rellenar el nombre de un contacto de correo electrónico en el perfil del cliente. Usa el bloque [Perfiles de clientes](customer-profiles-block.md), configurado para usar la acción [Actualizar perfil](customer-profiles-block.md#customer-profiles-block-properties-update-profile).
# Asociación del registro de contacto con un perfil encontrado mediante la clave \$1phone en Perfiles de clientes
Puede asociar automáticamente el registro de contacto con un perfil encontrado mediante la clave `_phone`.
**Ejemplo**
En el dominio, la API `CreateProfile` crea el siguiente perfil:
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
Cuando se recibe una llamada del `PhoneNumber` \$111234567890 mediante la plantilla CTR predeterminada, el registro de contacto no se asociará automáticamente con el perfil anterior a menos que un agente ya haya asociado manualmente el registro de contacto con el mismo interlocutor al perfil anterior. Si el registro de contacto no se asoció manual o automáticamente, Perfiles de clientes creará un perfil inferido con la información del registro de contacto.
Para asociar automáticamente el perfil anterior a los registros de contactos sin la intervención manual del agente, puede utilizar la NoInferred plantilla CTR-. Cuando se recibe una llamada del `PhoneNumber` \$111234567890 mediante la NoInferred plantilla CTR-, el registro de contactos se asociará automáticamente al perfil anterior mediante la clave de perfil. `_phone`
Existen dos escenarios en los que los Perfiles de clientes *no* podrán asociar automáticamente los registros de contacto a un perfil:
+ Si se encuentran varios perfiles con la clave de perfil `_phone`, Perfiles de clientes no podrá asociar el registro de contacto a un perfil único y la solicitud se rechazará.
+ Si no se encuentra ningún perfil para la clave de perfil `_phone`, Perfiles de clientes creará un perfil deducido.
Para usar la plantilla CTR- para reemplazar la NoInferred plantilla CTR predeterminada, ejecute el siguiente comando en la CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`
Para volver al comportamiento predeterminado, ejecute el siguiente comando en la CLI:
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`
# Ejemplos de asignaciones de tipos de objetos en Perfiles de clientes de Amazon Connect
## Una asignación de tipo de objeto que genera un perfil
En el siguiente ejemplo se muestran los datos que rellena el perfil estándar.
A continuación, se muestra el objeto entrante:
```
{
"account": 1234,
"email": "john@examplecorp.com",
"address": {
"address1": "Street",
"zip": "Zip",
"city": "City"
},
"firstName": "John",
"lastName": "Doe"
}
```
En el siguiente código se muestra que el objeto entrante se asigna a un objeto de perfil estándar e indexa `PersonalEmailAddress`, `fullName` y `accountId`, que es una clave única.
```
{
"Fields": {
"accountId": {
"Source": "_source.account",
"Target": "_profile.AccountNumber",
"ContentType": "NUMBER"
},
"shippingAddress.address1": {
"Source": "_source.address.address1",
"Target": "_profile.ShippingAddress.Address1"
},
"shippingAddress.postalCode": {
"Source": "_source.address.zip",
"Target": "_profile.ShippingAddress.PostalCode"
},
"shippingAddress.city": {
"Source": "_source.address.city",
"Target": "_profile.ShippingAddress.City"
},
"personalEmailAddress": {
"Source": "_source.email",
"Target": "_profile.PersonalEmailAddress",
"ContentType": "EMAIL_ADDRESS"
},
"fullName": {
"Source": "{{_source.firstName}} {{_source.lastName}}"
},
"firstName": {
"Source": "_source.firstName",
"Target": "_profile.FirstName"
},
"lastName": {
"Source": "_source.lastName",
"Target": "_profile.LastName"
}
},
"Keys": {
"_email": [
{
"FieldNames": ["personalEmailAddress"]
}
],
"_fullName": [
{
"FieldNames": ["fullName"]
}
],
"_account": [
{
"StandardIdentifiers": ["PROFILE","UNIQUE"],
"FieldNames": ["accountId"]
}
]
}
}
```
Tenga en cuenta que se indexan `email` y `fullname`, pero no se utilizan para buscar el perfil. La cuenta es la clave única. Es necesario especificar el objeto. Cada vez que se realiza la ingesta de un objeto con el mismo ID de cuenta, se sobrescribe el objeto anterior con el mismo ID de cuenta.
En el objeto de perfil estándar se rellenan varios campos (consulte los campos que tienen `Target` definido).
## Una asignación de tipo de objeto que no rellena el perfil estándar
En este ejemplo se muestra un caso de uso más complicado. Realiza la ingesta de datos relacionados con un perfil, pero no rellena necesariamente el objeto de perfil estándar.
A continuación, se muestra el objeto entrante:
```
{
"email": "john@examplecorp.com",
"timestamp": "2010-01-01T12:34:56Z",
"subject": "Whatever this is about",
"body": "Body of ticket"
}
```
A continuación, se presenta una forma de asignar estos datos:
```
{
"Fields": {
"email": {
"Source": "_source.email",
"ContentType": "EMAIL_ADDRESS"
},
"timestamp": {
"Source": "_source.timestamp"
}
},
"Keys": {
"_email": [
{
"StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
"FieldNames": ["email"]
}
],
"ticketEmail": [
{
"StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
"FieldNames": ["email"]
}
],
"uniqueTicket": [
{
"StandardIdentifiers": ["UNIQUE"],
"FieldNames": ["email","timestamp"]
}
]
}
}
```
En este ejemplo se realiza la ingesta de los datos y, en la primera búsqueda, se efectúa la ingesta de la dirección de correo electrónico.
+ Si la dirección de correo electrónico coincide con un único perfil, se utiliza para asociar los datos a ese perfil específico. El identificador único del ticket se compone del correo electrónico y la marca temporal, ya que no existe otro identificador único.
+ Si no existe ningún perfil con el correo electrónico especificado, se creará uno nuevo con el único campo de `EmailAddress` rellenado. El objeto de ingesta se asocia a este nuevo **perfil inferido**. Las dos claves de búsqueda que pueden encontrar el perfil son `_email` y `uniqueTicket`.
+ Si existen varios perfiles con la dirección de correo electrónico especificada, se crea un nuevo perfil con el único campo de `EmailAddress` rellenado y el objeto se asocia a este nuevo perfil. Este perfil se crea con la clave `ticketEmail` definida, además de `_email` y `uniqueTicket`. Cualquier ticket posterior de ese correo electrónico se asigna a este nuevo **perfil inferido**. La razón es que la clave ` _email` se refiere a tres perfiles y, por tanto, se descarta; no obstante, la clave `ticketEmail` solo se refiere a un único perfil (el nuevo inferido) y sigue siendo válida.
+ En los casos en los que se crea un nuevo **perfil inferido**, el campo `EmailAddress` se rellena a partir del primer objeto que lo creó.
# Tipos de objeto de perfil implícito en Perfiles de clientes de Amazon Connect
Puedes usar cualquier tipo de objeto que coincida con el nombre del ID de una plantilla (tal y como lo devuelve la [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API) sin definirlo de forma explícita. El tipo de objeto coincidirá exactamente con la definición de la plantilla de este tipo de objeto. Si se define un tipo de objeto explícito, este reemplaza al implícito.
Los tipos de objetos implícitos se incluyen en la [ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html)API o se devuelven mediante [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html)las operaciones, pero se pueden eliminar si quieres eliminar todos los datos ingeridos de ese tipo de objeto.
# Asignación de datos impulsada por la IA generativa en Amazon Connect
Amazon Connect Customer Profiles ofrece una función generativa de mapeo de datos de clientes basada en la inteligencia artificial que reduce considerablemente el tiempo necesario para crear perfiles unificados, lo que permite ofrecer experiencias de cliente más personalizadas.
Con esta capacidad, cuando los administradores del centro de contacto agreguen datos de clientes desde cualquiera de los más de 70 conectores de datos sin código disponibles, como Adobe Analytics, Salesforce o Amazon Simple Storage Service (S3), los perfiles de los Amazon Connect clientes analizarán los datos de estas fuentes para determinar automáticamente cómo organizar y combinar los datos que existen en diferentes formatos en fuentes dispares en perfiles unificados. Amazon Connect Los administradores del centro de contacto pueden revisar y completar la configuración de los perfiles de los clientes, de modo que pueden proporcionar a los agentes información relevante sobre los clientes IVRs y personalizar dinámicamente los chatbots para mejorar la satisfacción del cliente y la productividad de los agentes.
La asignación de datos de clientes impulsada por la IA generativa está disponible en las siguientes regiones:
+ Este de EE. UU. (Norte de Virginia)
+ Oeste de EE. UU. (Oregón)
+ África (Ciudad del Cabo)
+ Asia-Pacífico (Singapur)
+ Asia-Pacífico (Sídney)
+ Asia-Pacífico (Tokio)
+ Asia-Pacífico (Seúl)
+ Canadá (Centro)
+ Europa (Fráncfort)
+ Europa (Londres)
## Configuración de la asignación de datos impulsada por la IA generativa
1. Abra la consola de perfiles de Amazon Connect clientes.
1. En la pestaña **Integraciones de orígenes de datos**, seleccione **Agregar integración de origen de datos**.
1. Configure la conexión. Seleccione el origen de datos en el menú desplegable que contiene todos los conectores compatibles disponibles.
![\[Seleccione el origen de datos en el menú desplegable que contiene todos los conectores compatibles disponibles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. Asignación de datos. Seleccione la opción para generar automáticamente la asignación de datos, elija una plantilla de asignación ya existente o cree una completamente nueva.
![\[Asignación de datos. Seleccione la opción para generar automáticamente la asignación de datos, elija una plantilla de asignación ya existente o cree una completamente nueva.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)
1. Resumen de la revisión de las asignaciones. Revise el resumen de los resultados de la asignación generada automáticamente que muestra todos los atributos del cliente. Modifique las claves de ingesta y confirme antes de iniciar la ingesta de datos. Para obtener más información sobre las asignaciones de campos y las claves, consulte [Detalles de la definición de asignación de tipos de objetos en Perfiles de clientes de Amazon Connect](object-type-mapping-definition-details.md).
![\[Resumen de la revisión de las asignaciones. Revise el resumen de los resultados de la asignación generada automáticamente que muestra todos los atributos del cliente. Modifique las claves de ingesta y confirme antes de iniciar la ingesta de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## Funcionamiento
El sistema tiene cuatro fases. En la primera fase, Perfiles de clientes busca los atributos de origen y, si están disponibles, toma muestras de los datos del origen de datos para, posteriormente, determinar el tipo de objeto más adecuado para el objetivo. En el caso de un origen de datos de Amazon S3, se utilizará como datos de ejemplo el primer archivo CSV del bucket y el prefijo de Amazon S3 seleccionados. Para otras fuentes de datos, Customer Profiles busca los atributos de la fuente a través AppFlow de ellas. En la segunda fase, se utiliza un modelo de lenguaje grande (LLM) para procesar aún más cada uno de los atributos personalizados y asignarlos a los atributos estándar del perfil del cliente. El LLM se vuelve a utilizar en la tercera fase para seleccionar los atributos adecuados que pueden servir como claves, como los identificadores de los clientes. Finalmente, en la cuarta fase, el detector de formato de marca de tiempo analiza las marcas de tiempo para mantener el orden cronológico correcto de los registros. El sistema puede generar la asignación de hasta 120 atributos en menos de 20 segundos después de combinar los resultados de la predicción.
## Resolución de problemas de la asignación de datos impulsada por la IA generativa
En las siguientes secciones se muestran los posibles mensajes de error que puede encontrar. También se proporcionan la causa y la resolución de cada problema.
### Error: no se ha podido analizar la cadena de objetos en JSON
La cadena de objetos de la solicitud no es un JSON válido. Revise la cadena de objetos de la solicitud y compruebe que es un JSON válido.
### Error: el valor de Objects no ha cumplido con la restricción de seguridad; el miembro debe tener un valor menor o igual a 5
Hay demasiados objetos en la solicitud. Se permiten hasta cinco objetos en una solicitud. Reduzca el número de objetos a cinco o menos.
### Error: se ha superado el límite de 120 atributos
Se permiten hasta 120 atributos en un objeto JSON, incluidos los atributos JSON anidados. Elimine algunos atributos del objeto JSON que no sea necesario asignar.
![\[Se permiten hasta 120 atributos en un objeto JSON, incluidos los atributos JSON anidados. Elimine algunos atributos del objeto JSON que no sea necesario asignar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### Advertencia: no hemos encontrado ninguna **clave única** que distinga sus datos. No hemos encontrado ninguna **clave de perfil** que identifique sus perfiles.
El modelo no ha encontrado ningún tipo de objeto válido en un objeto determinado. Cambie la entrada o utilice el enfoque de asignación manual, tal como se sugiere.
![\[El modelo no ha encontrado ningún tipo de objeto válido en un objeto determinado. Cambie la entrada o utilice el enfoque de asignación manual, tal como se sugiere.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)
# Límites de datos de Perfiles de clientes de Amazon Connect
Los perfiles de clientes de Amazon Connect le permiten personalizar la incorporación de datos mediante el establecimiento de límites de ingesta de datos en varios tipos de datos de clientes que se utilizan para crear un perfil unificado. Establecer límites en las asignaciones de datos le permite priorizar la cantidad de datos que debe ingerir en todas las asignaciones. El límite máximo predeterminado en todas las asignaciones por perfil es 1000.
**nota**
Los límites de datos son estimaciones y pueden variar ligeramente, con una posible desviación de algunas unidades en cualquier dirección durante los periodos de alta ingesta en un solo perfil.
## Configuración de los límites de datos en Perfiles de clientes
1. Abra la consola de perfiles Amazon Connect de clientes.
1. Seleccione la pestaña **Límites de datos** para configurar los límites de los objetos de datos.
![\[Vaya a la pestaña Límites de datos para configurar los límites de los objetos de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. Coloque el cursor sobre el límite del objeto de datos deseado y seleccione el icono de edición.
![\[Coloque el cursor sobre el límite del objeto de datos deseado y seleccione el icono de edición.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. Indique el límite y haga clic en el icono de marca de verificación para guardar o actualizar el límite.
![\[La imagen muestra que se está introduciendo un nuevo límite y resalta el icono de marca de verificación que se utiliza para guardar o actualizar el límite.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## Borrado de los límites de datos en Perfiles de clientes
1. Seleccione el botón de opción del objeto de datos cuyo límite desea borrar. A continuación, podrá elegir **Borrar límite**.
![\[Resalta el botón de opción situado a la izquierda del objeto de datos en la página de límites de datos. Si selecciona aquí un botón de opción, podrá activar el botón de borrado para establecer el límite de datos del objeto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. Escriba *confirmar* para borrar el valor límite del objeto de datos que ha seleccionado.
![\[Un cuadro emergente en el que se le pide que confirme que desea borrar el valor límite del objeto de datos. Para confirmar la acción de borrado, escriba confirmar en minúsculas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)
# Creación e ingesta de datos de clientes en Perfiles de clientes
Puede definir datos de cualquier origen mediante Amazon S3 y enriquecer sin complicaciones un perfil de cliente sin necesidad de integraciones personalizadas ni prediseñadas. Por ejemplo, supongamos que desea proporcionar a los agentes información pertinente sobre el historial de compras. Puede importar datos de transacciones de compra de una aplicación interna a un archivo de hoja de cálculo en S3 y, a continuación, vincularlos a un perfil de cliente.
Para realizar esta configuración, debe definir una [asignación de tipo de objeto](customer-profiles-object-type-mapping.md) que describa el aspecto del objeto de perfil personalizado. Esta asignación define cómo pueden utilizarse los campos de sus datos para rellenar los campos del perfil estándar o cómo puede utilizarse para asignar los datos a un perfil específico.
Después de crear el mapeo de tipos de objeto, puede usar la [PutProfileObject](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html)API para cargar los datos de perfil personalizados de su CRM al objeto de perfil personalizado.
**nota**
Perfiles de clientes no permite realizar la ingesta de datos procedentes de encabezados CSV que contengan notación de puntos.
Para obtener una lista de los permisos de IAM necesarios para que los perfiles de clientes accedan a los datos del bucket de Amazon S3 para la asignación de datos, consulte `PutProfileObject` en la tabla de [Acciones definidas por los perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions).
## Ingesta del perfil del cliente
**Ingesta de perfiles basados en cuentas**
1. Cargue archivos de datos en S3. La ingesta de los perfiles a los que se hace referencia en los perfiles de cuenta y de los propios perfiles de cuenta debe realizarse por separado.
1. El nuevo archivo utilizado para la ingesta de perfiles de cuentas debería incluir nuevos atributos: el tipo de perfil y las preferencias de interacción para el correo electrónico y el teléfono.
1. Ingiera archivos de S3 en el perfil del cliente mediante la consola de AWS.
**Perfiles CSV de muestra (a los que se hace referencia en los siguientes perfiles basados en cuentas)**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Ejemplos de perfiles CSV basados en cuentas**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**Ejemplo de preferencias de interacción mediante correo electrónico**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"}
]
```
**Ejemplo de preferencias de interacción mediante teléfono**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"}
]
```
**nota**
Por ejemplo **ProfileType**`PROFILE`, puedes incorporar y añadir las preferencias de participación mediante el mismo método.
1. Cree dos asignaciones de datos: una para los subperfiles y otra para los perfiles basados en cuentas.
![\[Cree una integración de dos orígenes de datos, cada una de las cuales creará una asignación basada en la relación descrita. Por ejemplo, cuentas/perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png)
1. A continuación, asigne los atributos del perfil de clientes. Observe el destino denominado `ProfileType`.
![\[A continuación, asigne los atributos del perfil de clientes. Anota el destino al que se llama ProfileType.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png)
**Ejemplo de asignación de tipos de objetos para ingerir los perfiles a los que se hace referencia en los perfiles basados en cuentas**
```
{
"AllowProfileCreation": true,
"Description": "Standard Profile Object Type",
"Fields": {
"FirstName": {
"ContentType": "STRING",
"Source": "_source.FirstName",
"Target": "_profile.FirstName"
},
"LastName": {
"ContentType": "STRING",
"Source": "_source.LastName",
"Target": "_profile.LastName"
},
"PhoneNumber": {
"ContentType": "PHONE_NUMBER",
"Source": "_source.PhoneNumber",
"Target": "_profile.PhoneNumber"
},
"PersonalEmailAddress": {
"ContentType": "EMAIL_ADDRESS",
"Source": "_source.PersonalEmailAddress",
"Target": "_profile.PersonalEmailAddress"
},
"State": {
"ContentType": "STRING",
"Source": "_source.State",
"Target": "_profile.Address.State"
},
"CustomerId": {
"ContentType": "STRING",
"Source": "_source.CustomerId",
"Target": "_profile.Attributes.CustomerId"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
}
},
"Keys": {
"CustomerId": [
{
"FieldNames": [
"CustomerId"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Repita el proceso para ingerir perfiles basados en cuentas. Tenga en cuenta EngagementPreferences .Correo electrónico y EngagementPreference .Teléfono.
![\[Repita el proceso para ingerir perfiles basados en cuentas. Nota: EngagementPreferences .Correo electrónico y .Teléfono. EngagementPreference\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png)
**Ejemplo de asignación de tipos de objetos para ingerir los perfiles basados en cuentas**
```
{
"AllowProfileCreation": true,
"Description": "Account-based profiles Object Type",
"Fields": {
"AccountNumber": {
"ContentType": "STRING",
"Source": "_source.AccountId",
"Target": "_profile.AccountNumber"
},
"PrimaryOwner": {
"ContentType": "STRING",
"Source": "_source.PrimaryOwner",
"Target": "_profile.Attributes.PrimaryOwner"
},
"SecondaryOwner": {
"ContentType": "STRING",
"Source": "_source.SecondaryOwner",
"Target": "_profile.Attributes.SecondaryOwner"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
},
"EmailEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.EmailEngagementPreferences",
"Target": "_profile.EngagementPreferences.Email"
},
"PhoneEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.PhoneEngagementPreferences",
"Target": "_profile.EngagementPreferences.Phone"
}
},
"Keys": {
"Account": [
{
"FieldNames": [
"AccountNumber"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. Cree una integración de dos orígenes de datos, cada una de las cuales creará una asignación basada en la relación descrita. Por ejemplo, cuentas/perfiles.
**nota**
La ingesta de perfiles basados en cuentas solo debe realizarse después de verificar la ingesta correcta de los perfiles a los que se hace referencia en los perfiles basados en cuentas mediante la [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API o las métricas de perfil de la consola de perfiles de clientes de Amazon Connect.
La asignación generada de forma automática no funciona a la hora de ingerir perfiles basados en cuentas y sus subperfiles.
Las preferencias de la lista de contactos de direcciones de correo electrónico y teléfonos puede incluir `KeyName` y `KeyValue` o `ProfileId` para hacer referencia a los perfiles secundarios. `KeyName` debe ser el identificador único.
Las actualizaciones de los subperfiles no actualizan las preferencias de interacción en los perfiles basados en cuentas. Las actualizaciones deben realizarse a través de la ruta de ingesta.
# Creación una integración de Kinesis con Perfiles de clientes de Amazon Connect
Los siguientes pasos describen el proceso de transmisión de objetos desde un flujo de datos de Amazon Kinesis a Perfiles de clientes de Amazon Connect. La integración consta de dos pasos principales:
1. Configure una EventBridge tubería para transmitir datos desde su transmisión de datos de Kinesis a un EventBridge bus.
1. Configure una integración de datos de perfiles de clientes con su Kinesis Data Stream mediante el canal creado. EventBridge
## Paso 1: Transmita datos de Kinesis a EventBridge
1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)
1. En el panel de navegación, seleccione **Buses de eventos**.
1. Seleccione **Crear bus de eventos**.
1. En la sección **Información del bus de eventos**, proporcione un nombre descriptivo. Por ejemplo, `kinesis-to-customer-profiles`.
1. Seleccione **Crear**.
1. Vaya a la página de detalles Flujo de datos de Kinesis.
1. Seleccione la pestaña **EventBridge Pipes** y elija **Connect Kinesis Data Stream to** Pipe.
1. Cree un nombre para su EventBridge tubería.
1. Siga el asistente de configuración hasta llegar a la página **Configuración de destino**.
1. Para el destino, seleccione el bus de eventos creado en el paso 1. Por ejemplo, `kinesis-to-customer-profiles`.
1. Después de la sección **Destino**, expanda el acordeón **Transformador de entrada de destino**.
1. Defina el transformador de entrada de destino de la siguiente manera:
```
{
"data": <$.data>
}
```
1. Seleccione **Crear canalización** para completar la configuración.
En este punto, ha configurado correctamente el enrutamiento de los eventos de Kinesis a. EventBridge A continuación, crearemos una integración con Perfiles de clientes.
## Paso 2: Incorporar EventBridge datos a los perfiles de los clientes
1. Vaya a **Perfiles de clientes** en la consola de Amazon Connect.
1. Seleccione la pestaña **Integraciones de orígenes de datos** y elija **Agregar integración de origen de datos**.
1. Seleccione **Kinesis** en el menú desplegable de **Origen de datos**.
1. **En el menú desplegable **del nombre de la EventBridge tubería**, seleccione la tubería que se creó en el paso 1 y elija Siguiente.**
1. En la página **Asignar datos**, seleccione la asignación de tipo de objeto correspondiente y elija **Siguiente**.
1. Revise la configuración en la página **Revisar e integrar** y elija **Agregar integración de origen de datos** para completar la configuración.
Su flujo de datos de Kinesis ahora está integrada con Perfiles de clientes de Amazon Connect y ya está preparado para enviar eventos de Kinesis a Perfiles de clientes.
# Exporte los datos unificados de su perfil de cliente
Amazon Connect Customer Profiles permite exportar datos en tiempo real de perfiles de clientes unificados a Amazon Kinesis Data Stream. Puede habilitar el streaming de datos y recibir automáticamente en su flujo de datos de Amazon Kinesis los datos de los nuevos perfiles y las actualizaciones de los perfiles existentes.
Puede conservar los datos de sus sistemas de origen, como CRMs las herramientas de automatización de marketing, up-to-date con la información más reciente de los perfiles de los Amazon Connect clientes. Por ejemplo, cuando un cliente llama al centro de contacto para actualizar su dirección, un agente puede realizar el cambio para agregar la nueva dirección del cliente y la información actualizada del perfil se envía a un flujo de datos de Kinesis en tiempo real.
Para realizar esta configuración, debe activar **Exportación de datos** en la consola de Perfiles de clientes.
## Habilitación de la exportación en tiempo real
**Para activar el streaming de datos para su dominio**
1. Abra la consola Amazon Connect de perfiles de clientes.
1. Seleccione la pestaña **Exportación de datos** y elija **Habilitar streaming de datos**.
![\[La exportación de datos en tiempo real habilita el flujo de datos de Kinesis.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. Elija **Habilitar streaming de datos** y seleccione un flujo de datos de Kinesis existente en el menú desplegable o elija **crear un nuevo flujo de datos de Kinesis** para abrir la consola de Kinesis y crear el flujo. Para obtener más información, consulte [Creación y administración de flujos](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
![\[La exportación de datos en tiempo real habilita el flujo de datos de Kinesis.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. Elija el botón **Habilitar streaming de datos** para guardar la configuración.
## Desactivación de la exportación en tiempo real
**Para desactivar el streaming de datos para su dominio**
1. Abra la consola Amazon Connect de perfiles de clientes.
1. Seleccione la pestaña **Exportación de datos** y elija **Deshabilitar streaming de datos**.
![\[La exportación de datos en tiempo real deshabilita el flujo de datos de Kinesis.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/disable-real-time-export-1.png)
## Carga útil de Kinesis de exportación en tiempo real
**Ejemplo de evento de salida en JSON**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
La versión actual del esquema.
**EventId**
El ID de evento único.
**EventTimestamp**
Marca de tiempo del evento utilizando el ISO8601 estándar.
**EventType**
El tipo de evento exportado.
Valores: CREATED, UPDATED y HEALTH\$1CHECK
+ CREADO: El evento de exportación fue para. CreateProfile
+ ACTUALIZADO: El evento de exportación fue para un UpdateProfile.
+ HEALTH\$1CHECK: El evento de exportación tenía por objeto garantizar que los perfiles de cliente pudieran funcionar correctamente en `putEvent` Kinesis Stream. HealthCheck
**DomainName**
El dominio al que pertenece el evento. `/Domain` del evento
**ObjectTypeName**
Tipo de objeto del evento
Valores: `_profile`, `_asset`, `_order` y `_case`. También puede usar un nombre de plantilla predefinido, por ejemplo, `Salesforce-Account` o un nombre de objeto personalizado que pueda crear mediante la API. [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
**AssociatedProfileId**
ID del perfil estándar al que está asociado el objeto. Solo está presente si el tipo de objeto no es `_profile`
**ProfileObjectUniqueKey**
El identificador único del ProfileObject generado por el servicio.
Tipo: cadena
**Object**
El perfil estándar u objeto de perfil estándar.
**IsMessageRealTime**
Marca para informar de si el mensaje es en tiempo real o se ha redireccionado.
**Ejemplo de carga en JSON**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# Solución de problemas de exportación de eventos en tiempo real a Kinesis Data Stream
Es posible que se produzca un retraso al exportar los eventos por primera vez a su Kinesis Data Stream. Esto se debe al tiempo que se tarda en propagar los permisos de IAM para el rol vinculado al servicio. Cuando se produce un problema real, el estado de la transmisión puede entrar en un estado de error.
![\[Los eventos no pueden llegar al Kinesis Data Streams de destino y se ha producido un estado de error.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
En las siguientes secciones se muestran los posibles mensajes de error que puede encontrar. También se proporcionan la causa y la resolución de cada problema.
## Error: el flujo de datos de Kinesis no está activo. Compruebe la configuración y vuelva a crear el flujo de eventos más adelante
El flujo de datos de Kinesis de destino no se encuentra en el estado `ACTIVE`. Esto puede ocurrir cuando se está creando o eliminando el flujo de datos de Kinesis. Para resolver el error, asegúrese de que su flujo de datos Kinesis se encuentra en estado ACTIVO y vuelva a activar la configuración de streaming de datos.
## Error: el flujo de datos de Kinesis no existe. Vuelva a crear el flujo de evento con un destino de flujo de datos Kinesis válido
Se ha eliminado el flujo de datos de Kinesis de destino. Para resolver el error, vuelva a activar el streaming de datos con un flujo de datos de Kinesis existente como destino.
## Error: se está limitando el flujo de datos Kinesis. Considere la posibilidad de aprovisionar adecuadamente un mayor rendimiento de Kinesis
El flujo de datos Kinesis de destino se está limitando (aprovisionamiento insuficiente). Para resolver el error, asegúrese de que el flujo de datos Kinesis de destino tiene un recuento de particiones suficiente y, a continuación, vuelva a activar el streaming de datos.
## Error: se está limitando la clave de KMS utilizada para cifrar el flujo de datos de Kinesis. Considere la posibilidad de aumentar la cuota de solicitudes de KMS de forma adecuada
Se está limitando la clave de KMS que usa el flujo de datos de Kinesis. Para resolver el error, vuelva a habilitar el flujo de datos.
## Error: compruebe la configuración de la clave de KMS de su flujo de datos de Kinesis
Perfiles de clientes no puede acceder a la clave de KMS que utiliza el flujo de datos de Kinesis. Esto puede ocurrir cuando su clave de KMS tiene una política de claves que deniega el acceso desde el rol vinculado al servicio de Perfiles de clientes o la clave no tiene el estado Activado. Para resolver el error, asegúrese de que la política de claves de KMS no deniega el acceso desde el rol vinculado al servicio de Perfiles de clientes y de que la clave tiene el estado Activado. Para resolver el error, vuelva a habilitar el streaming de datos.
# Configuración de la exportación masiva de todos los datos unificados del perfil de cliente
**nota**
Para completar los pasos de este tema, debe tener conocimientos de desarrollador y experiencia en el uso AWS KMS de Amazon S3.
Cuando Perfiles de clientes de Amazon Connect crea un perfil de cliente unificado, mejora, refina y mejora los datos y la información sin procesar para convertirlos en un perfil más preciso al combinar datos de fuentes propias y de terceros. Perfiles de clientes también mejora la calidad de los conjuntos de datos mediante la incorporación de nuevos datos. Puede utilizar los conjuntos de datos mejorados para otros casos de uso, por ejemplo, para formular estrategias de marketing, ventas y servicio al cliente más fundamentadas y específicas. Por ejemplo, tal vez desee aprovechar el perfil de cliente unificado para:
+ auditar los datos de los clientes que tiene en la totalidad de un dominio,
+ realizar análisis internos, por ejemplo, para los informes de ventas y marketing,
+ exportar los datos a sus propias herramientas o a productos de terceros para personalizar los anuncios y segmentar los clientes.
Para aprovechar los datos unificados del perfil del cliente para otros casos de uso, puede exportarlos de forma masiva a Amazon S3. En este tema, se explica cómo hacerlo.
**Topics**
+ [
## Paso 1: configurar una clave de KMS y un bucket de S3
](#enable-cpbulk-export)
+ [
## Paso 2: crear un trabajo de exportación masiva
](#create-bulk-export-job)
+ [
## Paso 3: comprobar el estado de un trabajo de exportación masiva
](#check-status-bulk-cp-export)
+ [
## Paso 4: ver los datos exportados en S3
](#view-bulk-cp-export)
+ [
## Actualización del trabajo de exportación masiva
](#update-bulk-cp-export)
+ [
## Eliminación o cancelación del trabajo de exportación masiva (no se admite)
](#delete-bulk-cp-export)
## Paso 1: configurar una clave de KMS y un bucket de S3
Para habilitar la exportación masiva de su dominio, tiene que configurar los recursos siguientes:
+ [Una clave de KMS con una política de recursos específica](#cp-kms)
+ [Un bucket de S3 de destino con una política de recursos específica](#cp-s3-bulk). No configure [las listas de control de acceso (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) en el bucket.
Estos pasos se explican a continuación.
### Creación de una nueva clave KMS o reutilización de una clave KMS existente
Para configurar una clave de KMS para la exportación masiva, debe crear o reutilizar una clave de KMS existente que se encuentre en la misma AWS región que el bucket de Amazon S3 que planea configurar como destino de exportación masiva. Debe permitir que el AppIntegrations servicio Amazon Connect realice acciones de KMS para la clave.
Añada la siguiente declaración a la ** política de claves**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Enable AppIntegrations access to KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root"
],
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### Configuración de un bucket de destino de S3
Debe configurar un bucket nuevo o existente en la misma AWS región que la clave de KMS y configurar una política de recursos en el bucket de S3.
Al configurar el bucket, asegúrese de seleccionar **Cifrado con SSE-KMS** y de utilizar la misma clave de KMS del procedimiento anterior. Además, no la habilite ACLs en el bucket de S3.
A continuación, se muestra un ejemplo de la política de recursos.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow AppIntegrations to write data to destination bucket",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## Paso 2: crear un trabajo de exportación masiva
Para crear un trabajo de exportación masiva, invoca el siguiente Amazon Connect AppIntegrations APIs:
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): Esta API crea una integración con la fuente de datos (por ejemplo, los perfiles de los clientes).
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): Esta API escribe datos en el destino (por ejemplo, un bucket de S3) mediante la fuente de datos.
A continuación encontrará más información sobre cómo llamarlos APIs.
### Creación de una integración de datos
Una integración de datos representa el *origen de datos* de sus datos. Puede llamar a la [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API o ejecutar el comando [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI para crear una integración de datos. Debe proporcionar un *tipo de objeto* de Perfiles de clientes y un *dominio* de Perfiles de clientes.
Si desea exportar varios tipos de objetos, debe crear una integración de datos aparte para cada uno de ellos. Por ejemplo, si desea exportar los objetos `_profile` y `_asset`, debe crear dos integraciones de datos independientes.
**nota**
Es posible que los datos ingeridos en los últimos 30 minutos no se incluyan en la exportación.
El siguiente ejemplo de código muestra cómo ejecutar el comando [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI.
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "bulk-export-job-01" \
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \
--source-uri "AmazonConnect://AppIntegrations" \
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
```
En el siguiente ejemplo de código se muestra cómo llamar a la [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API.
```
{
"Description": "Data integration for _profile objects",
"KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
"Name": "unique-data-integration-name-01",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"my-domain-pdx"
],
"objectType": [
"_profile"
]
}
}
}
```
### Creación de una asociación de integración de datos
Una asociación de integración de datos representa el destino al que desea exportar los datos y un intervalo de tiempo para elegir qué datos exportar. Puede llamar a la [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API o ejecutar el comando [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI para crear una integración de datos. El intervalo de tiempo se configura con las propiedades `StartTime` y `EndTime`. Este intervalo de tiempo se corresponde con el momento en que los objetos se actualizaron por última vez en Perfiles de los clientes.
El bucket de S3 de destino que especifique puede ser solo el nombre del bucket o puede incluir una carpeta adicional o un prefijo de S3 al que desee que se exporten los datos.
**nota**
Para conocer la cuota de **trabajos de exportación masiva simultánea**, consulte [Amazon Connect Perfiles de clientes, cuotas de servicio](amazon-connect-service-limits.md#customer-profiles-quotas). Una vez que se complete o falle un trabajo de exportación en bloque, ya no se tendrá en cuenta para la cuota de simultaneidad.
El siguiente ejemplo de código muestra cómo ejecutar el comando [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI.
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
En el siguiente ejemplo de código se muestra cómo llamar a la [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API.
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## Paso 3: comprobar el estado de un trabajo de exportación masiva
Para ver el estado de su trabajo de exportación masiva, puede llamar a la [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API o ejecutar el comando [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
El siguiente ejemplo de código muestra cómo ejecutar el comando [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"
```
## Paso 4: ver los datos exportados en S3
Cuando la asociación de integración de datos esté activa en `IN_PROGRESS`, empezará a ver cómo se copian los datos en el bucket de S3.
Los datos exportados se escriben con la siguiente estructura de rutas:
+ \$1BucketNameAndFolderName\$1
+ \$1AwsAccountId\$1
+ \$1DomainName\$1
+ \$1RequestTimestamp\$1
+ \$1lStartTime\$1-\$1EndTime\$1
+ \$1ObjectTypeName\$1
+
A continuación, se muestra un ejemplo de una ruta.
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## Actualización del trabajo de exportación masiva
Una vez finalizado el trabajo, puede actualizar la asociación de integración de datos especificando horas diferentes para el inicio y la finalización de la extracción de datos. Con ello, se crea un nuevo trabajo de exportación masiva. Tal vez desee hacerlo si ha realizado una exportación masiva en el pasado y solo desea exportar los datos que se hayan actualizado desde la exportación anterior. Por ejemplo, si el último trabajo de exportación masiva se hizo hace tres meses, puede actualizar la asociación de integración de datos con un intervalo de tiempo comprendido entre hace tres meses y el día de hoy.
Puede llamar a la [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API o ejecutar el comando [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI para actualizar el trabajo de exportación.
El siguiente ejemplo de código muestra cómo ejecutar el comando [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI.
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
## Eliminación o cancelación del trabajo de exportación masiva (no se admite)
No puede eliminar ni cancelar la exportación masiva. Una vez finalizado un trabajo de exportación, ya no cuenta para la cuota de exportación.
# Eliminación de un dominio de Perfiles de clientes de Amazon Connect
Al eliminar asignaciones, solo se eliminarán los objetos y datos asociados a esa asignación específica. Si hay varios objetos asociados a un perfil, es posible que al eliminar una asignación concreta no se borren los datos de perfil. Si deseara eliminar datos específicos, eliminaría la asignación, pero sus perfiles pueden seguir existiendo si contienen datos de otras asignaciones. Esto podría dar lugar a cargos adicionales para los perfiles existentes. Para evitar que esto ocurra, puede eliminar su dominio de Perfiles de clientes mediante la consola de Amazon Connect siguiendo estos pasos.
1. Inicie sesión en la Amazon Connect consola y seleccione Perfiles de clientes en el panel de navegación izquierdo. Elija su dominio de Perfiles de clientes y, a continuación, elija **Ver detalles**.
![\[La página de eliminación de dominio de Perfiles de clientes de Amazon Connect y el botón para ver detalles del dominio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png)
1. Elija **Delete domain (Eliminar dominio)**.
![\[La página de eliminación de dominio de Perfiles de clientes de Amazon Connect y el botón para eliminar el dominio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png)
1. Para eliminar su dominio, introduzca *confirmar* en el cuadro y elija **Eliminar dominio**.
![\[La página de eliminación de dominio de Perfiles de clientes de Amazon Connect y el botón para confirmar la eliminación del dominio después de escribir confirmar manualmente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png)
# Configuración de los atributos calculados en Perfiles de clientes de Amazon Connect
Los *atributos calculados* son valores que se derivan de otros atributos mediante fórmulas. Puede utilizarlas para identificar los comportamientos agregados de los usuarios.
Puede crear atributos calculados para definir su propia lógica empresarial y transformar así sus datos de perfil de cliente en puntos de datos procesables. Esto le permite personalizar experiencias automatizadas, como las respuestas de voz interactivas.
Mediante el uso de atributos calculados, puede identificar los atributos clave sobre el comportamiento anterior de los clientes. Por ejemplo:
+ El último sitio web visitado o el último agente con el que se habló
+ Patrones de comportamiento, como el canal y la frecuencia de contacto preferidas
+ El valor del cliente, como los nuevos clientes y el tamaño medio del ticket
Puede utilizar la API de atributos calculados para crear un nuevo atributo mediante operaciones de agregación habituales como promedio, recuento, mínimo, máximo y suma.
Los atributos calculados transforman automáticamente los datos brutos en tiempo real en puntos de datos y métricas procesables. Los administradores del centro de contacto pueden definir y configurar cálculos basados en los datos brutos disponibles en los perfiles de clientes. Estos atributos calculados le facilitan la creación de experiencias automatizadas como la respuesta de voz interactiva (IVR) o los chatbots. Puede crear experiencias personalizadas y ayudar a los agentes a entender el contexto del cliente con mayor rapidez.
Para obtener una lista de AWS las regiones en las que APIs están disponibles los atributos calculados, consulte[Disponibilidad por región de API de atributos calculados de Perfiles de clientes](regions.md#customerprofiles_calculatedattributesregion).
**Topics**
+ [Introducción a los atributos calculados](customerprofiles-calculated-attributes-admin-website.md)
+ [Atributos calculados APIs](customerprofiles-calculated-attributes-apis.md)
+ [Creación de una definición de atributo calculado personalizada](customerprofiles-calculated-attributes-creating-definition.md)
+ [Validación de los valores de atributos calculados](customerprofiles-calculated-attributes-validating-values.md)
+ [Atributos calculados predeterminados](customerprofiles-default-calculated-attributes.md)
+ [Mensajes de error y soluciones](customerprofiles-calculated-attributes-troubleshooting.md)
# Cómo empezar con los atributos calculados en los perfiles de los Amazon Connect clientes
Utilice los atributos calculados para definir su propia lógica empresarial y transformar así sus datos de perfil de cliente en puntos de datos procesables para personalizar experiencias automatizadas, como las respuestas de voz interactivas.
Mediante el uso de atributos calculados, puede identificar los atributos clave sobre el comportamiento anterior de los clientes, sus patrones de comportamiento y su valor.
En los temas de esta sección se muestra cómo crear, ver, editar y eliminar atributos calculados.
**Topics**
+ [Creación de atributos calculados.](calculated-attributes-admin-website-create.md)
+ [Configuración de filtros de eventos](calculated-attributes-admin-website-event-filters.md)
+ [Visualización de los atributos calculados](calculated-attributes-admin-website-view.md)
+ [Edición de atributos calculados](calculated-attributes-admin-website-edit.md)
+ [Eliminación de atributos calculados](calculated-attributes-admin-website-delete.md)
# Creación de atributos calculados en Amazon Connect
1. Requisitos previos: asegúrese de tener los permisos de perfil de seguridad necesarios. Para obtener más información, consulte [Actualización de los permisos de los atributos calculados en Perfiles de clientes de Amazon Connect](security-profile-customer-profile-calc-attribs.md).
1. En el sitio web de Amazon Connect administración, vaya a **Perfiles de clientes**, **Atributos calculados** y elija **Crear atributo** en la vista de tabla de **atributos calculados**.
![\[La pestaña Perfiles de clientes en el espacio de trabajo del agente con el botón Asociar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)
1. Para crear un atributo calculado, asigne un nombre descriptivo, añada la descripción (opcional) con la información sobre el atributo y configure los campos obligatorios:
+ **Cálculo:** define cómo se calculan los atributos (average/count/sum/minimum/first occurrence/last occurrence/maxaparición).
+ **Atributo:** es un punto de datos de los perfiles de sus clientes
**nota**
Si selecciona un atributo de un tipo de objeto estándar (`_asset`,`_case`,`_order`), los atributos deben estar incluidos PascalCase. Esto significa que la primera letra de cada palabra del nombre del atributo se escribe con mayúscula. Por ejemplo, `_case.CreatedBy` o `_order.TotalPrice`.
![\[La pestaña Perfiles de clientes en el espacio de trabajo del agente con el botón Asociar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)
1. Además, puede añadir otro atributo seleccionando el icono del *signo más*. Puede elegir hasta dos atributos para calcularlos y combinarlos con un operador. Especifique un operador como *más* o *menos* para combinar los valores de los atributos.
![\[La pestaña Perfiles de clientes en el espacio de trabajo del agente con el botón Asociar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)
1. Una vez seleccionado el cálculo, puede configurar opcionalmente el número de eventos, el período de tiempo y la marca de tiempo de origen. De forma predeterminada, los atributos calculados están configurados para usar eventos ilimitados, un período de tiempo ilimitado y una marca de tiempo basada en la fecha de ingesta.
Se devolverá un resultado cuando haya al menos un evento durante el período de tiempo especificado.
+ **Número de eventos:** configure el límite o utilícelo de forma ilimitada (predeterminado)
+ **Período de tiempo:** establezca un período de tiempo específico o utilícelo de forma ilimitada (predeterminado)
+ **Marca de tiempo de origen:** elija entre un campo de marca de tiempo específico o una fecha de ingesta (predeterminada)
**nota**
Si bien no hay límite de eventos, existe un límite de tamaño de datos en el que los datos más antiguos se sustituirán por datos más nuevos. La marca de tiempo de origen no se puede cambiar una vez creada.
![\[La pestaña Perfiles de clientes en el espacio de trabajo del agente con el botón Asociar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)
1. Si lo desea, puede definir criterios para incluir solo los eventos relevantes en los cálculos. Para obtener más información, consulte [Configuración de filtros de eventos](calculated-attributes-admin-website-event-filters.md).
1. Elija **Crear** para crear el atributo calculado.
1. Después de crear un atributo calculado correctamente, se muestra un banner en la vista de tabla para usar el atributo calculado en un flujo o segmento. También podrá ver el estado de los atributos calculados en función de la disponibilidad.
![\[Un banner que indica que se ha creado el atributo calculado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)
# Configuración de filtros de eventos
Los filtros de eventos permiten filtrar los objetos del perfil que se van a utilizar en el atributo calculado. Por ejemplo, un filtro de eventos podría filtrar los objetos de activos estándar del cliente para que solo se incluyan en el cálculo los activos con el **estado Instalado o Registrado**.
**nota**
No puede editar los filtros de eventos después de crear una definición de atributo calculada.
Al crear un atributo calculado, puede crear uno o más filtros de eventos. Un filtro de eventos consta de los siguientes componentes:
![\[Componentes del filtro de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)
+ **Grupos de filtros**: grupo de filtros que se aplican a los objetos del perfil. Puede añadir varios grupos de filtros que estén conectados mediante relaciones OR.
+ **Filtros**: filtran los objetos del perfil que se incluyen en el cálculo del atributo calculado especificando los atributos, los operadores y los valores. Puede agregar tantos filtros como necesite para su caso de uso.
+ **Atributo**: el atributo del objeto por el que se va a filtrar. Puede seleccionar los atributos de los objetos almacenados en el dominio de Perfiles de clientes o utilizar los nombres de campo definidos en la definición del tipo de objeto. Para obtener más información sobre las asignaciones de tipos de objeto, consulte [Detalles de la definición de asignación de tipos de objetos en Perfiles de clientes de Amazon Connect](object-type-mapping-definition-details.md).
**nota**
En el sitio web de Amazon Connect administración, el menú desplegable de atributos muestra la marca de tiempo de la última vez que se guardó o actualizó un objeto de perfil con el atributo.
Si hay un atributo de un objeto de perfil y un campo de un tipo de objeto con el mismo nombre, el filtro de eventos prioriza el nombre del campo del tipo de objeto en su filtrado. Por ejemplo, si un objeto de perfil tiene un atributo denominado **Estado** y también hay un campo de tipo de objeto denominado **Estado**, el filtro utilizará el campo de tipo de objeto **Estado** para filtrar.
+ **Operador**: es el operador que determina la relación del atributo con el valor que introduzca. Para obtener más información, consulte [Operadores de filtro](#calculated-attributes-admin-website-event-filter-operators)
+ **Valor**: es el valor con el que se filtran los objetos. Puede especificar varios valores conectados por relaciones OR. Por ejemplo, *El estado del activo es Instalado o Registrado*. Tenga en cuenta que los valores distinguen entre mayúsculas y minúsculas. Por ejemplo, *El estado del activo es Instalado*, devuelve resultados diferentes a los de *El estado del activo es instalado*. Para ver los objetos de perfil, utilice la [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API de perfiles de clientes de Amazon Connect.
Si lo desea, puede crear hasta dos filtros de eventos y crear una relación (AND/OR/EXCLUDE) entre ellos. Para obtener más información sobre la relación, consulte[Relación entre los filtros de eventos](#calculated-attributes-admin-website-relationship-between-event-filters).
## Operadores de filtro
Los operadores determinan la relación del atributo con el valor que ingrese. A continuación, se describen los operadores disponibles.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)
**nota**
Los atributos calculados en el sitio web de Amazon Connect administración utilizan la zona horaria UTC y la hora predeterminada de 00:00:00 UTC para todos los filtros basados en el tiempo. Puedes filtrar por fechas, pero las horas se registran con el mismo valor. Si indica la fecha de 2024-01-01, la consola transfiere la hora como 2024-01-01T00:00:00Z.
**nota**
De forma predeterminada, los filtros de eventos se evalúan cuando se guarda o actualiza un objeto de perfil. Por ejemplo, si filtra los objetos de activo estándar donde la `PurchaseDate` está dentro de la última semana, el tiempo relativo se calcula como *dentro de la última semana desde el momento en que se guarda o actualiza el objeto de activo*. Esto significa que los resultados del filtrado pueden variar en función del momento en que se guarde o actualice el objeto.
## Relación entre los filtros de eventos
Si lo desea, puede añadir el segundo filtro de eventos y definir una relación con el primer filtro de eventos. Al crear un atributo calculado en el sitio web de administración de Amazon Connect , puede tener un máximo de dos filtros de eventos por atributo calculado. Si añade el segundo filtro de eventos al atributo calculado, puede elegir una de las dos formas para especificar cómo se conectan los dos filtros de eventos:
+ **Relación AND**: si utiliza la relación AND para conectar dos filtros de eventos, los objetos que cumplan con el primer y el segundo filtros de eventos se incluirán en el cálculo.
+ **Relación AND**: si utiliza la relación OR para conectar dos filtros de eventos, los objetos que cumplan con el primer o el segundo filtros de eventos se incluirán en el cálculo.
+ **Relación EXCLUDE**: si utiliza la relación EXCLUDE para conectar dos filtros de eventos, los objetos que cumplan con el primer filtro de eventos pero no cumplan con el segundo, se incluirán en el cálculo.
## Siguientes pasos
+ [Uso del atributo calculado en el centro de contacto a través del editor Flujo](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes)
+ [Uso del atributo calculado para definir un segmento de clientes](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+ [Ver los atributos calculados en Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html)
+ [Edición de atributos calculados en Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html)
+ [Eliminar atributos calculados en Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html)
# Visualización de los atributos calculados en Amazon Connect
1. Inicie sesión en el sitio web de Amazon Connect administración en https://*instance name*.my.connect.aws/. Utilice una cuenta de administrador o una cuenta asignada a un perfil de seguridad que tengan asignado el permiso **Perfiles de cliente: atributos calculados**.
1. En el panel de navegación izquierdo de Amazon Connect, elija **Perfiles de clientes**, **Atributos calculados**.
1. En la página **Atributos calculados**, elija un atributo calculado en la columna **Nombre** de la tabla.
La imagen siguiente muestra un ejemplo de los atributos calculados que aparecen en la columna **Nombre**.
![\[Tabla que muestra una lista de los atributos calculados.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)
1. Ahora podrá ver los detalles del atributo que ha seleccionado. En la siguiente imagen se muestra una página de detalles de un atributo calculado.
![\[Vista detallada de un atributo calculado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)
# Edición de atributos calculados en Amazon Connect
1. Para editar un atributo calculado, elija un atributo en la vista de tabla seleccionando el botón de selección, que activa el botón **Editar**. Elija **Edit (Edición de)**.
![\[editar un atributo calculado\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)
1. Podrá editar la **Descripción**, el **Período de tiempo** y el **Número de eventos**. Cuando haya terminado, elija **Guardar**.
![\[Editar un atributo calculado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)
# Eliminación de atributos calculados en Amazon Connect
1. Para eliminar un atributo calculado, seleccione un atributo de la tabla pulsando el botón de selección situado junto al atributo que desee eliminar.
1. Una vez seleccionado, elija **Eliminar**.
1. En la ventana emergente **Eliminar atributo**, compruebe los detalles y escriba *Confirmar* para activar el botón **Eliminar**.
![\[Eliminar un atributo calculado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)
1. Elija **Eliminar**.
# Atributos calculados de los perfiles de clientes de Amazon Connect APIs
Puede utilizar el siguiente atributo calculado de los perfiles de cliente APIs
------
#### [ CreateCalculatedAttributeDefinition ]
**CreateCalculatedAttributeDefinition**
Permite crear un nuevo atributo calculado. Requiere un tipo de objeto existente en el dominio. Puede definir los atributos que desea extraer de un único objeto de origen y las operaciones matemáticas que se les aplicarán de forma agregada, así como el intervalo de tiempo y el recuento de objetos.
Tras la creación, los nuevos datos de objetos de ingesta en Perfiles de clientes se incluirán en el atributo calculado, que puede recuperarse para un perfil mediante la API `GetCalculatedAttributeForProfile`. Para utilizar también datos históricos, especifique `UseHistoricalData` como verdadero. Los campos `Readiness` y `Status` de la respuesta de la API proporcionarán información sobre el estado de la inclusión de datos históricos en el atributo calculado.
Al definir un atributo calculado, estará disponible para todos los perfiles de un dominio. Cada atributo calculado solo puede hacer referencia a uno ObjectType y, como máximo, a dos campos ObjectType.
**Solicitud**
```
POST /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
```
**Respuesta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Cuerpo de la solicitud**
+ **CalculatedAttributeName**
El nombre único (por dominio) del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **DisplayName**
Nombre para mostrar del atributo calculado.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obligatorio: no
+ **Descripción**
Descripción del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.
+ Obligatorio: no
+ **UseHistoricalData**
Indica si los datos históricos ingeridos antes de crear el atributo calculado deben incluirse en los cálculos.
+ Tipo: booleano
+ Obligatorio: no
+ **AttributeDetails**
Detalles de los atributos utilizados en la definición y las operaciones matemáticas implicadas entre los atributos. Consulte los siguientes componentes:
+ **Atributos**
Lista de elementos de atributo especificados en la expresión matemática.
+ **AttributeItem**
Los detalles de un único elemento de atributo especificado en la expresión matemática.
+ Name
+ Nombre de un atributo definido en un tipo de objeto de perfil.
+ Tipo: cadena
+ **Expression**
Expresión matemática que se realiza en los elementos de atributo proporcionados en la lista de atributos. Cada elemento de la expresión debe seguir la estructura de\$1 "\$1ObjectTypeName. AttributeName\$1\$1».
+ Ejemplo: `{ObjA.AttributeA} - {ObjA.AttributeB}`
+ Tipo: String
+ Solo admitimos las siguientes operaciones matemáticas: `+ - * /`
+ No se pueden realizar modificaciones en la expresión una vez que se ha creado una definición de atributo calculada
+ **Condiciones**
Define los criterios y el umbral de agregación de atributos calculados.
+ Tipo: objeto Conditions
+ Range
+ ObjectCount
+ Threshold
+ **Rango**
Periodo de tiempo relativo durante el que se incluyen los datos en la agregación.
+ Tipo: objeto Range
+ Value: periodo de tiempo de las unidades especificadas. `ValueRange` anula a Value.
+ Tipo: entero
+ Obligatorio: no
+ ValueRange: una estructura que permite a los clientes especificar un intervalo de tiempo relativo durante el cual se incluyen los datos en el atributo calculado. Utilice números positivos para indicar que el punto final está en el pasado y números negativos para indicar que está en el futuro. ValueRangeanula el valor.
+ Tipo: ValueRange
+ Obligatorio: no
+ Inicio
+ Hora en que se va a empezar a incluir objetos. Utilice números positivos para indicar que el punto de inicio está en el pasado y números negativos para indicar que está en el futuro.
+ Tipo: entero
+ Obligatorio: sí
+ Final
+ Hora en que se van a dejar de incluir objetos. Utilice números positivos para indicar que el punto de inicio está en el pasado y números negativos para indicar que está en el futuro.
+ Tipo: entero
+ Obligatorio: sí
+ TimestampSource: una expresión que especifica el campo del objeto JSON a partir del cual se debe analizar la fecha. La expresión debe seguir la estructura de\$1 "\$1ObjectTypeName. \$1\$1». Por ejemplo, si tu tipo de objeto es JSON MyType y la fuente es JSON`{"generatedAt": {"timestamp": "1737587945945"}}`, entonces TimestampSource debería serlo`"{MyType.generatedAt.timestamp}"`.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.
+ Obligatorio: no
+ TimestampFormat: Se especifica el formato del campo de fecha y hora de tu objeto JSON. Este valor debe ser EPOCHMILLI (para marcas de época de Unix con precisión de nivel) o ISO\$18601 (siguiendo el formato ISO\$18601 con precisión de second/millisecond nivel, con second/millisecond un desplazamiento opcional de Z o en el formato HH:MM o HHMM.). Por ejemplo, si el tipo de objeto es y el JSON de origen debería serlo. MyType `{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},` TimestampFormat `"ISO_8601"`
+ Unidad: unidad de tiempo
+ Valores válidos: días
+ Obligatorio: sí
+ Obligatorio: sí
+ Alcance inicial: máximo de 366 días
+ **ObjectCount**
Número de objetos de perfil utilizados para el atributo calculado.
+ Tipo: Number
+ Intervalo: de 1 a 100
+ Obligatorio: no
+ **Threshold**
La lógica de comparación para generar un atributo true/false calculado.
+ Tipo: objeto Threshold
+ Valor
+ Valor del umbral
+ Tipo: cadena
+ Requerido: no
+ Operador
+ Operador del umbral
+ Tipo: ENUM
+ Valores válidos:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obligatorio: no
+ **Estadística**
La operación de agregación que se va a realizar para el atributo calculado.
+ Tipo: ENUM
+ Valores válidos:
+ FIRST\$1OCCURRENCE
+ LAST\$1OCCURRENCE
+ COUNT
+ SUM
+ MINIMUM
+ MAXIMUM
+ AVERAGE
+ MAX\$1OCCURRENCE
------
#### [ UpdateCalculatedAttributeDefinition ]
**UpdateCalculatedAttributeDefinition**
Permite actualizar una definición de atributo calculada. Las actualizaciones se limitan al nombre para mostrar, la descripción, el intervalo de tiempo, el recuento de objetos y el umbral. Esta API admite actualizaciones parciales, por lo que solo es necesario incluir los parámetros que requieren actualización.
**nota**
Al actualizar Conditions:
Aumentar el intervalo de fechas de un atributo calculado no desencadenará la inclusión de datos históricos superiores al intervalo de fechas actual.
TimestampSource y TimestampFormat no se puede actualizar después de crear una definición de atributo calculada.
**Solicitud**
```
PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"DisplayName": "string",
"Description": "string",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
}
}
```
**Respuesta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Cuerpo de la solicitud**
+ **DisplayName**
Nombre para mostrar del atributo calculado.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ Obligatorio: no
+ **Descripción**
Descripción del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.
+ Obligatorio: no
+ **Condiciones**
Define los criterios y el umbral de agregación de atributos calculados.
+ Tipo: objeto Conditions
+ Range
+ ObjectCount
+ Threshold
+ **Rango**
Periodo de tiempo relativo durante el que se incluyen los datos en la agregación.
+ Tipo: objeto Range
+ Valor: periodo de tiempo de las unidades especificadas
+ Tipo: entero
+ Obligatorio: no
+ ValueRange: una estructura que permite a los clientes especificar un período de tiempo relativo durante el cual se incluyen los datos en el atributo calculado. Utilice números positivos para indicar que el punto final está en el pasado y números negativos para indicar que está en el futuro. ValueRangeanula el valor.
+ Tipo: ValueRange
+ Obligatorio: no
+ Inicio
+ Hora en que se va a empezar a incluir objetos. Utilice números positivos para indicar que el punto de inicio está en el pasado y números negativos para indicar que está en el futuro.
+ Tipo: entero
+ Obligatorio: sí
+ Final
+ Hora en que se van a dejar de incluir objetos. Utilice números positivos para indicar que el punto de inicio está en el pasado y números negativos para indicar que está en el futuro.
+ Tipo: entero
+ Obligatorio: sí
+ Unidad: unidad de tiempo
+ Valores válidos: días
+ Obligatorio: sí
+ Obligatorio: sí
+ Alcance inicial: máximo de 366 días
+ **ObjectCount**
Número de objetos de perfil utilizados para el atributo calculado.
+ Tipo: Number
+ Intervalo: de 1 a 100
+ Obligatorio: no
+ **Threshold**
La lógica de comparación para generar un atributo true/false calculado.
+ Tipo: objeto Threshold
+ Valor
+ Valor del umbral
+ Tipo: cadena
+ Requerido: no
+ Operador
+ Operador del umbral
+ Tipo: ENUM
+ Valores válidos:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ Obligatorio: no
------
#### [ GetCalculatedAttributeDefinition ]
**GetCalculatedAttributeDefinition**
Permite recuperar una definición de atributo calculada.
**Solicitud**
```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Cuerpo de la solicitud**
```
The request does not have a request body.
```
**Respuesta**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Unit": "string",
"Value": number
"ValueRange"
{
"Start": number
"End": number
},
"TimestampFormat": "string",
"TimestampSource": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"UseHistoricalData" boolean,
"Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED",
"Readiness": {
"ProgressPercentage": number,
"Message": "string",
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**Parámetros de solicitud del URI**
+ **DomainName**
Nombre único del dominio.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **CalculatedAttributeName**
El nombre único (por dominio) del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
------
#### [ DeleteCalculatedAttributeDefinition ]
**DeleteCalculatedAttributeDefinition**
Permite eliminar una definición de atributo calculado existente. Tenga en cuenta que es posible eliminar un atributo calculado predeterminado; no obstante, una vez eliminado, no podrá deshacer esa acción y tendrá que volver a crearlo por su cuenta mediante la API `CreateCalculatedAttributeDefinition` si desea recuperarlo.
**Solicitud**
```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**Cuerpo de la solicitud**
```
The request does not have a request body.
```
**Respuesta**
```
The response does not have a response body.
```
**Parámetros de solicitud del URI**
+ **DomainName**
Nombre único del dominio.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **CalculatedAttributeName**
El nombre único (por dominio) del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
------
#### [ ListCalculatedAttributeDefinitions ]
**ListCalculatedAttributeDefinitions**
Permite recuperar todas las definiciones de atributos calculados para un dominio.
**Solicitud**
```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Cuerpo de la solicitud**
```
The request does not have a request body.
```
**Respuesta**
```
{
"Items": [
{
"UseHistoricalData": boolean,
"ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED,
"CalculatedAttributeName": "string",
"CreatedAt": number,
"Description": "string",
"DisplayName": "string",
"LastUpdatedAt": number,
"Tags": {
"string" : "string"
}
}
],
"NextToken": "string"
}
```
**Parámetros de solicitud del URI**
+ **DomainName**
Nombre único del dominio.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **MaxResults**
Número máximo de objetos devueltos por página.
+ Rango válido: valor mínimo de 1. Valor máximo de 100.
+ **NextToken**
El token de paginación de la llamada a la ListCalculatedAttributeDefinition API anterior.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024
------
#### [ GetCalculatedAttributeForProfile ]
**GetCalculatedAttributeForProfile**
Inicia el cálculo y recupera el resultado de un único atributo calculado para un único perfil.
**Solicitud**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```
**Cuerpo de la solicitud**
```
The request does not have a request body.
```
**Respuesta**
```
{
"Name": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial": "string",
"LastObjectTimestamp" : number
}
```
**Parámetros de solicitud del URI**
+ **DomainName**
Nombre único del dominio.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **CalculatedAttributeName**
El nombre único (por dominio) del atributo calculado.
+ Tipo: String
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
------
#### [ ListCalculatedAttributesForProfile ]
**ListCalculatedAttributesForProfile**
Inicia el cálculo y recupera los resultados de todos los atributos calculados para un único perfil.
**Solicitud**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**Cuerpo de la solicitud**
```
The request does not have a request body.
```
**Respuesta**
```
{
"Items": [
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial" : "string",
"LastObjectTimestamp" : number
},
...
],
"NextToken": "string"
}
```
**Parámetros de solicitud del URI**
+ **DomainName**
Nombre único del dominio.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
+ Patrón: `^[a-zA-Z0-9_-]+$`
+ Obligatorio: sí
+ **ProfileId**
+ Patrón: `[a-f0-9]{32}`
+ Obligatorio: sí
+ **MaxResults**
Número máximo de objetos devueltos por página.
+ Rango válido: valor mínimo de 1. Valor máximo de 100.
+ **NextToken**
El token de paginación de la llamada a la ListCalculatedAttributeDefinition API anterior.
+ Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024
------
# Creación de una definición de atributo calculado personalizada para Perfiles de clientes de Amazon Connect
Con la [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API de perfiles de clientes, puede crear mediante programación su propio atributo calculado a partir de un tipo de objeto personalizado.
En este tema mostramos cómo crear un atributo calculado mediante un archivo JSON personalizado.
## Paso 1: crear un archivo JSON
Cree un archivo JSON con el siguiente contenido:
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"UseHistoricalData": true,
"DisplayName": "your-display-name",
"Description": "your-description",
"AttributeDetails": {
"Attributes": [
{
"Name": "your-attribute-name"
}
],
"Expression": "{your-object-type.your-attribute-name}"
},
"Statistic": "your-statistic",
"Conditions": {
"Range": {
"ValueRange"
{
"Start": your-range-start
"End": your-range-end
},
"TimestampSource": "{your-object-type.your-timestamp-source}",
"Unit": "days"
},
"ObjectCount": your-object-count,
"Threshold": {
"Value": "your-threshold-value",
"Operator": "your-threshold-operator"
}
}
}
```
Para personalizar el código JSON con sus propios valores, siga estas indicaciones:
+ **Attributes**: debe contener el nombre del campo del tipo de objeto que desea utilizar para el atributo calculado. Se admiten dos atributos a los que se haga referencia en esta lista.
+ **Expression**: se admiten expresiones matemáticas básicas para realizarlas entre atributos. Si solo tiene un atributo, este campo debería ser `{ObjectTypeName.AttributeName}`; de lo contrario, si tiene en mente una expresión matemática, este campo debe contener ambos atributos.
+ **Estadística**: es la operación que se realiza cuando se llama a uno de los cálculos APIs que realmente realizan la operación de agregación. La mayoría se explican por sí mismas, pero hemos agregado explicaciones para las que no lo son.
**Estadísticas admitidas**
+ `FIRST_OCCURRENCE` devuelve el atributo especificado en la expresión del primer objeto ingerido.
+ `LAST_OCCURRENCE` devuelve el atributo especificado en la expresión del último objeto ingerido.
+ `COUNT` devuelve el recuento de los datos seleccionados.
+ `SUM` devuelve la suma de los datos seleccionados.
+ `MINIMUM` devuelve el mínimo de los datos seleccionados.
+ `MAXIMUM` devuelve el máximo de los datos seleccionados.
+ `AVERAGE` devuelve el promedio de los datos seleccionados.
+ `MAX_OCCURRENCE` devuelve el valor que aparece con más frecuencia especificado en la expresión.
+ **Rango**:
+ Units: actualmente solo admiten unidades DIARIAS.
+ ValueRange: especifique números positivos en los campos ValueRange de inicio o fin para indicar desde cuántos días empezará y números negativos para indicar cuántos días en el futuro empezará.
+ TimestampSource: una expresión que especifica el campo del objeto JSON a partir del cual se debe analizar la fecha. La expresión debe seguir la estructura de\$1 "\$1ObjectTypeName. \$1\$1». Por ejemplo, si tu tipo de objeto es JSON MyType y la fuente es JSON`{"generatedAt": {"timestamp": "1737587945945"}}`, entonces TimestampSource debería serlo`"{MyType.generatedAt.timestamp}"`.
+ **ObjectCount**: Indica en cuántos objetos debe basarse el cálculo del atributo calculado.
+ **Threshold**: si en lugar del valor exacto del atributo calculado quiere saber si, por ejemplo, es mayor que un valor determinado, puede utilizar un umbral.
El valor de umbral puede ser cualquier cadena y se admiten los siguientes operadores de umbral.
+ `GREATER_THAN`
+ `LESS_THAN`
+ `EQUAL_TO`
+ `NOT_EQUAL_TO`
+ UseHistoricalData: Si los datos históricos ingeridos antes de crear el atributo calculado deben incluirse en los cálculos.
## Paso 2: Llama a la API CreateCalculatedAttributeDefinition
Una vez que haya creado y personalizado el archivo JSON con sus valores, llame a la [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API, como se muestra en el siguiente ejemplo:
```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```
También puede utilizar el siguiente punto de conexión:
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```
# Valide los valores de atributos calculados en los perfiles de clientes de Amazon Connect mediante APIs
Hay dos APIs, `GetCalculatedAttributeForProfile` y`ListCalculatedAttributesForProfile`, que están a nivel de perfil.
+ **GetCalculatedAttributeForProfile**- recupera un único atributo calculado para un único perfil.
+ **ListCalculatedAttributesForProfile**- recupera una lista de atributos calculados para un solo perfil
Con un ID de perfil válido, debería ver los valores de sus atributos calculados:
**Ejemplo de respuesta**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"IsDataPartial": "true",
"Value": "24144"
}
```
**IsDataPartial**- Este indicador significa que no se ha alcanzado el intervalo de tiempo (30 días) o el recuento de objetos y, por lo tanto, el atributo calculado aún se está calculando. Por ejemplo, si desea un promedio superior a 30 días, el campo `IsDataPartial` solo se establecerá en falso cuando hayan transcurrido 30 días.
## Recuperación de una lista de atributos calculados
**Utilice la AWS CLI**
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```
**Utilice la AWS CLI con un archivo JSON personalizado**
Cree un archivo JSON con el siguiente contenido:
```
{
"DomainName": "your-domain-name",
"ProfileId" "some-profile-id"
}
```
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Punto de conexión:**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```
## Recuperación de un único atributo calculado
**Utilice la AWS CLI**:
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id
```
**Utilice la AWS CLI con un archivo JSON personalizado**:
Cree un archivo JSON con el siguiente contenido:
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"ProfileId" "your-profile-id"
}
```
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**Punto de conexión:**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```
# Atributos calculados predeterminados en Perfiles de clientes de Amazon Connect
## Atributos calculados de CTR predeterminados
Amazon Connect Los perfiles de cliente proporcionan los atributos predeterminados de la out-of-the casilla basados en los registros de contactos. Los atributos son los siguientes:
**El canal más frecuente**
```
{
"CalculatedAttributeName": "_most_frequent_channel",
"DisplayName": "Most frequent channel",
"Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Último canal**
```
{
"CalculatedAttributeName": "_last_channel",
"DisplayName": "Last channel",
"Description": "Returns customer's last communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**Identificador del último agente**
```
{
"CalculatedAttributeName": "_last_agent_id",
"DisplayName": "Last agent identifier",
"Description": "Returns identifier of the last agent customer connected with.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.id"
}
],
"Expression": "{CTR.agent.id}"
},
"Tags": {
}
}
```
**Persona que llama con frecuencia**
```
{
"CalculatedAttributeName": "_frequent_caller",
"DisplayName": "Frequent caller",
"Description": "Returns true or false based on the number of times a customer has called.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "COUNT",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": {
"Value": "5",
"Operator": "GREATER_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "contactId"
}
],
"Expression": "{CTR.contactId}"
},
"Tags": {
}
}
```
**Tiempo medio de espera**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"Description": "Returns customer's average hold time for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Tags": {
}
}
```
**Duración media de la llamada**
```
{
"CalculatedAttributeName": "_average_call_duration",
"DisplayName": "Average call duration",
"Description": "Returns customer's average call duration for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "disconnectTimestamp"
},
{
"Name": "initiationTimestamp"
}
],
"Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}"
},
"Tags": {
}
}
```
**Tiempo máximo de espera del cliente**
```
{
"CalculatedAttributeName": "_maximum_hold_time",
"DisplayName": "Customer's maximum hold time",
"Description": "Returns customer's maximum hold time for voice calls in the past month.",
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Statistic": "MAXIMUM",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Atributo calculado predeterminado del perfil
Amazon Connect Los perfiles de cliente proporcionan un atributo predeterminado de out-of-the cuadro basado en un perfil. Los atributos son los siguientes:
**Cliente nuevo**
```
{
"CalculatedAttributeName": "_new_customer",
"DisplayName": "New customer",
"Description": "Returns true or false for new customer profiles created.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "TIME_DIFFERENCE_FROM_NOW",
"Conditions": {
"ObjectCount": null,
"Threshold": {
"Value": "30",
"Operator": "LESS_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "createdAt"
}
],
"Expression": "{_profile.createdAt}"
},
"Tags": {
}
}
```
## Atributos calculados predeterminados de activos
Amazon Connect Los perfiles de cliente proporcionan los atributos predeterminados de la out-of-the casilla basados en los activos. Los atributos son los siguientes:
**Recuento de activos**
```
{
"CalculatedAttributeName": "_assets_count",
"DisplayName": "Count of assets",
"Description": "Returns the count of assets for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetId"
}
],
"Expression": "{_asset.AssetId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Fecha de compra del primer activo**
```
{
"CalculatedAttributeName": "_asset_first_occurrence",
"DisplayName": "First asset purchased date",
"Description": "Returns purchase date of the customer's first asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Fecha de compra del último activo**
```
{
"CalculatedAttributeName": "_asset_last_occurrence",
"DisplayName": "Last asset purchased date",
"Description": "Returns purchase date of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Precio total del activo**
```
{
"CalculatedAttributeName": "_assets_price_sum",
"DisplayName": "Total asset price",
"Description": "Returns customer's total asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "SUM",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Precio medio de los activos**
```
{
"CalculatedAttributeName": "_assets_price_average",
"DisplayName": "Average asset price",
"Description": "Returns customer's average asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Nombre del primer activo**
```
{
"CalculatedAttributeName": "_assets_name_first_occurrence",
"DisplayName": "First asset name",
"Description": "Returns name of the customer's first asset",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Apellido del primer activo**
```
{
"CalculatedAttributeName": "_assets_name_last_occurrence",
"DisplayName": "Last asset name",
"Description": "Returns name of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## Atributos calculados predeterminados de casos
Amazon Connect Los perfiles de cliente proporcionan los atributos predeterminados de la out-of-the casilla en función de los casos. Los atributos son los siguientes:
**Recuento de casos**
```
{
"CalculatedAttributeName": "_cases_count",
"DisplayName": "Count of cases",
"Description": "Returns the count of customer's cases for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Fecha de creación del primer caso**
```
{
"CalculatedAttributeName": "_case_first_occurrence",
"DisplayName": "First case created date",
"Description": "Returns created date of the customer's first case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Fecha de creación del último caso**
```
{
"CalculatedAttributeName": "_case_last_occurrence",
"DisplayName": "Last case created date",
"Description": "Returns created date of the customer's last case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Recuento de casos abiertos**
```
{
"CalculatedAttributeName": "_cases_open_status_count",
"DisplayName": "Count of open cases",
"Description": "Returns the count of customer's open cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Recuento de casos cerrados**
```
{
"CalculatedAttributeName": "_cases_closed_status_count",
"DisplayName": "Count of closed cases",
"Description": "Returns the count of customer's closed cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Closed"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Atributos calculados del registro de comunicación predeterminado
Amazon Connect Los perfiles de cliente proporcionan los atributos predeterminados de la out-of-the casilla basados en los registros de comunicación. Los atributos son los siguientes:
**Fecha de apertura del último correo electrónico**
```
{
"CalculatedAttributeName": "_campaign_email_last_open",
"DisplayName": "Last email open date",
"Description": "Returns the last email open date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.Open.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.Open.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Recuento de correos electrónicos abiertos**
```
{
"CalculatedAttributeName": "_campaign_email_open_count",
"DisplayName": "Email open count",
"Description": "Returns the number of times emails were opened by a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Recuento de correos electrónicos enviados**
```
{
"CalculatedAttributeName": "_campaign_email_delivery_count",
"DisplayName": "Email delivery count",
"Description": "Returns the number of times emails were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Delivery.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Delivery"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Recuento de SMS enviados**
```
{
"CalculatedAttributeName": "_campaign_sms_delivery_count",
"DisplayName": "SMS delivered count",
"Description": "Returns the number of times SMS were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_DELIVERED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_DELIVERED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Fecha del último SMS bloqueado**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop",
"DisplayName": "Last SMS blocked date",
"Description": "Returns the last SMS blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**Fecha del último SMS de operador bloqueado**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop_carrier",
"DisplayName": "Last SMS carrier blocked date",
"Description": "Returns the last SMS carrier blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_CARRIER_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_CARRIER_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
## Atributos calculados predeterminados de pedidos
Amazon Connect Los perfiles de cliente proporcionan los atributos predeterminados de las out-of-the casillas en función de los pedidos. Los atributos son los siguientes:
**Recuento de pedidos**
```
{
"CalculatedAttributeName": "_orders_count",
"DisplayName": "Count of orders",
"Description": "Returns the count of orders for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "OrderId"
}
],
"Expression": "{_order.OrderId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Fecha de creación del primer pedido**
```
{
"CalculatedAttributeName": "_order_first_occurrence",
"DisplayName": "First order created date",
"Description": "Returns created date of the customer's first order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Fecha de creación del último pedido**
```
{
"CalculatedAttributeName": "_order_last_occurrence",
"DisplayName": "Last order created date",
"Description": "Returns created date of the customer's last order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**Precio total de todos los pedidos**
```
{
"CalculatedAttributeName": "_orders_total_price_sum",
"DisplayName": "Total price of all orders",
"Description": "Returns sum of total price for all customer's orders.",
"Statistic": "SUM",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**Promedio de pedidos del precio total**
```
{
"CalculatedAttributeName": "_orders_total_price_average",
"DisplayName": "Orders average of total price",
"Description": "Returns average of total price for all customer's orders.",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
# Mensajes de error y soluciones para atributos calculados de Perfiles de clientes de Amazon Connect
En la siguiente tabla se muestran los mensajes de error de los atributos calculados, la causa y la resolución de cada error.
| Mensaje de error | Causa | Resolución |
| --- | --- | --- |
| La recuperación de un atributo calculado para un perfil muestra un valor nulo | Se debe probablemente a que el atributo calculado no tiene datos. Tras la creación de un atributo calculado, hay que realizar la ingesta de nuevos datos. | Ingiera datos nuevos o vuelva a ingerir datos antiguos mediante integraciones o de forma automática. CreateProfile PutProfileObject APIs |
# Configuración de segmentos de clientes en Perfiles de clientes de Amazon Connect
Un *segmento de clientes* es un grupo de perfiles de clientes que comparten ciertos atributos. Por ejemplo, un segmento de clientes puede incluir a todos los clientes que viven en una ciudad determinada o todos los clientes que llaman con frecuencia y cuyo gasto medio es superior a 500 dólares. Con Amazon Connect las campañas salientes, puedes enviar campañas a un segmento de clientes.
Los segmentos de clientes se evalúan de forma dinámica en función de los atributos que se definan y pueden cambiar con el tiempo cuando cambia el valor de los atributos. Por ejemplo, si agrega nuevos perfiles al dominio de Perfiles de clientes o si modifica o elimina perfiles existentes, el número de perfiles de dicho segmento de clientes puede aumentar o disminuir. Para obtener más información sobre cómo crear un segmento de clientes, consulte [Creación de segmentos de clientes en Amazon Connect,](customer-segments-building-segments.md).
Como requisito previo para crear segmentos Amazon Connect, su administrador debe configurar su dominio en la consola de administración de AWS y configurar las integraciones para incluir los datos de perfiles, pedidos, activos y and/or casos en los perfiles de los clientes. Para obtener más información, consulte [Habilitación de perfiles de clientes para su instancia de Amazon Connect](enable-customer-profiles.md). Activación de las integraciones de datos que permiten seguir generando segmentos dinámicos en función de los nuevos datos que lleguen a su dominio
Los segmentos de clientes solo contienen perfiles de clientes en su dominio de Perfiles de clientes de Amazon Connect. Perfiles de clientes se puede ingerir desde S3 o aplicaciones externas, o se puede crear a través de la aplicación Agente, Flujos de contacto o la API. Para obtener más información sobre los perfiles de clientes, consulte [¿Qué es un perfil de cliente en Amazon Connect?](customer-profiles-what-data.md).
**Topics**
+ [Creación de segmentos de clientes](customer-segments-building-segments.md)
+ [Administración de segmentos](customer-segments-managing-segments.md)
+ [Creación de segmentos a partir de archivos importados](customer-segments-imported-files.md)
+ [Exportación de segmentos a un archivo CSV](customer-segments-exporting-segments.md)
+ [Uso del asistente de IA de segmentación](customer-segments-ai-assistant.md)
+ [Resolución de problemas](customer-segments-troubleshooting.md)
# Creación de segmentos de clientes en Amazon Connect,
**nota**
**La segmentación basada en SQL (beta) requiere que el almacén de datos esté activado. Visite la pantalla de inicio de los perfiles de los clientes y active el almacenamiento de datos desde el banner azul superior**
**nota**
Para acceder a la experiencia de creación de segmentación en el sitio web de Amazon Connect administración, necesita permisos de perfiles de seguridad para utilizar esta función. Para obtener más información, consulte [Asignación de permisos de perfil de seguridad para administrar segmentos de clientes](security-profile-customer-profile-segmentation.md).
Antes de crear segmentos, le recomendamos que las integraciones de datos de configuración del dominio de Perfiles de clientes rellenen los perfiles de su dominio de Perfiles de clientes. Para obtener más información sobre cómo configurar las integraciones de datos con Perfiles de clientes, consulte [Integración aplicaciones externas con Perfiles de clientes de Amazon Connect](integrate-external-apps-customer-profiles.md).
Los segmentos pueden incluir eventos que haya capturado mediante los atributos calculados. Para obtener más información sobre cómo configurar los atributos calculados personalizados y revisar los atributos calculados predeterminados que ofrece Perfiles de clientes, consulte [Configuración de los atributos calculados en Perfiles de clientes de Amazon Connect](customerprofiles-calculated-attributes.md).
Amazon Connect ofrece dos formas de crear segmentos de clientes: 1/ Definir segmentos mediante Spark SQL (beta; requiere que el almacén de datos esté habilitado); 2/ Defina segmentos mediante grupos de audiencias y filtros (segmentación clásica). En ambos casos, puedes usar mensajes en lenguaje natural a través del asistente Segment AI, basado en inteligencia artificial generativa. Si defines los segmentos de una de las formas, mueves ese segmento a la otra y tendrás que empezar de nuevo.
## Segmentos impulsados por Spark SQL
Los segmentos con tecnología de Spark SQL te permiten utilizar datos completos del perfil del cliente y una funcionalidad ampliada para definir los segmentos. Puedes usar atributos de objeto de perfil estándar y atributos de objeto personalizados. También puede utilizar funciones basadas en SQL, como unir objetos estándar y personalizados para utilizar datos de varios objetos, filtrar segmentos con estadísticas como percentiles y estandarizar los campos de fecha para realizar comparaciones.
Puede empezar por introducir un mensaje en lenguaje natural en Segment Assistant AI. El asistente Segment AI definirá el segmento, incluida su traducción a Spark SQL. La IA de Segment Assistant te proporcionará los pasos necesarios para definir el segmento y podrás validar que coincide con lo que pretendías crear. También puedes ver el SQL, los pasos del SQL en lenguaje natural y un resumen del SQL de Spark generado por la IA para facilitar aún más la validación. Si quieres hacer cambios, puedes actualizar tu interfaz en lenguaje natural o editar directamente el SQL de Spark.
También tienes la opción de crear el segmento de SQL de Spark directamente.
**Al igual que la segmentación clásica, los segmentos con tecnología de Spark SQL se pueden usar en convocatorias de miembros de segmentos, bloques de flujo y campañas salientes.**
**Cuando utilizas un segmento de Spark SQL en una llamada de membresía de segmentos, un bloque de flujo o una campaña saliente iniciada por un evento de un cliente, se utiliza el último segmento exportado (instantánea del segmento). La instantánea del segmento utilizada para la membresía vence un año después de su creación. Si recibe un error 4XX, asegúrese de haber exportado el segmento (instantánea del segmento).**
**Las campañas salientes iniciadas por un segmento de clientes no requieren que exporte el segmento (instantánea del segmento).**
### Paso 1: creación de un segmento nuevo
En el asistente Segment AI, selecciona «Cómo crear un segmento» para obtener más información sobre cómo crear segmentos valiosos o «Quiero generar un segmento» para introducir un mensaje en lenguaje natural para crear el segmento.
Como alternativa, puedes usar SQL para definir un nuevo segmento en el editor de consultas.
**Nota: si quieres crear una campaña de Outbound basada en una zona horaria, debes asegurarte de que el atributo de zona horaria forme parte de la salida del segmento**
**Nota: si quieres utilizar el segmento en las campañas salientes, debes asegurarte de que el perfil IDs de la salida del segmento sea único**
### Paso 2: especificación de un nombre y una descripción
En Nombre, escriba un nombre para el segmento de cliente que permita reconocerlo más adelante.
**Nota:** El sitio web de administración `DisplayName` de Amazon Connect utiliza el nombre introducido como segmento y genera un identificador en función de él. El identificador generado se utiliza `SegmentDefinitionName` cuando accedes al segmento mediante los perfiles de clientes APIs.
En Descripción, puede escribir una descripción para el segmento de clientes.
### Paso 3: Revise y valide el segmento
Revisa los datos que utilizó el asistente de IA de segmentos y los pasos que siguió el modelo de IA para generar tu segmento. También puedes revisar el SQL que creó para definir el segmento en el editor de consultas. Si no pudo crear el segmento, aborde los comentarios que proporcionó para ayudarlo a crear un segmento preciso. Una vez que haya generado un segmento, Customer Profiles creará automáticamente una estimación del segmento para usted.
Si desea realizar modificaciones, puede proporcionar un nuevo mensaje haciendo clic en «Nueva conversación» o en create/edit SQL en el editor de consultas.
Si no utilizas el asistente Segment AI, puedes validar la consulta y crear la estimación haciendo clic en el botón «Validar y estimar la consulta» situado debajo del editor de consultas.
**Nota: los segmentos basados en Spark SQL tardarán un tiempo en función de la cantidad de datos de perfil que utilices en el segmento y del SQL que utilices, al igual que otros motores de consultas (por ejemplo, las uniones múltiples de objetos llevan tiempo).**
### Paso 4: Crea un segmento
Una vez que haya creado un segmento y esté satisfecho, seleccione el botón «Crear segmento» en la parte superior derecha. Una vez que hayas creado el segmento, puedes seleccionar Acciones: exportar a .csv, usar el segmento en Flows y usar el segmento en Outbound Campaigns.
**Nota: si utilizas el segmento en las campañas salientes o en los bloques de flujo, se comprobará la pertenencia al segmento en función de cuándo se creó el segmento por última vez. Si necesitas comprobar la membresía de los segmentos en tiempo real mientras se ejecuta el flujo o la campaña, usa la segmentación clásica.**
## Segmentación clásica con filtros y grupos de audiencia
Al crear un segmento de clientes, se eligen las audiencias iniciales y se refinan esas audiencias mediante la elección de los filtros que definen el segmento. Por ejemplo, puede crear un grupo de audiencia y, a continuación, elegir un filtro para todos los clientes que viven en un país específico y que llaman con frecuencia. Los segmentos se recalculan bajo demanda, por ejemplo, durante la ejecución de la campaña, la ejecución del flujo de contactos y la estimación o exportación de los segmentos. Como resultado, el tamaño y la pertenencia de cada segmento cambia con el paso del tiempo.
Además, puede crear un segundo grupo de audiencia y, a continuación, una relación (AND, OR o EXCLUDE) entre los dos grupos de audiencia para reducir, concatenar o excluir aún más a los clientes del primer grupo de audiencia.
![\[Dos grupos de audiencia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-building-segments-1.png)
## Grupos de audiencia
Al crear un segmento de clientes, debe crear uno o varios grupos de audiencia. Un grupo de audiencia consta de estos componentes:
![\[Diagrama conceptual que muestra los componentes de los grupos de audiencia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-audience-groups-1.png)
+ **Audiencias iniciales**: son los segmentos de clientes que definen el número inicial de usuarios. Puede especificar hasta cinco audiencias iniciales o todos los perfiles de su dominio de Perfiles de clientes.
+ **Grupos de filtros**: son las categorías de información de la audiencia que se aplican además de las audiencias iniciales. Puede añadir varios grupos de filtros que estén conectados mediante relaciones OR.
+ **Filtros**: los filtros reducen el número de audiencia que pertenece al segmento. Puede añadir tantos filtros como desee con el fin de adaptar el segmento a sus necesidades.
Un segmento de clientes debe tener al menos un grupo de audiencia, pero si lo desea, puede crear un segundo grupo de audiencia y, a continuación, crear una relación (AND/OR/EXCLUDE) entre los dos grupos de audiencia. Para obtener detalles sobre la relación, consulte [Paso 5: adición del segundo grupo de audiencia (opcional)](#step-5-add-the-second-audience-group-optional).
## Creación de un segmento de clientes
Los siguientes pasos describen la creación y configuración de un segmento de clientes:
+ Paso 1: creación de un segmento nuevo
+ Paso 2: configuración del nombre y la descripción
+ Paso 3: elección de las audiencias iniciales para incluir en el grupo de audiencia 1
+ Paso 4: elección y configuración de los grupos de filtros (opcional)
+ Paso 5: adición del grupo de audiencia 2 (opcional)
### Paso 1: creación de un segmento nuevo
1. Para crear un segmento, asegúrese de haber creado permisos para los perfiles de seguridad como requisito previo. Para obtener más información, consulte [Asignación de permisos de perfil de seguridad para administrar segmentos de clientes](security-profile-customer-profile-segmentation.md). Además, para visualizar mejor los miembros de su segmento, le recomendamos que ingiera los datos antes de crear el segmento. Para ingerir perfiles a través de S3 o aplicaciones externas, consulte [Creación e ingesta de datos de clientes en Perfiles de clientes](customer-profiles-object-type-mappings.md) o [Integración aplicaciones externas con Perfiles de clientes de Amazon Connect](integrate-external-apps-customer-profiles.md).
1. Elija **Crear un segmento** en la vista de tabla Segmento de clientes.
![\[El botón Crear un segmento.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png)
### Paso 2: especificación de un nombre y una descripción
+ En **Nombre**, escriba un nombre para el segmento de cliente que permita reconocerlo más adelante.
**nota**
El sitio web de Amazon Connect administración utiliza el nombre introducido como el `DisplayName` del segmento y genera un identificador en función de él. El identificador generado se utiliza `SegmentDefinitionName` cuando se accede al segmento mediante los perfiles de los clientes APIs.
+ En **Descripción**, puede escribir una descripción para el segmento de clientes.
![\[Una sección de nombre de segmento.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png)
### Paso 3: elección de las audiencias iniciales para incluir en el grupo de audiencia 1
Primero, debe elegir cómo quiere definir la audiencia inicial para el grupo de audiencia.
1. En **Grupo de audiencia 1**, en la lista desplegable **Audiencia inicial**, seleccione uno o más segmentos para incluirlos en el grupo de audiencia, o elija **Todos los perfiles de Perfiles de clientes**.
**nota**
Si elige varios segmentos como audiencia inicial, los segmentos se conectan mediante relaciones `OR`. Por ejemplo, si elige los segmentos **Clientes con membresía Premium** y **Clientes con membresía básica** como las audiencias iniciales, se incluirán todos los perfiles que estén en cualquiera de los segmentos.
![\[Una lista desplegable de audiencia inicial.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png)
1. Para crear un segmento ProfileType, comience por utilizar **Todas las cuentas de los perfiles de clientes** como audiencia inicial. Este enfoque le permite filtrar los perfiles basados en cuentas de forma eficaz. Es importante tener en cuenta que, a menos que especifique lo contrario, el proceso de segmentación exportará automáticamente todos los perfiles del dominio de perfiles de clientes. Este comportamiento predeterminado garantiza una cobertura integral, pero se puede ajustar para satisfacer necesidades específicas de segmentación.
El siguiente es un ejemplo de cómo se puede crear una definición de segmento (basada en perfiles de cuenta o estándares):
**Filtra todos los perfiles basados en cuentas (=ACCOUNT\$1PROFILE) ProfileType**
![\[Filtra todos los perfiles basados en cuentas (=ACCOUNT_PROFILE). ProfileType\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png)
**nota**
Para crear un segmento solo con subperfiles, cree una nueva audiencia que excluya los perfiles basados en cuentas. Por ejemplo, perfiles con `ProfileType` es PROFILE o donde `ProfileType` esté vacío.
![\[Para crear un segmento solo con subperfiles, cree una nueva audiencia que excluya los perfiles basados en cuentas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png)
**Ejemplo de campaña que va dirigida a las cuentas con las que desea contactar por `Phone`**
![\[Ejemplo de campaña que va dirigida a las cuentas con las que desea contactar por Phone\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png)
En este ejemplo, la campaña va dirigida a una sola cuenta con la siguiente secuencia de llamadas:
1. Primeros intentos de contactar con John (ID: 2)
1. Si John no responde, entonces llama a Sally (ID: 3), que es el contacto de respaldo
1. Cuando hayas elegido una audiencia inicial, la sección **Audiencia estimada** se actualizará para mostrar los perfiles elegibles. Después de editar los grupos de audiencia, puede hacer clic en el botón **Actualizar** de la sección Audiencia estimada para volver a obtener la estimación.
![\[Una sección de audiencia estimada.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png)
### Paso 4: elección y aplicación de filtros de audiencia (opcional)
Cuando haya elegido las audiencias iniciales, podrá refinar aún más las audiencias aplicando la lógica condicional a los atributos. Los segmentos admiten los atributos de perfil estándar, los atributos de perfil personalizados y los atributos calculados.
![\[Filtros de audiencia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png)
**Cómo elegir y configurar los filtros de audiencia**
1. Para **Atributo**, puede elegir un atributo de los siguientes tipos:
1. **Atributos calculados**: filtran la audiencia en función de uno de los atributos calculados.
Consulte [Configuración de los atributos calculados en Perfiles de clientes de Amazon Connect](customerprofiles-calculated-attributes.md) para obtener más información sobre los atributos calculados predeterminados y cómo configurar los atributos calculados personalizados.
1. **Atributos estándar**: filtran la audiencia en función de uno de los atributos de perfil predeterminados.
Consulte [Definición de perfil estándar en los perfiles de clientes de Amazon Connect](standard-profile-definition.md) para ver la lista de atributos de perfil estándar.
1. **Atributos personalizados**: filtran la audiencia en función de uno de los atributos de perfil predeterminados.
**nota**
Almacenamos hasta los 1000 atributos de perfil más recientes en el dominio. Si el dominio contiene una gran cantidad de atributos, es posible que los atributos más antiguos no se muestren en esta lista.
1. Elija el **Operador**. Los operadores determinan la relación del atributo con el valor que indique. A continuación, se describen los operadores disponibles. Los operadores disponibles cambian en función del tipo de valor del atributo que haya seleccionado.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/customer-segments-building-segments.html)
**nota**
Los segmentos de clientes del sitio web de Amazon Connect administración utilizan la zona horaria UTC y la hora predeterminada de 00:00:00 UTC para todos los filtros basados en el tiempo. Puedes filtrar por fechas, pero las horas se registran con el mismo valor. Si indica la fecha de 2024-01-01, la consola transfiere la hora como 2024-01-01T00:00:00Z.
**nota**
Al especificar un filtro para un atributo calculado, puede anular el período de tiempo de la definición del atributo calculado. Por ejemplo, el filtro `Frequent caller is true for the event time period of 60 days` anulará a la *Persona que llama con frecuencia* [Atributos calculados predeterminados en Perfiles de clientes de Amazon Connect](customerprofiles-default-calculated-attributes.md) para evaluar el valor de los últimos 60 días en lugar del [período de tiempo configurado en la definición de atributo calculado](customerprofiles-calculated-attributes-apis.md). Esta anulación es específica del segmento y no afecta a la propia definición del atributo calculado.
![\[Atributo, operador y valor que se van a evaluar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png)
1. Especifique el valor. Puede especificar varios valores conectados por relaciones `OR`. Por ejemplo, `Address.Country` es `USA` o `Mexico`. La entrada de valores muestra sugerencias en el menú desplegable para los operadores de cadenasbasadas en los perfiles de los clientes almacenados en el dominio.
**nota**
Los valores distinguen entre mayúsculas y minúsculas. Por ejemplo, *Address.Country es ES* arroja resultados diferentes a *Address.Country es es*.
1. (Opcional) Para aplicar atributos adicionales a este grupo de filtros, elija **\$1 filtro**. Para crear otro grupo de filtros, elija **\$1 grupo**.
**nota**
Si tiene varios filtros en un grupo de filtros, los filtros están conectados mediante relaciones AND. Por ejemplo, si el grupo de filtros contiene dos filtros, *Address.Country* es ES y *Tiempo medio de espera del cliente* es superior a 10 segundos, a ese segmento pertenecerán los perfiles cuya *Address.Country* sea ES **y** el *tiempo medio de espera* sea superior a 10 segundos.
Cuando tienes varios grupos de filtros en un grupo de audiencia, los segmentos de clientes del sitio web de Amazon Connect administración utilizan las relaciones OR para conectarse entre los grupos de filtros.
![\[Dos filtros de audiencia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png)
1. Cuando haya terminado de configurar el grupo de audiencia, elija **Crear segmento**.
### Paso 5: adición del segundo grupo de audiencia (opcional)
Si lo desea, añada el segundo grupo de audiencia y defina una relación con el grupo de audiencia 1. Al crear un segmento de clientes mediante el sitio web de administración de Amazon Connect , puede tener un máximo de dos grupos de audiencia por segmento. Si agrega un segundo grupo de audiencia al segmento, puede elegir una de las dos formas para especificar cómo se conectan los dos grupos de audiencia:
+ **Relación AND**: si utiliza la relación AND para conectar dos audiencias, su segmento contiene todos los perfiles que cumplen los filtros del grupo de audiencia 1 y del grupo de audiencia 2.
+ **Relación OR**: si utiliza la relación OR para conectar dos audiencias, su segmento contiene todos los perfiles que cumplen los filtros del grupo de audiencia 1 y del grupo de audiencia 2.
+ **Relación EXCLUDE**: si utiliza la relación EXCLUDE para conectar dos audiencias, el segmento contiene perfiles del grupo de audiencia 1 y excluye los perfiles del grupo de audiencia 2.
**Cómo configurar el segundo grupo de audiencia**
1. Elija una relación **AND**, **OR** o **EXCLUDE** después de configurar el grupo de audiencia 1.
![\[Las opciones AND, OR o EXCLUDE.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png)
1. Elija la audiencia inicial del grupo de audiencia 2. Como referencia, consulte[Paso 3: elección de las audiencias iniciales para incluir en el grupo de audiencia 1](#step-3-choose-the-starting-audiences-to-include-in-audience-group).
1. (Opcional) Elija los filtros por los que desea acotar los segmentos. Como referencia, consulte [Paso 4: elección y aplicación de filtros de audiencia (opcional)](#step-4-choose-and-apply-audience-filters-optional)
1. Cuando termine de configurar el segmento, elija **Create segment (Crear segmento)**. Se ha creado el segmento y ahora puede usarlo en campañas o flujos externos.
![\[Mensaje de que el segmento se ha creado correctamente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png)
## Creación de segmentos con tecnología de Spark SQL
Los segmentos con tecnología de Spark SQL te permiten utilizar datos completos del perfil del cliente y una funcionalidad ampliada para definir los segmentos. Puedes usar atributos de objeto de perfil estándar y atributos de objeto personalizados. También puede utilizar funciones basadas en SQL, como unir objetos estándar y personalizados para utilizar datos de varios objetos, filtrar segmentos con estadísticas como percentiles y estandarizar los campos de fecha para realizar comparaciones.
Puede empezar por introducir un mensaje en lenguaje natural en Segment Assistant AI. El asistente Segment AI definirá el segmento, incluida su traducción a Spark SQL. La IA de Segment Assistant te proporcionará los pasos necesarios para definir el segmento y podrás validar que coincide con lo que pretendías crear. También puedes ver el SQL, los pasos del SQL en lenguaje natural y un resumen del SQL de Spark generado por la IA para facilitar aún más la validación. Si quieres hacer cambios, puedes actualizar tu interfaz en lenguaje natural o editar directamente el SQL de Spark.
También tienes la opción de crear el segmento de SQL de Spark directamente.
Los segmentos con tecnología de Spark SQL se pueden usar en convocatorias de membresía de segmentos, bloques de flujo y campañas salientes. Comprueban el segmento desde la última vez que se creó (instantánea del segmento). Si recibe un error 4XX, tendrá que ejecutar la instantánea del segmento.
**nota**
**La segmentación de SQL se ejecuta en un almacén de datos que contiene datos de hasta 10 años. La segmentación clásica utiliza los datos más recientes (datos actualizados en los últimos 3 años)**
### Paso 1: creación de un segmento nuevo
En el asistente Segment AI, selecciona «Cómo crear un segmento» para obtener más información sobre cómo crear segmentos valiosos o «Quiero generar un segmento» para introducir un mensaje en lenguaje natural para crear el segmento.
Como alternativa, puedes usar SQL para definir un nuevo segmento en el editor de consultas.
### Paso 2: especificación de un nombre y una descripción
En Nombre, escriba un nombre para el segmento de cliente que permita reconocerlo más adelante.
**nota**
El sitio web de administración de Amazon Connect utiliza el nombre introducido como el `DisplayName` del segmento y genera un identificador en función de él. El identificador generado se utiliza `SegmentDefinitionName` cuando accedes al segmento mediante los perfiles de clientes APIs.
En Descripción, puede escribir una descripción para el segmento de clientes.
### Paso 3: Revise y valide el segmento
Revisa los datos que utilizó el asistente de IA de segmentos y los pasos que siguió el modelo de IA para generar tu segmento. También puedes revisar el SQL que creó para definir el segmento en el editor de consultas. Si no pudo crear el segmento, aborde los comentarios que proporcionó para ayudarlo a crear un segmento preciso. Una vez que haya generado un segmento, Customer Profiles creará automáticamente una estimación del segmento para usted.
Si desea realizar modificaciones, puede proporcionar un nuevo mensaje haciendo clic en «Nueva conversación» o en create/edit SQL en el editor de consultas.
Si no utilizas el asistente Segment AI, puedes validar la consulta y crear la estimación haciendo clic en el botón «Validar y estimar la consulta» situado debajo del editor de consultas.
**nota**
Los segmentos que utilizan Spark SQL tardarán un tiempo en función de la cantidad de datos de perfil que utilices en el segmento y del SQL que utilices, al igual que en otros motores de consultas (por ejemplo, las uniones múltiples de objetos suelen tardar más tiempo).
### Paso 4: Crea un segmento
Una vez que haya creado un segmento y esté satisfecho, seleccione el botón «Crear segmento» en la parte superior derecha. Una vez que hayas creado el segmento, puedes seleccionar Acciones: exportar a .csv, usar el segmento en Flows y usar el segmento en Outbound Campaigns.
**nota**
Si utilizas el segmento en las campañas salientes o en los bloques de flujo, se comprobará la pertenencia al segmento en función de cuándo se creó el segmento por última vez. Si necesitas comprobar la pertenencia a los segmentos en tiempo real mientras se ejecuta el flujo o la campaña, utiliza la segmentación clásica.
# Administración de los segmentos de clientes en Amazon Connect
Puede utilizar el sitio web de administración de Amazon Connect para crear, ver, copiar y realizar otras tareas de administración para los segmentos de clientes. Si abre un segmento de clientes para ver su configuración, también puede crear rápidamente una campaña que utilice el segmento. Para obtener más información sobre la creación de segmentos, consulte [Creación de segmentos de clientes en Amazon Connect,](customer-segments-building-segments.md) y la Guía para desarrolladores de Amazon Connect .
**Cómo administrar los segmentos de clientes**
1. En la página **Segments de clientes**, elija el segmento que desee administrar.
![\[La página Segmentos de clientes con una lista de segmentos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-managing-segments-1.png)
1. En el menú **Acciones**, están disponibles las siguientes opciones:
1. **Ver detalles**: seleccione esta opción para mostrar información sobre el segmento de clientes, incluidas la fecha y la hora en que se creó el segmento y la fecha y hora en que se actualizó por última vez. El usuario de Amazon Connect necesita el permiso del perfil de seguridad **CustomerProfiles.Segments.View** para realizar esta acción.
1. **Duplicar**: elija esta opción para crear un segmento de clientes nuevo a partir de una copia del segmento seleccionado. A continuación, puede modificar cualquier configuración del nuevo segmento, sin cambiar el segmento original. El Amazon Connect usuario necesita el permiso de perfil de seguridad **CustomerProfiles.Segments.Create para realizar esta acción.**
1. **Exportar CSV**: elija esta opción para exportar el segmento de clientes a un archivo del equipo. Para obtener más información, consulte. [Exportación de segmentos de clientes a un archivo CSV en Amazon Connect](customer-segments-exporting-segments.md) El Amazon Connect usuario necesita el permiso del perfil de seguridad **CustomerProfiles.Segments.Export** para realizar esta acción.
1. **Eliminar**: elija esta opción para eliminar el segmento de clientes de forma permanente. No se puede recuperar un segmento después de eliminarlo. El Amazon Connect usuario necesita el permiso del perfil de seguridad **CustomerProfiles.Segments.Delete** para realizar esta acción.
**importante**
Si elimina un segmento, las campañas activas que lo utilicen fallarán. Del mismo modo, cualquier segmento creado sobre el segmento dejará de funcionar. Antes de eliminar un segmento, se recomienda comprobar en primer lugar que ninguna campaña activa u otros segmentos lo estén utilizando.
# Creación de segmentos a partir de archivos importados a Amazon Connect
**nota**
Para acceder a la experiencia del generador de segmentación en el sitio web de Amazon Connect administración, asegúrese de que estén configurados los permisos de los perfiles de seguridad adecuados. Para obtener más información, consulte [Asignación de permisos de perfil de seguridad para administrar segmentos de clientes](security-profile-customer-profile-segmentation.md).
La importación de segmentos de clientes utiliza un archivo CSV que contiene datos de perfil para crear nuevos perfiles o actualizar los existentes, que luego se agrupan en un segmento. El archivo CSV debe tener un tamaño inferior a 1 GB e incluir encabezados válidos que se correspondan con los atributos de perfil estándar.
Los siguientes pasos describen la creación y configuración de un segmento de clientes importado:
1. [Creación de un segmento nuevo](#create-new-segment)
1. [Carga de un archivo CSV](#upload-csv-file)
1. [Configuración de la información de los segmentos](#configure-segment-details)
1. [Asignación de atributos de los clientes](#map-customer-attributes)
1. [Configuración del vencimiento del perfil](#set-profile-expiry)
1. [Creación y supervisión de la importación de segmentos](#create-monitor-segment-import)
## Creación de un segmento nuevo
1. Para crear un segmento, asegúrese de haber creado permisos para los perfiles de seguridad como requisito previo. Para obtener más información, consulte [Asignación de permisos de perfil de seguridad para administrar segmentos de clientes](security-profile-customer-profile-segmentation.md).
1. En el sitio web Amazon Connect de administración, vaya a **Perfiles de clientes y segmentos de** **clientes**
1. Seleccione **Crear segmento** y **Desde la carga de archivo** en el menú desplegable.
## Carga de un archivo CSV
Elija un archivo CSV de una de las siguientes maneras:
+ Seleccione **Elegir archivo** y, a continuación, su archivo.
+ Arrastre y suelte el archivo en el área de carga.
El nombre del archivo debe cumplir los siguientes requisitos:
+ tener formato CSV,
+ tener un tamaño inferior a 1 GB,
+ contener encabezados,
+ tener el código UTF-8.
## Configuración de la información de los segmentos
En **Nombre**, especifique un identificador reconocible para el segmento. Este campo es obligatorio.
+ Utilice únicamente letras (a-z, A-Z), números (0-9), guiones (-) o guiones bajos (\$1).
+ Debe comenzar con una letra o un número (no un guion bajo).
+ Longitud máxima de 255 caracteres.
**nota**
El sitio web de Amazon Connect administración usa este nombre como el `DisplayName` del segmento y genera un `SegmentDefinitionName` identificador único. Este identificador se utiliza al acceder al segmento a través de los perfiles de clientes de Amazon Connect APIs.
En **Descripción** (opcional), añada detalles sobre su segmento:
+ Longitud máxima de 1000 caracteres
## Asignación de atributos de los clientes
La asignación de tipos de objetos define la forma en que Perfiles de clientes procesa los datos CSV. Esta asignación:
+ determina de qué forma rellenan los datos CSV los objetos de perfil estándar,
+ especifica qué campos se van a indexar para la asignación de perfiles.
Para obtener más información sobre la asignación de tipos de objeto, consulte [Creación e ingesta de datos de clientes en Perfiles de clientes](customer-profiles-object-type-mappings.md).
Elija una de estas opciones para asignar sus columnas CSV a los atributos de Perfiles de clientes:
### Opción 1: asignación con tecnología de IA (recomendado)
1. Elija **Generar atributos de cliente** y, a continuación, **Siguiente**.
1. El sistema analiza los encabezados de los CSV y sugiere las asignaciones adecuadas a los atributos de perfil estándar.
1. Revise las asignaciones sugeridas.
1. (Opcional) Personalice las asignaciones:
+ Modifique las asignaciones de atributos de perfil estándar.
+ Añada atributos personalizados con el formato: `Attributes.attribute-name`.
+ Actualice el identificador único.
### Opción 2: asignación manual
1. Asigne el encabezado de cada columna CSV a un atributo de perfil:
+ Utilice atributos de perfil estándar. Para ver una lista completa, consulte [Definición de perfil estándar en los perfiles de clientes de Amazon Connect](standard-profile-definition.md).
+ Cree atributos personalizados con el formato: `Attributes.attribute-name`.
**nota**
Puede asignar hasta 25 atributos.
1. Elija un atributo de asignación como identificador del cliente (clave única).
### Elección de un identificador de cliente
Tras completar la asignación, elija un atributo de asignación como identificador del cliente. Perfiles de clientes de Amazon Connect utiliza este identificador para lo siguiente:
+ crear nuevos perfiles o actualizar los existentes,
+ hacer coincidir los datos entrantes con los perfiles existentes.
**nota**
Las asignaciones de atributos se pueden modificar en cualquier momento durante la configuración, ya sea mediante una asignación manual o mediante la IA.
## Configuración del vencimiento del perfil
Especifique cuándo caducan los perfiles importados:
1. Elija una opción de vencimiento:
+ Predeterminada: 14 días a partir de la fecha de importación
+ Personalizada: seleccione una fecha con el selector de fechas
1. Para fechas de caducidad personalizadas:
+ Mínimo: 1 día después de la importación
+ Máximo: 90 días después de la importación
Perfiles de clientes elimina los perfiles caducados del segmento y del dominio de perfiles.
**nota**
Elija un período de vencimiento que se ajuste a sus requisitos de retención de datos. Antes de seleccionar una fecha personalizada, considere si el período predeterminado de 14 días se ajusta a las necesidades de su empresa.
## Creación y supervisión de la importación de segmentos
**Creación del segmento**
1. Revisión de la configuración de seguridad de .
1. Seleccione **Create segment (Crear segmento)**.
1. El sistema hará lo siguiente:
+ cargar el archivo CSV,
+ crear o actualizar perfiles en función de los datos,
+ agrupar los perfiles en un segmento,
+ mostrar el progreso mediante un banner de notificación.
Supervisión del progreso de la importación
+ Consulte el progreso de la importación en la página de detalles del segmento.
+ En el banner de notificación se muestra que el trabajo de importación está en curso.
+ La tabla de detalles del trabajo de importación muestra lo siguiente:
+ Nombre de archivo
+ Fecha de creación del trabajo de importación
+ Fecha de finalización del trabajo de importación
+ Número de perfiles procesados
+ Número de importaciones correctas
+ Número de importaciones fallidas
+ Puede cancelar la importación mientras está en curso.
+ El segmento se puede usar en las campañas mientras el trabajo de importación aún esté en curso.
**nota**
Los segmentos importados se pueden usar como cualquier otro segmento para las campañas externas o las exportaciones una vez finalizada la importación. Puede ver la información del segmento, incluidos el estado de la importación y los resultados, en la página de detalles del segmento.
# Exportación de segmentos de clientes a un archivo CSV en Amazon Connect
Desde la página de **segmentos de clientes** del sitio web de Amazon Connect administración, puede exportar un segmento existente a un archivo de su ordenador. Cuando lo haces, Customer Profiles exporta todos los atributos del perfil asociados a los perfiles del segmento de clientes a un archivo CSV.
**Cómo exportar un segmento de clientes**
1. En la página Segmentos de clientes, seleccione **Exportar CSV** en el menú desplegable de acciones.
![\[La página Segmentos de clientes con la opción Exportar CSV.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png)
Como alternativa, puede ir a la página **Ver detalles** y seleccione **Siguientes acciones** y **Descargar**.
![\[La página Detalles del segmento de un segmento con la opción Siguientes acciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png)
**nota**
El sitio web de Amazon Connect administración permite exportar un segmento de clientes que contenga hasta 350 000 perfiles. Si necesita exportar un segmento que contiene una gran cantidad de perfiles, utilice la operación `CreateSegmentSnapshot` de la API de Perfiles de clientes. La operación `CreateSegmentSnapshot` permite exportar un segmento en archivos con formato ORC, JSONL y CSV a un bucket de S3. Tenga en cuenta que la API genera un archivo de prueba además del segmento exportado en el bucket.
1. Una vez que comience el trabajo de exportación, mantenga abierta la ventana o pestaña que contiene la descarga hasta que se complete el proceso.
![\[Un mensaje que indica que el segmento se está exportando.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png)
1. Una vez finalizado el trabajo de exportación, el sitio web de Amazon Connect administración comienza a descargar el archivo automáticamente.
![\[Un mensaje que indica que el segmento se ha descargado correctamente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png)
El archivo CSV exportado contiene todos los [atributos estándar y de perfil de cliente](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html) rellenados en los perfiles exportados.
# Uso del asistente de IA de segmentación en Amazon Connect
Perfiles de clientes de Amazon Connect admite la segmentación basada en la IA generativa, lo que permite a los usuarios empresariales sin conocimientos técnicos crear audiencias mediante consultas en lenguaje natural ([asistente de IA de segmentación](#generating-a-segment-by-prompt)) y recibir recomendaciones basadas en las tendencias de los datos de los clientes ([tarjetas de inspiración para la creación de segmentos](#inspiration-cards-for-segment-creation)). Estas capacidades aprovechan los algoritmos de IA avanzados de [Amazon Bedrock](https://aws.amazon.com/bedrock/) que lo ayudan a mejorar la satisfacción de los clientes y a generar ingresos a través de un alcance proactivo y personalizado. Por ejemplo, puede crear un segmento de clientes que la semana pasada contactaron con frecuencia con el servicio de atención al cliente para ofrecerles ofertas de servicios personalizadas. También puede identificar a los clientes cuyos gastos totales aumentaron y ofrecerles descuentos personalizados, lo que fomentaría la fidelidad y también impulsaría el crecimiento.
Al incorporar la IA generativa en el flujo de trabajo de segmentación, se añaden los siguientes beneficios:
+ **Creación de segmentos simplificada**: cree segmentos de clientes complejos con lenguaje conversacional, de manera que el proceso sea accesible para los usuarios sin conocimientos técnicos e impulse la eficiencia.
+ **Inspiraciones para la creación de segmentos basadas en datos**: reciba inspiraciones de segmentos impulsados por la IA basadas en las tendencias de los datos de los clientes.
+ **Personalización mejorada**: identifique fácilmente y diríjase a grupos de clientes específicos para obtener comunicaciones y ofertas personalizadas.
En las siguientes secciones se explica cada característica, cómo utilizarla y las ventajas que ofrecen para ayudarle a mejorar sus esfuerzos de segmentación de clientes.
**nota**
Para utilizar el asistente de IA de segmentos, los usuarios necesitarán el permiso para crear segmentos **CustomerProfiles.Segments.Create.**
Si bien estas herramientas basadas en la IA ofrecen sugerencias valiosas, es importante revisar y adaptar los segmentos recomendados para garantizar que coincidan con los objetivos empresariales específicos de la organización y cumplan sus políticas de uso de datos.
## Tarjetas de inspiración para la creación de segmentos
Las tarjetas de inspiración son una característica basada en la IA de la página **Segmentos de clientes**. Estas tarjetas simplifican y mejoran el proceso de creación de segmentos. En la siguiente imagen se muestra un ejemplo de tres tarjetas de inspiración.
![\[Un ejemplo de tarjetas de inspiración en la página Segmentos de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png)
Estas tarjetas generan hasta tres categorías de ideas de segmentos cada vez, en función de los datos del Perfil de cliente de Amazon Connect, para inspirar y agilizar el proceso de creación de segmentos.
**nota**
Los datos de tendencias se basan en las fechas de ingesta de eventos de los atributos calculados de forma predeterminada.
**Características principales**
+ **Inspiraciones basadas en datos**: cada tarjeta de inspiración presenta una idea de segmento adaptada a datos y tendencias específicos de los clientes.
+ Las tarjetas de inspiración ofrecen ideas sobre tres temas centrados en el negocio:
+ **Promoción**: ideas para dirigirse a los clientes con estrategias de promoción específicas.
+ **Retención**: identifique los segmentos para las iniciativas de retención de clientes.
+ **Soporte**: destaque los grupos de clientes que puedan necesitar atención especializada para el servicio de atención al cliente.
+ **Recomendaciones basadas en información**: aproveche las tendencias históricas, la información recopilada sobre los datos y la IA generativa para crear información útil y procesable.
**Cómo usar las tarjetas de inspiración**
1. Vaya a la página **Segmentos de clientes**.
1. Busque la sección de tarjetas de inspiración, que muestra tres sugerencias de segmentos.
1. Revise cada tarjeta para comprender el segmento propuesto y sus posibles aplicaciones.
1. Cuando encuentre una tarjeta que quiera usar, elija **Empezar** en esa tarjeta.
1. Elija **Explore más** para generar más tarjetas de inspiración. Estas pueden ofrecer nuevas ideas de segmentación basadas en los datos de Perfiles de clientes de Amazon Connect.
1. Si elige **Empezar**, se le redirige automáticamente a la página **Crear segmento**.
1. La idea de segmento que ha seleccionado se rellena en el generador de segmentos y está lista para que la revise y la perfeccione.
## Generación de un segmento mediante peticiones en lenguaje natural
El asistente de IA de segmentación ofrece un enfoque guiado para crear segmentos mediante peticiones en lenguaje natural, lo que simplifica el proceso de creación de segmentos complejos, ya que le permite describir su audiencia objetivo en un lenguaje natural y recibir una definición de segmento estructurada y procesable.
En la siguiente imagen se muestra un ejemplo de una petición del asistente de IA de segmentación.
![\[Un ejemplo de peticiones del asistente de IA de segmentación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png)
**Para acceder a esta característica:**
1. Vaya a la página **Segmento de clientes** y, a continuación, elija **Crear segmento**.
1. Localice el panel del asistente de IA de segmentación en el lado derecho de la página, tal como se muestra en la siguiente imagen.
![\[Un ejemplo del panel de asistente de IA de segmentación en el lado derecho de la página.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png)
**Uso del asistente de IA de segmentación**
1. El asistente guía a los usuarios a través de una serie de preguntas para comprender las necesidades de segmentación. Todas las rutas de interacción con el asistente conducen a la generación de una petición.
1. Los usuarios pueden proporcionar una descripción textual del segmento deseado.
1. El paso de acción de petición ofrece peticiones de ejemplo como referencia para escribir descripciones detalladas.
1. En función de los datos, Amazon Connect genera una definición de segmento estructurada.
1. La definición de segmento generada se aplica automáticamente al generador de segmentos.
1. Puede refinar aún más el segmento generado con las herramientas del generador de segmentos estándar. La modificación de los filtros en el generador de segmentos anula las condiciones existentes generadas anteriormente.
1. Tras revisar el segmento generado y realizar los ajustes necesarios, puede finalizar el proceso seleccionando **Crear segmento**. Esta acción guarda el segmento y lo pone a disposición para usarlo en las campañas.
**Prácticas recomendadas**
Cuando utilice el asistente de IA de segmentación, tenga en cuenta las siguientes prácticas recomendadas:
+ Escriba descripciones específicas. El asistente de IA de segmentación genera condiciones más precisas si utiliza los nombres de los atributos existentes.
+ Asegúrese de que todos los atributos a los que hace referencia se encuentren en su dominio.
+ Empiece con peticiones sencillas y pruebe con peticiones diferentes. Si no recibe lo que desea en el primer intento, reescriba la petición. Al enviar una petición nueva, se sustituyen las condiciones existentes o se selecciona **Nueva conversación**.
+ Dedique tiempo al refinamiento y la validación de los segmentos en el generador de segmentos para garantizar que los segmentos reflejen con precisión sus valores de datos reales.
**nota**
El asistente de IA de segmentación está diseñado para funcionar con descriptores y criterios generales. Siga siempre las normas de protección de datos y las políticas de la empresa al describir los segmentos. Asegúrese de que sus peticiones y descripciones no contengan información confidencial o personal.
## Comentarios sobre los segmentos generados
Una vez generado un segmento, se recomienda a los usuarios que evalúen el rendimiento de la característica y envíen sus comentarios. Este mecanismo ayuda a mejorar el proceso de generación de segmentos y garantiza que se satisfagan las necesidades empresariales de manera eficaz. En la siguiente imagen se muestra una página de comentarios.
![\[Un ejemplo de un mensaje en el que se indica que se han grabado sus comentarios.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png)
El proceso de envío de comentarios consta de dos pasos:
1. **Reacción inicial**: en la esquina inferior derecha de la sección de alertas, encontrará los iconos con el pulgar hacia arriba y el pulgar hacia abajo. Haga clic en uno de los dos para expresar su satisfacción general con el segmento generado.
1. **Comentarios adicionales**: después de seleccionar el icono con el pulgar hacia arriba o hacia abajo, se le presentará la opción de enviar comentarios más detallados. Verá un campo de entrada de texto en el que puede escribir comentarios en texto de formato libre.
Le recomendamos que utilice tanto la reacción rápida (con el pulgar hacia arriba o hacia abajo) como la introducción de texto para realizar una evaluación exhaustiva, proporcionar ejemplos o casos de uso específicos cuando proceda, centrarse en la forma en que el segmento generado sigue los objetivos empresariales y sugerir mejoras o características adicionales que podrían mejorar el proceso de generación de segmentos.
Sugiera mejoras o características adicionales que mejorarían el proceso de generación de segmentos.
Al participar activamente en el proceso de comentarios, los usuarios contribuyen a la mejora continua de la característica de generación de segmentos, lo que, en última instancia, conduce a una segmentación de clientes más eficaz y a estrategias de marketing específicas.
## Gestión de errores
Al utilizar el asistente de IA de segmentación para generar segmentos de clientes, es posible que en ocasiones aparezca un mensaje de error que diga: **We can't process your request right**. Este error puede producirse incluso después de proporcionar una petición válida para la creación de segmentos.
En la siguiente imagen se muestra un ejemplo de este mensaje de error.
![\[Un ejemplo de mensaje de error que indica que Amazon Connect no puede procesar la petición.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png)
Siga los siguientes pasos para entender y solucionar este error.
**Causas posibles:**
+ **Carga elevada del sistema**: es posible que el asistente de IA de segmentación reciba una gran demanda o procese varias solicitudes simultáneamente.
+ **Interrupción temporal del servicio**: podría producirse una breve interrupción en la capacidad del servicio para procesar las solicitudes de nuevos segmentos.
+ **Consulta compleja**: es posible que el sistema necesite más tiempo para procesar consultas de segmentos particularmente complejas o que requieran muchos recursos.
**Qué hacer:**
+ **Esperar y volver a intentarlo**: el mensaje de error sugiere esperar unos minutos antes de volver a intentarlo. Esto da tiempo al sistema para resolver los problemas temporales.
+ **Crear un segmento manualmente**: si necesita el segmento inmediatamente, puede crearlo de forma manual con el generador de segmentos.
**Cómo volver a intentarlo:**
1. Espere unos minutos.
1. Seleccione **Nueva conversación** en la parte inferior de la interfaz de chat.
1. Inicie una conversación nueva y vuelva a introducir la petición de creación del segmento.
**Prácticas recomendadas**
+ Si el error persiste tras varios intentos, puede simplificar los criterios del segmento o dividirlos en solicitudes más pequeñas y fáciles de administrar.
+ Evite realizar solicitudes repetidas y sucesivas, ya que esto podría contribuir a la sobrecarga del sistema.
+ Si el problema persiste, póngase en contacto con el servicio de atención al cliente para obtener más ayuda.
Recuerde que este error suele ser temporal y que, si sigue las instrucciones proporcionadas, podrá crear correctamente el segmento deseado.
## Limitaciones conocidas
Comprender el ciclo de vida del procesamiento de datos es crucial para usar el asistente de IA de segmentación de forma eficaz. En esta sección se describe lo que los usuarios empresariales pueden esperar durante las diferentes fases de la integración de datos y cómo afecta esto a las sugerencias de segmentos.
**Procesamiento de datos e impacto en la calidad:** el asistente de IA de segmentación evoluciona a través de dos fases principales: la ingesta de datos inicial y el procesamiento posterior. Durante la ingesta inicial, es posible que el sistema no utilice plenamente los valores de los atributos reales y se base más en una interpretación de las peticiones. Por ejemplo, una petición para *clientes VIP* podría sugerir un segmento *VIP* en lugar de utilizar el nivel *Oro* existente en sus datos. Tras finalizar el procesamiento, el sistema aprovecha los valores de los atributos reales, lo que resulta en una creación de segmentos más precisa, reduce la confianza en la interpretación de las peticiones y mejora la calidad general de la segmentación.
**nota**
Deje tiempo suficiente para completar el procesamiento de los datos antes de confiar en las características avanzadas. Actualice los datos del perfil del cliente con regularidad. La precisión de los segmentos depende de la integridad y la actualidad de los datos de clientes de Perfiles de clientes de Amazon Connect. El sistema marca cualquier atributo que falte en sus respuestas.
**Rendimiento del sistema:** durante los períodos de gran volumen, es posible que se produzcan retrasos en la generación de segmentos. El sistema está optimizado para gestionar cargas de trabajo típicas, pero es posible que las empresas con grandes necesidades de segmentación deban ajustar sus procesos en consecuencia.
**Disponibilidad de los atributos**: la calidad de los segmentos generados depende de los datos de los clientes disponibles en Perfiles de clientes de Amazon Connect. Cuanto más completos sean los datos up-to-date del perfil del cliente, más preciso será el sistema a la hora de interpretar las indicaciones y definir los segmentos relevantes. Si un atributo no existe, devolveremos un mensaje con el atributo que falta.
**Complejidad de la petición**: en el caso de definiciones de segmentos muy complejas o con matices, el procesamiento del lenguaje natural puede sufrir limitaciones. Los clientes deberían empezar con peticiones relativamente sencillas y aumentar gradualmente la complejidad a medida que vayan adquiriendo experiencia con la característica.
**Perfeccionamiento de los segmentos**: si bien los segmentos generados por el sistema son un buen punto de partida, es posible que los clientes prefieran revisar y afinar los detalles para asegurarse de que el segmento se ajuste perfectamente a sus objetivos empresariales. La interfaz de segmentación permite una personalización completa después de la generación inicial.
**Rendimiento y escalado**: en condiciones de alta simultaneidad, es posible que haya cierta latencia en el proceso de generación de segmentos, ya que el modelo de lenguaje necesita procesar cada petición. El sistema está diseñado para gestionar las cargas de trabajo de segmentación típicas, pero es posible que los clientes con demandas de segmentación extremadamente altas deban ajustar sus flujos de trabajo en consecuencia.
# Solución de problemas de segmentos de clientes en Amazon Connect
## La opción Segmentos de clientes no aparece en el panel de navegación izquierdo
Si no existe la opción **Segmentos de clientes** en el panel de navegación izquierdo del sitio web de Amazon Connect administración, compruebe si los perfiles de seguridad del usuario tienen el permiso **Segmentar clientes: ver**. Para obtener más información, consulte[Asignación de permisos de perfil de seguridad para administrar segmentos de clientes](security-profile-customer-profile-segmentation.md). Una vez actualizado el permiso, actualice la página del sitio web de administración de Amazon Connect para reflejar el cambio.
## El botón Exportar CSV no está disponible o se ha agotado el tiempo de espera del trabajo de exportación
El sitio web de Amazon Connect administración no admite la exportación de un segmento que contenga más de 350 000 perfiles. Como alternativa, recomendamos exportar este tipo de segmento a un bucket de Amazon S3 mediante la API `CreateSegmentSnapshot` a través de la referencia de la línea de comandos (CLI) o el SDK.
## Error: Ha alcanzado el límite de 60 atributos únicos
Este error se produce cuando se supera la cuota de atributos únicos de la definición del segmento. Se cuenta el número de atributos únicos, más las audiencias iniciales, de forma recursiva.
**Soluciones**
+ Para reducir el número de atributos únicos, quite los filtros de audiencia en la definición del segmento o quite las audiencias iniciales que contengan filtros de audiencia.
+ [Solicitar un aumento de la cuota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) de las cuotas de servicio: número máximo de atributos únicos por segmento.
Para obtener más información sobre la cuota de servicios predeterminada, consulte [Cuotas de servicio de Perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Error: Ha alcanzado el límite de 10 atributos calculados únicos
Este error se produce cuando se supera la cuota de atributos calculados únicos de la definición del segmento. Se cuenta el número de atributos calculados únicos, más las audiencias iniciales, de forma recursiva.
**Soluciones**
+ Para reducir el número de atributos calculados únicos, quite los filtros de audiencia en los atributos calculados en la definición del segmento o quite las audiencias iniciales que contengan filtros de audiencia en los atributos calculados.
+ [Solicitar un aumento de la cuota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) de las cuotas de servicio: número máximo de atributos calculados únicos en el segmento.
Para obtener más información sobre la cuota de servicios predeterminada, consulte [Cuotas de servicio de Perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
## Error: Ha alcanzado el límite de profundidad 5 de las audiencias iniciales
Este error se produce cuando la profundidad de las audiencias iniciales supera la cuota. La profundidad se cuenta de forma recursiva para todas las audiencias iniciales de su grupo de audiencias. Por ejemplo, si selecciona un segmento Mejora de alquiler elegible como público inicial y el segmento Mejora de alquiler elegible tiene otro segmento como público inicial, la profundidad será de 2.
**Solución**
+ Elimine una o más audiencias iniciales de su grupo de audiencia que contenga audiencias iniciales muy agrupadas.
Para obtener más información sobre las cuota de servicio predeterminada, consulte [Cuotas de servicio de Perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles).
# Configuración del Explorador de perfiles en Perfiles de clientes de Amazon Connect
El explorador de perfiles de clientes de Amazon Connect es un all-in-one panel dinámico que ofrece una vista integral de 360° de sus clientes. Unifica los datos fragmentados de los clientes y permite a las organizaciones personalizar las presentaciones de datos, realizar un seguimiento de las interacciones y transformar la información de los clientes en información procesable que impulsa el valor empresarial y la fidelización de los clientes. Las organizaciones de sectores como el de la hostelería y los viajes pueden usar el Explorador de perfiles para comprender mejor a sus clientes e interactuar con ellos a través de esta interfaz intuitiva.
+ **Encuentre a los clientes de forma inmediata** utilizando varios identificadores de forma simultánea (correo electrónico, teléfono, código de reserva, etc.) y obtenga resultados de búsqueda en tiempo real.
+ **Personalice las vistas** para priorizar la información más relevante en función de las necesidades empresariales específicas y cree un diseño específico para cada dominio que destaque los datos de clientes más relevantes que haya definido.
+ **Acceda al contexto completo de los clientes**, incluidos los datos demográficos, el historial de comunicaciones, las interacciones conductuales y la pertenencia a los segmentos, con visualizaciones interactivas y pantallas de datos.
+ **Aproveche la información basada en la IA** con resúmenes de clientes que destaquen los patrones clave e inferencias de comportamiento personalizadas.
![\[El panel Explorador de perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png)
**Topics**
+ [
# Activación de Explorador de perfiles
](enabling-profile-explorer.md)
+ [Introducción](getting-started-profile-explorer.md)
+ [
# Definición del diseño
](layout-definition.md)
+ [
# Adición del Explorador de perfiles al espacio de trabajo del agente
](add-profileexplorer-to-agentworkspace.md)
# Activación de Explorador de perfiles
Los siguientes pasos le permiten activar el Explorador de perfiles para sus administradores y usuarios. Este proceso implica establecer los permisos tanto para la configuración del diseño como para el acceso a la visualización.
**Topics**
+ [
## Concesión de permisos para que los administradores puedan definir un diseño
](#enable-administrators-define-layout)
+ [
## Concesión de permisos para que los usuarios vean el Explorador de perfiles
](#enable-users-view-profile-explorer)
+ [
## Verificación de la configuración
](#verify-setup)
## Concesión de permisos para que los administradores puedan definir un diseño
Los administradores necesitan permisos específicos para crear y editar los diseños del Explorador de perfiles:
+ Asigne los siguientes permisos en el perfil de seguridad del Explorador de perfiles:
+ **Explorador de perfiles - Editar**: permite modificar el diseño del Explorador de perfiles existente.
+ **Explorador de perfiles - Crear**: permite crear el diseño del Explorador de perfiles.
+ **Explorador de perfiles - Ver**: permite ver el diseño configurado del Explorador de perfiles.
![\[Agregue permisos para permitir a los usuarios crear, editar y ver los diseños del Explorador de perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-administrators-define-layout-1.png)
## Concesión de permisos para que los usuarios vean el Explorador de perfiles
Los usuarios necesitan los permisos adecuados para acceder e interactuar con el diseño del Explorador de perfiles:
+ Asigne los siguientes permisos en el perfil de seguridad del Explorador de perfiles:
+ **Explorador de perfiles - Ver**: permite ver el diseño configurado del Explorador de perfiles.
![\[Adición de permisos para que los usuarios puedan ver los diseños del Explorador de Perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png)
## Verificación de la configuración
Para confirmar que el Explorador de perfiles se puede activar correctamente, haga lo siguiente:
Inicie sesión como administrador para comprobar que puede:
+ acceder a la página del Explorador de perfiles,
+ crear y modificar el diseño de su Explorador de perfiles.
Inicie sesión como usuario normal para comprobar que puede:
+ acceder al Explorador de perfiles,
+ ver el diseño del Explorador de perfiles,
+ interactuar con las características activadas.
# Introducción al Explorador de perfiles de Perfiles de clientes de Amazon Connect
Comience a utilizar el Explorador de perfiles y aprenda los aspectos básicos de la interfaz.
**Topics**
+ [
# Controles de diseño
](layout-controls.md)
+ [
# Edición del diseño del explorador
](editing-explorer-layout.md)
+ [
# Grabación del diseño del explorador
](saving-explorer-layout.md)
# Controles de diseño
![\[Adición de permisos para que los usuarios puedan ver los diseños del Explorador de Perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/layout-controls-1.png)
Consola de bienvenida del Explorador de perfiles.
1. Edición de etiquetas
1. Adición de widgets
1. Acciones de diseño
## Edición de etiquetas
Organice su panel en secciones lógicas mediante los controles de pestañas:
+ **1a. Añadir pestaña**: cree nuevas pestañas para separar diferentes aspectos de los datos de los clientes
+ **1b. Eliminar pestaña**: elimine las pestañas innecesarias del diseño
+ **1c. Cambiar el nombre de la pestaña**: personalice los nombres de las pestañas para que reflejen su contenido
+ **1d. Reordenar las pestañas**: arrastre y suelte las pestañas para organizarlas en el orden que prefiera
![\[Ventana emergente de edición de pestañas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/layout-controls-2.png)
## Agregar widgets
Amplíe la pestaña activa con varios widgets de visualización de datos:
### Widgets disponibles
+ Widgets predeterminados
+ [Resumen de la IA generativa](default-widgets.md#generative-ai-summary)
+ [Información del cliente](default-widgets.md#customer-information)
+ [Atributo calculado](default-widgets.md#calculated-attribute)
+ [Contactos](default-widgets.md#contacts)
+ [Casos](default-widgets.md#cases-cp)
+ [Pedidos](default-widgets.md#orders-cp)
+ [Activos](default-widgets.md#assets-cp)
+ Widgets personalizados
+ [Tabla](custom-widgets.md#table-widget)
+ [Par clave-valor](custom-widgets.md#key-value-pair)
+ [Métrica clave](custom-widgets.md#key-metric)
+ [Gráfico de anillos](custom-widgets.md#donut-chart)
Solo tiene que seleccionar el widget que quiere utilizar y empezar a explorar.
## Acciones de diseño
Administre la configuración general del panel:
+ **Guardar diseño**: conserve la configuración actual del panel.
![\[Guarde la ventana emergente del diseño.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/layout-controls-3.png)
**nota**
Todos los cambios son provisionales hasta que se guarden.
# Edición del diseño del explorador
Personalice el diseño del Explorador de perfiles con controles sencillos e intuitivos para administrar los widgets y su ubicación.
## Controles de widgets
Cada widget incluye un menú de tres puntos en la esquina superior derecha, que ofrece dos opciones principales:
+ **1A Editar**: abre el panel de configuración para ese widget específico.
+ **1B Eliminar**: elimina el widget del diseño.
![\[Edita o elimina la ventana emergente del diseño del explorador.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/widget-controls-1.png)
## Personalización de widgets
+ **Arrastrar y soltar**: reposicione los widgets en cualquier lugar del panel.
+ **Cambiar el tamaño**: elija y arrastre los bordes de los widgets para ajustar las dimensiones.
+ **Configuración**: acceda a los ajustes detallados a través del panel de edición específico para cada tipo de widget
![\[Personalice y reordene sus widgets en el diseño del explorador.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/widget-customization-1.png)
**nota**
Cada tipo de widget tiene opciones de configuración únicas. Para obtener información detallada sobre la configuración específica de los widgets, consulte la documentación de los widgets.
## Adición de widgets nuevos
Para añadir nuevos componentes a su diseño, utilice el botón **Añadir widgets** del panel de control.
# Grabación del diseño del explorador
Cómo guardar y administrar las configuraciones de diseño del Explorador de perfiles.
## Persistencia del diseño
Los cambios realizados en el diseño del Explorador de perfiles deben guardarse para que se conserven. Los cambios no guardados se perderán al salir de la página o al actualizar el navegador.
## Diseño predeterminado
Cada implementación del Explorador de perfiles incluye un diseño predeterminado que sirve como configuración base para su organización y se puede modificar según sea necesario.
## Grabación de los cambios
Para guardar las modificaciones del diseño:
1. Elija **Guardar** en el menú Acciones de diseño.
1. Confirme los cambios en el cuadro de diálogo para guardar.
1. El diseño se actualizará para todos los usuarios al finalizar el proceso.
![\[Guarde el cuadro de diálogo de diseño en el diseño del explorador.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/saving-changes-1.png)
**nota**
Se necesitan los permisos adecuados para guardar los cambios en el diseño. Para obtener más información acerca de los permisos necesarios, consulte [Activación de Explorador de perfiles](enabling-profile-explorer.md).
# Definición del diseño
Comprender la estructura y los componentes de los diseños del Explorador de perfiles.
**Topics**
+ [
# Funcionamiento
](how-it-works.md)
+ [
# Widgets
](widgets.md)
# Funcionamiento
El Explorador de perfiles ofrece varios widgets para mostrar la información de los clientes. Los diseños se almacenan como definiciones de JSON y representan la estructura y la configuración completas de su panel. Cada widget y componente del diseño visual corresponde a un bloque JSON específico dentro de esta definición.
## Componentes básicos
Cada componente de la definición del diseño se compone de cinco elementos comunes:
+ **Tipo**
+ Define la categoría del componente
+ Determina cómo se representa el componente
+ Ejemplos: BoardItem, Tabla, KeyValuePair
+ **Id**
+ Identificador único para cada componente
+ Se utiliza para el seguimiento y las actualizaciones de los componentes
+ Se genera automáticamente cuando los componentes se crean en el generador
+ **Accesorios**
+ Propiedades específicas de los componentes
+ Controla el aspecto y el comportamiento
+ Contiene los ajustes de configuración
+ **Niños**
+ Componentes o contenido anidados
+ Define las relaciones jerárquicas
+ Puede contener varios subcomponentes
+ **DataSource**
+ Especifica el origen de los datos
+ Define los parámetros de obtención de datos
+ Controla el enlace de datos de los componentes
## Ejemplo de definición de componente de diseño
El siguiente es un ejemplo de estructura JSON para un componente de tabla de panel:
```
{
"Id": "unique-identifier",
"Type": "BoardItem",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "Table",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "TextContent",
"Props": {},
"Children": ["string"]
}
]
}
],
"DataSource": [
{
"Type": "source-type",
"Params": {}
}
]
}
```
## Configuración de datos dinámicos
El Explorador de perfiles utiliza expresiones de plantilla para acceder a los datos de los perfiles de los clientes y mostrarlos de forma dinámica en sus componentes.
### Compatibilidad con un valor único
Para componentes como los pares de clave-valor y las métricas clave, puede acceder a:
#### Información del perfil estándar
```
{{Customer.}}
```
Ejemplo de uso:
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`
#### Atributos calculados
```
{{Customer.CalculatedAttributes.}}
```
Ejemplo de uso:
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`
### Sintaxis que admite datos tabulares
#### Atributos calculados
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```
#### Segmentos
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```
#### Objetos del perfil
```
{{Customer.ObjectAttributes..}}
```
**Ejemplo de uso**:
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`
### Ejemplos de implementación
#### Componente de valor único
```
{
"Type": "KeyValuePair",
"Props": {
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Children": ["Customer Name"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.FirstName}}"]
}
}
}
]
}
}
```
#### Componente tabular
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Cell": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
}
},
"Header": "Contact ID"
}
]
}
}
```
**nota**
Asegúrese de que los atributos, objetos y segmentos a los que hace referencia existan en la configuración de los perfiles de cliente antes de utilizarlos en su diseño.
# Widgets
Explore los diferentes tipos de widgets disponibles en el Explorador de perfiles.
## Descripción general de
Los widgets del Explorador de perfiles son elementos compuestos creados a partir de componentes JSON incluidos en su definición del diseño. Si bien estos widgets representan estructuras JSON complejas, nuestro generador de interfaces de usuario gestiona la composición técnica de forma automática, lo que hace que administrar los paneles sea una tarea sencilla y accesible.
**Topics**
+ [
## Descripción general de
](#widgets-overview)
+ [
## Widgets disponibles
](#available-widgets)
+ [
# Widgets predeterminados
](default-widgets.md)
+ [
# Widgets personalizados
](custom-widgets.md)
## Widgets disponibles
+ Widgets predeterminados
+ [Resumen de la IA generativa](default-widgets.md#generative-ai-summary)
+ [Información del cliente](default-widgets.md#customer-information)
+ [Atributo calculado](default-widgets.md#calculated-attribute)
+ [Contactos](default-widgets.md#contacts)
+ [Casos](default-widgets.md#cases-cp)
+ [Pedidos](default-widgets.md#orders-cp)
+ [Activos](default-widgets.md#assets-cp)
+ Widgets personalizados
+ [Tabla](custom-widgets.md#table-widget)
+ [Par clave-valor](custom-widgets.md#key-value-pair)
+ [Métrica clave](custom-widgets.md#key-metric)
+ [Gráfico de anillos](custom-widgets.md#donut-chart)
# Widgets predeterminados
El Explorador de perfiles incluye una colección de widgets preconfigurados diseñados para funcionar sin problemas con los datos de los Perfiles de los clientes. Estos widgets predeterminados ofrecen un valor inmediato con una configuración mínima, lo que le permite crear paneles sofisticados con unos pocos clics.
![\[Añada widgets predeterminados en el diseño del explorador.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/default-widgets-1.png)
## Ready-to-use widgets
+ [Resumen de la IA generativa](#generative-ai-summary)
+ [Información del cliente](#customer-information)
+ [Atributo calculado](#calculated-attribute)
+ [Contactos](#contacts)
+ [Casos](#cases-cp)
+ [Pedidos](#orders-cp)
+ [Activos](#assets-cp)
**nota**
Si bien estos widgets vienen preconfigurados, puede personalizarlos para que se adapten mejor a sus necesidades específicas. Sirven como punto de partida para facilitar la incorporación.
## Resumen de la IA generativa
El Explorador de perfiles ofrece información predeterminada sobre los clientes basada en la IA que genera resúmenes concisos en los que se destacan los patrones de comportamiento clave, proporciona información personalizada sobre los clientes basada en el historial de interacciones y ofrece recomendaciones prácticas a partir de los datos integrales de los clientes. Los resúmenes generados por la IA ayudan a las organizaciones a tomar decisiones basadas en datos al identificar patrones en varios puntos de contacto con los clientes, ofrecer información personalizada sobre el comportamiento específico de cada cliente y contribuir a mejorar las experiencias de los clientes y a aumentar su fidelidad.
![\[Widget de resumen de la IA generativa.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/generative-ai-summary-1.png)
## Información del cliente
El widget Información del cliente proporciona una visión clara y organizada de los datos estándar del perfil del cliente mediante componentes de pares clave-valor. Este widget predeterminado muestra automáticamente la información esencial del cliente en un formato que se puede escanear fácilmente.
### Descripción general de
Este widget utiliza el componente del par clave-valor para mostrar los atributos del cliente en un diseño estructurado.
+ Nombre
+ Apellido
+ Email Address
+ Número de teléfono
+ Dirección
+ Número de cuenta
+ ID de perfil
### Datos
El widget se conecta automáticamente a su dominio de Perfiles de clientes y extrae información de los atributos del perfil estándar. No se necesita configuración adicional para la funcionalidad básica.
**Nota**: Si bien este widget viene preconfigurado con los atributos de perfil estándar, puede personalizar qué atributos del perfil estándar se muestran en función de sus necesidades específicas.
#### Más información
+ [Definición de perfil estándar](standard-profile-definition.md)
+ Par clave-valor
## Atributo calculado
El widget Atributo calculado le permite mostrar un componente de métricas clave utilizando datos de los atributos calculados de los perfiles de cliente.
### Descripción general de
El widget Atributo calculado le permite mostrar un componente de métricas clave utilizando datos de los atributos calculados de los perfiles de cliente.
### Características del componente
+ Muestra las métricas calculadas como indicadores de valor único
### Ejemplos de casos de uso
+ Campañas entregadas
+ Casos abiertos
+ Tiempo medio de llamada
+ Preferencias de canal
### Configuración
Solo tiene que seleccionar el atributo calculado y elegir el formato de visualización que prefiera.
**nota**
Los atributos calculados deben configurarse en su dominio de Perfiles de clientes para poder utilizarlos en este widget.
**Más información**
+ Métrica clave
+ [Configuración de los atributos calculados](customerprofiles-calculated-attributes-admin-website.md)
## Contactos
El widget Contactos, que se crea con el componente JSON de tablas, muestra los datos del objetos de contacto de Perfiles de clientes en un formato tabular organizado. Este widget se conecta automáticamente a los datos CTR de Perfiles de clientes y muestra la información de contacto clave y el historial de interacciones.
### Características
+ Visualización de todos los eventos de contacto con clientes
+ Clasificación y filtrado de los registros de contactos
+ Personalización de los campos de contacto que se muestran
+ Acceso a información de contacto detallada
Para obtener más información sobre los objetos CTR de Perfiles de clientes, consulte [Plantillas de registro de contactos en Perfiles de clientes de Amazon Connect](ctr-contact-record-template.md).
## Casos
El widget Casos, que se crea con el componente JSON de tablas, muestra los datos del objeto de caso de Perfiles de clientes en un formato tabular organizado. Este widget se conecta automáticamente a los datos del Caso de perfiles de clientes y muestra las interacciones con el servicio de soporte y los detalles de la administración de los casos.
### Características
+ Visualización de todos los casos de clientes
+ Clasificación y filtrado de los registros de casos
+ Personalización de los campos de casos que se muestran
+ Acceso a información de caso detallada
Para obtener más información sobre los objetos de Caso de perfiles de clientes, consulte [Asignación de tipo de objeto para el caso estándar en Perfiles de clientes](object-type-mapping-standard-case.md).
## Pedidos
El widget Pedidos, que se crea con el componente JSON de tablas, muestra los datos del objeto de pedido de Perfiles de clientes en un formato tabular organizado. Este widget se conecta automáticamente a los datos de Pedido de perfiles de clientes y muestra el historial de compras y los detalles de las transacciones.
### Características
+ Visualización de todos los eventos de pedidos de clientes
+ Clasificación y filtrado de los registros de pedidos
+ Personalización de los campos de pedidos que se muestran
+ Acceso a información de pedidos detallada
Para obtener más información sobre los objetos de Pedido de perfiles de clientes, consulte [Asignación de tipos de objetos de pedidos estándar en Perfiles de clientes de Amazon Connect](object-type-mapping-standard-order.md).
## Activos
El widget Activos, que se crea con el componente JSON de tablas, muestra los datos del objeto de activos de Perfiles de clientes en un formato tabular organizado. Este widget se conecta automáticamente a los datos del Activo de perfiles de clientes y muestra los productos y servicios propiedad de los clientes.
### Características
+ Visualización de todos los registros de activos de los clientes
+ Clasificación y filtrado de los datos de activos
+ Personalización de los campos de activos que se muestran
+ Acceso a información de activos detallada
Para obtener más información sobre los objetos de Activo de perfiles de clientes, consulte [Asignación de tipo de objeto para el activo estándar de Perfiles de clientes](object-type-mapping-standard-asset.md).
# Widgets personalizados
Cree componentes de panel personalizados desde cero para satisfacer las necesidades específicas de su empresa. Los widgets personalizados le permiten crear visualizaciones únicas sin datos predefinidos.
![\[Agregue widgets de clientes al diseño del Explorador de perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/custom-widgets-1.png)
## Componentes personalizados disponibles
+ [Tabla](#table-widget)
+ [Par clave-valor](#key-value-pair)
+ [Métrica clave](#key-metric)
+ [Gráfico de anillos](#donut-chart)
## Creación de widgets personalizados
**Cada widget personalizado se puede configurar con:**
+ Orígenes de datos personalizados
+ Visualizaciones personalizadas
+ Campos personalizados
+ Interacciones de elementos personalizados
## Tabla
El componente de tabla personalizada ofrece opciones de configuración flexibles para mostrar los datos en formato tabular, con características avanzadas de interacción y organización.
### Características
1. **Configuraciones de columnas**
+ Definición de encabezados de columnas personalizados
+ Especificación de datos para cada columna
+ Configuración de las opciones de formato de datos
+ Definición de la ubicación de las columnas
1. **Filtrado**
+ Filtrado rápido de los elementos de la tabla
1. **Vinculación**
+ Enlaces de recursos de Connect
+ Navegación sin problemas hasta:
+ Segmentos
+ Atributos calculados
+ Se abre en una pestaña nueva
+ **Enlaces de URL externos**
+ Convierte el valor del elemento de la fila en el URLs que puedas elegir
+ Se abre en una pestaña nueva
+ Genere enlaces de forma dinámica en función de los datos de las filas
+ Enlaces de vista de cajón
+ Abra información detallada en el cajón lateral
+ Consulte todos los detalles del registro sin salir de la página
1. Organización de datos
+ Agrupación
+ Agrupe las filas por nombres de campo específicos
+ Configuración persistente de los grupos
+ Ordenar
+ Ordene por cualquier campo de columna
+ Organice en orden ascendente
+ Configuración de clasificación persistente
**Imagen 1**
![\[Ejemplo de edición de widgets de tablas personalizadas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/table-features-1.png)
**Imagen 2**
![\[Otro ejemplo de edición de widgets de tablas personalizadas.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/table-features-2.png)
### Configuración de ejemplo
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Header": "Table column header"
"Cell": {
"Content": {
"Props": {
"Variant": "Link",
"LinkOptions": {
"LinkType": "Drawer"
}
},
"Type": "TextContent",
"Children": ["string"]
}
},
}
]
}
}
```
## Par clave-valor
El componente Par clave-valor permite crear visualizaciones organizadas de puntos de datos relacionados en un formato flexible y legible.
### Descripción general de
Cree visualizaciones de datos dinámicas mediante la definición de relaciones clave-valor personalizadas. Este componente es particularmente útil para mostrar pares de atributos como:
+ Detalles personalizados
+ Información de cuenta
### Características
1. **Opciones de enlace interactivo**
+ Enlaces de recursos de Connect
+ Enlace directo con los recursos relacionados
+ Navegación sin problemas hasta:
+ Atributos calculados
+ Segmentos
+ Se abre en una pestaña nueva
+ Enlaces de URL externos
+ Convierte el valor del artículo en el URLs que puedas elegir
+ Se abre en una pestaña nueva
+ Enlaces de vista de cajón
+ Abra información detallada en el cajón lateral
+ Consulte todos los detalles sin salir de la página
1. Configuraciones de columnas
+ Defina de 1 a 4 columnas de pares clave-valor
1. Organice los pares en agrupaciones lógicas
**Imagen 1**
![\[Ejemplo de edición de un widget de par clave-valor personalizado\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/key-value-pair-features-1.png)
**Imagen 2**
![\[Otro ejemplo de edición de un widget de par clave-valor personalizado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/key-value-pair-features-2.png)
### Configuración de ejemplo
```
{
"Type": "KeyValuePair",
"Id": "UniqueId",
"Props": {
"Columns": 2,
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {
"FontWeight": "bold"
},
"Children": ["Profile id"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {},
"Children": ["[string]"]
}
}
}
]
}
}
```
**nota**
Actualmente, este componente no admite `ProfileObjects` en el generador de interfaces de usuario.
## Métrica clave
El componente Key Metric le permite mostrar de forma destacada las métricas empresariales fundamentales y las estadísticas vitales en un formato fácil de digerir. KPIs
### Descripción general de
Cree pantallas de métricas de alta visibilidad que destaquen puntos de datos, tendencias o indicadores de estado importantes. Este componente es ideal para mostrar:
+ Indicadores de rendimiento
+ Medidas cruciales
+ Resúmenes de estado
+ Indicadores de tendencia
### Características
1. **Texto de pantalla grande**
1. **Formato métrico**
1. **Opciones de enlace interactivo**
+ Enlaces de recursos de Connect
+ Enlace directo con los recursos relacionados
+ Navegación sin problemas hasta:
+ Atributos calculados
+ Segmentos
+ Se abre en una pestaña nueva
+ Enlaces de URL externos
+ Convierta el valor del artículo en el URLs que pueda elegir
+ Se abre en una pestaña nueva
+ Enlaces de vista de cajón
+ Abra información detallada en el cajón lateral
+ Consulte todos los detalles sin salir de la página
1. **Organice el diseño de las métricas**
**Imagen 1**
![\[Ejemplo de edición de un widget de métrica clave personalizado\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/key-metric-features-1.png)
**Imagen 2**
![\[Otro ejemplo de edición de un widget de métrica clave personalizado\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/key-metric-features-2.png)
### Configuración de ejemplo
```
{
"Type": "KeyMetrics",
"Props": {
"MetricDefinitions": [
{
"MetricLabel": "Total Revenue",
"MetricValue": {
"Content": {
"Type": "TextContent",
"Props": {
"Format": "USD",
"FontSize": "large",
"FontWeight": "bold"
},
"Children": ["[string]"]
}
},
"Columns": 1
}
]
}
}
```
**nota**
Actualmente, este componente no admite `ProfileObjects` en el generador de interfaces de usuario.
## Gráfico de anillos
El componente Gráfico de anillos permite visualizar la puntuación de opinión mediante un gráfico de anillos circular.
### Descripción general de
Cree visualizaciones dinámicas de las opiniones mediante la definición de criterios de puntuación personalizados. Este componente es particularmente útil para mostrar:
+ Métricas de éxito
+ Tasas de logros
+ Evaluaciones de riesgos
+ Indicadores de rendimiento
### Características
1. Opciones de análisis de opiniones
+ Opiniones positivas
+ Comienza desde cero
+ Realiza un seguimiento de los logros según los criterios:
+ Valores de punto personalizados
+ Segmentos codificados por colores
+ Gris para las condiciones que no se cumplen
+ Muestra el porcentaje de éxito
+ Opiniones negativas
+ Comienza con el valor máximo
+ Realiza un seguimiento de las deducciones:
+ Segmentos codificados por colores
+ Sistema de reducción de puntos
+ Verde para el valor restante
+ Muestra la puntuación final
1. Valor del atributo calculado
1. Opciones del operador
+ Igual a
+ No igual a
+ Mayor que
+ Menor que
1. Condición del valor
1. Puntos asignados por condición
**Imagen 1: Ejemplo de opinión positiva**
![\[Ejemplo de edición de un widget de opinión positiva.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/donut-chart-features-1.png)
**Imagen 2: Ejemplo de opinión negativa**
![\[Ejemplo de edición de un widget de opinión negativa.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/donut-chart-features-2.png)
### Configuración de ejemplo
```
{
"Type": "DonutChart",
"Props": {
"Variant": "PositiveSentiment",
"ConditionDefinitions": [
{
"Title": "Customer Satisfaction",
"Color": "#4CAF50",
"CalculatedAttribute": "satisfaction_score",
"Operator": "GREATER_THAN",
"ValueCondition": 8,
"Points": 10
}
]
}
}
```
**nota**
**Por el momento, los anillos solo admiten los atributos calculados como origen de datos.**
**Todas las definiciones de condiciones deben incluir un título, un color, un atributo calculado, un operador, una condición de valor y un valor en puntos.**
# Adición del Explorador de perfiles al espacio de trabajo del agente
De forma predeterminada, los usuarios que tienen los [permisos de perfil de seguridad](enabling-profile-explorer.md) adecuados pueden ver el explorador de perfiles en el sitio web de Amazon Connect administración. Se recomienda que los agentes también tengan acceso al Explorador de perfiles en su espacio de trabajo. En este tema, se explica cómo hacerlo.
En la siguiente imagen se muestra un ejemplo del Explorador de perfiles en el espacio de trabajo del agente.
![\[El espacio de trabajo del agente con la pestaña Explorador de perfiles.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
## Creación del diseño del Explorador de perfiles que desee compartir con los agentes
Esta es una descripción general:
1. Asegúrese de disponer de los [permisos del perfil de seguridad](enabling-profile-explorer.md) para crear un diseño del Explorador de perfiles.
1. Siga las instrucciones de [Introducción al Explorador de perfiles de Perfiles de clientes de Amazon Connect](getting-started-profile-explorer.md) para crear y guardar el diseño que desee compartir con los agentes.
## Añadir el explorador de perfiles a Amazon Connect como una integración
1. En la consola Amazon Connect, en el panel de navegación izquierdo, selecciona **Integraciones**, como se muestra en la siguiente imagen.
![\[La consola Amazon Connect, el elemento del menú Integraciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/integrations.png)
1. En la página de **integraciones**, selecciona **Añadir** integración.
1. En la página **Añadir integración**, rellene los siguientes campos de la sección **Información básica**:
1. **Nombre para mostrar**: un nombre descriptivo para la aplicación. **Este nombre se mostrará a los agentes en la pestaña del espacio de trabajo de agente**. También se muestra en los perfiles de seguridad. Puede volver y cambiar el nombre.
1. **Identificador de integración**: el nombre oficial exclusivo de su integración. Si solo tiene una integración por URL de acceso, le recomendamos que utilice el origen de la URL de acceso. No puede cambiar este nombre.
1. **Descripción (opcional)**: si lo desea, puede proporcionar una descripción a esta aplicación. Esta descripción no se muestra a los agentes.
1. **Tipo de integración**: elija **la aplicación estándar**.
1. **Alcance de contacto**: elija **Por contacto**. Esta es una configuración obligatoria para admitir las llamadas entrantes.
1. **Tiempo de espera de inicialización**: tiempo máximo permitido, en milisegundos, para establecer una conexión con el espacio de trabajo.
En la siguiente imagen se muestra la configuración de estos campos. El tiempo de espera de inicialización se establece en cinco segundos.
![\[La sección Información básica, configurada para el Explorador de perfiles en el espacio de trabajo del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/add-integration.png)
1. En la sección **Acciones**, complete los siguientes campos:
1. **URL de acceso**: es la URL en la que está alojada la aplicación. La URL debe ser segura y empezar por https, a menos que se trate de un host local.
**importante**
La URL debe contener `?_appLayoutMode=embedded`. Por ejemplo:
`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
Si no la incluye`?_appLayoutMode=embedded`, el panel de navegación izquierdo del sitio web de Amazon Connect administración aparece en el espacio de trabajo del agente.
Para obtener más información sobre lo que está permitido en este campo, consulte [Integraciones](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Orígenes aprobados (opcional):** lista de permitidos URLs que debería estar permitida si es diferente de la URL de acceso. La URL debe ser segura y empezar por https, a menos que se trate de un host local.
1. Completar las dos secciones siguientes (**permisos** y **Configuración de iframe**) es opcional y no es obligatorio para añadir el Explorador de perfiles al espacio de trabajo del agente. Para obtener más información sobre estas acciones, consulte [Integraciones](3p-apps.md#onboard-3p-apps-how-to-integrate).
1. **Asociación de instancias**: elija la instancia que utilizan sus agentes.
Puedes dar acceso a esta integración a cualquier instancia de esta región o cuenta.
1. Seleccione **Add Integration**.
## Asignación de permisos del nuevo perfil de seguridad a los agentes
En este paso, debes asignar a los agentes permisos para acceder a la nueva integración y ver el permiso para el explorador de perfiles.
1. En el sitio web de Amazon Connect administración, navegue hasta el perfil de seguridad del **agente**.
1. En la página **Editar perfil de seguridad**, asigne los siguientes permisos:
+ **Perfiles de clientes** - **Explorador de perfiles** - **Ver**
+ **Aplicaciones del agente**: **nombre de su integración**: **Acceso**
La siguiente imagen muestra un ejemplo de permisos agregados para una nueva integración denominada **Explorador de perfiles**.
![\[Permisos de perfil de seguridad para la nueva integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/profile-explorer-securityperms.png)
## Los agentes deberían anclar la nueva aplicación
Pida a los agentes que anclen la nueva aplicación en su espacio de trabajo usando el método de comunicación habitual. Esto les permite acceder al Explorador de perfiles en todas las instancias del espacio de trabajo.
+ En el espacio de trabajo del agente, elija el icono de más y **Anclar pestaña**, tal como se muestra en la siguiente imagen.
![\[La opción Anclar pestaña en el espacio de trabajo del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/pin-tab.png)
## Funcionalidades compatibles
Después de completar los pasos anteriores, el Explorador de perfiles admite las búsquedas en los contactos entrantes. Se admiten los siguientes:
+ Teléfono y chat: compatibilidad total
+ Atributos de contacto personalizados: compatibilidad total con los atributos definidos por el usuario que lee el Explorador de perfiles. Puede establecer atributos definidos por el usuario dentro de un flujo para adaptarse a cualquier caso de uso del cliente. Por ejemplo:
```
{
"profileSearchKey": "_phone",
"profileSearchValue": "" }
```
Para obtener más información, consulte [Autocompletado de los perfiles de clientes](auto-pop-customer-profile.md).
# Predictive Insights (versión preliminar)
*Predictive Insights* (versión preliminar) es una función de los perfiles de clientes de Amazon Connect que utiliza inteligencia artificial para generar recomendaciones personalizadas de productos y contenido para sus clientes. Al analizar los datos de interacción con los clientes, Predictive Insights le ayuda a ofrecer experiencias más relevantes en todos los puntos de contacto con los clientes.
## Cómo funciona Predictive Insights
Predictive Insights (versión preliminar) utiliza modelos de IA para analizar los patrones de comportamiento de los clientes y generar recomendaciones en tiempo real. El servicio procesa los datos de interacción con los clientes, como el historial de compras y la actividad de navegación, para identificar patrones y preferencias.
+ **Paso 1:** Añada datos de interacción a los perfiles utilizando los conectores de datos existentes para entrenar los modelos de IA con los datos de interacción con los clientes
+ **Paso 2:** Añada el catálogo de artículos a S3 para permitir que los perfiles de los clientes accedan a los datos de sus artículos a través del Consola de administración de AWS
+ **Paso 3:** Cree recomendaciones definiendo los tipos de recomendaciones (artículos similares, artículos emparejados con frecuencia, artículos populares)
+ **Paso 4:** Aplicar recomendaciones en todo el ecosistema de Amazon Connect, incluidos los agentes Agent Workspace, Flows y Connect AI
## Requisitos previos
+ **Habilite el almacenamiento de datos en los perfiles de los clientes**
Para entrenar modelos de IA con los perfiles de sus clientes, debe habilitar el almacenamiento de datos. Consulte los detalles en el almacén de datos de perfiles de clientes para obtener más información.
+ **KMS**
Ha configurado los perfiles de cliente para cifrar sus datos en un AWS KMS key.
+ **Perfiles de seguridad**
Ha configurado los perfiles de seguridad para que admitan los permisos de visualización (lista y visualización de información predictiva), creación (creación de recomendaciones), eliminación (eliminación de recomendaciones) y edición (actualización de recomendaciones) con la información predictiva habilitada.
## Ventajas de usar Predictive Insights
El uso de Predictive Insights ofrece varios beneficios clave:
+ Mejore la experiencia del cliente con recomendaciones personalizadas
+ Aumente las oportunidades de venta mediante sugerencias de productos relevantes
+ Ahorre tiempo a los agentes publicando automáticamente las recomendaciones pertinentes
+ Ofrezca recomendaciones coherentes en todos los puntos de contacto con los clientes
+ Actualice las sugerencias en tiempo real a medida que cambie el comportamiento de los clientes
# Comience con Predictive Insights
Para empezar a utilizar Predictive Insights, siga estos pasos:
**Topics**
+ [
## Paso 1: Añadir datos de interacción a los perfiles de los clientes
](#add-interaction-data)
+ [
## Paso 2: Añadir datos del catálogo de artículos
](#add-item-catalog-data)
+ [
## Paso 3: Crear información predictiva
](#create-predictive-insights)
+ [
## Paso 4: Uso de Predictive Insights en todos los canales de captación de clientes
](#use-across-customer-engagement-channels)
## Paso 1: Añadir datos de interacción a los perfiles de los clientes
Puede aprovechar los conectores de datos existentes en los perfiles de los clientes para mapear los datos de interacciones en un objeto de análisis web estándar.
Para obtener más información, consulte [Mapeo de tipos de objeto para el objeto de análisis web](standard-loyalty-promotion-object-mapping-web-analytics.md).
## Paso 2: Añadir datos del catálogo de artículos
Puede representar productos individuales de su catálogo dentro del dominio utilizando los datos del catálogo estándar. Estos datos del catálogo existen a nivel de dominio y no están vinculados a ningún perfil de cliente específico. Sirve como una representación estructurada de sus productos que puede utilizarse para funciones de personalización. Puede importar la información de sus productos o artículos como objetos de dominio a los perfiles de los clientes mediante conectores de datos que ofrecen opciones flexibles para incorporar y mantener la información de su catálogo, lo que garantiza que los datos de sus productos permanezcan actualizados y accesibles desde el sistema.
Para obtener más información, consulte [Mapeo de tipos de objetos para el catálogo de artículos](standard-loyalty-promotion-object-mapping-item-catalog.md).
## Paso 3: Crear información predictiva
Amazon Connect le permite crear e implementar modelos de IA especializados adaptados a sus necesidades específicas de recomendación de productos. Estos modelos se pueden configurar a través de la interfaz de usuario de Connect Web o mediante programación para que se APIs adapten a sus escenarios empresariales únicos. Predictive Insights ofrece varios tipos de recomendaciones:
1. **Recomendado para usted**: proporciona recomendaciones personalizadas adaptadas a un usuario específico. Las recomendaciones se basan en el comportamiento anterior del usuario, como los eventos de seguimiento de clics, los eventos de compra, el contenido consumido, etc.
1. **Artículos similares**: utiliza la IA generativa para encontrar artículos que son temáticamente similares a un artículo existente en el catálogo. Es ideal para casos de sustitución o ventas adicionales en los que los clientes desean ofrecer recomendaciones de artículos alternativos a sus usuarios.
1. **Artículos emparejados con frecuencia**: recomienda artículos que interactúan frecuentemente con un artículo existente en el catálogo. Es ideal para casos prácticos de venta cruzada o recomendación de artículos complementarios.
1. **Artículos populares**: diseñados para recomendar los artículos con los que los usuarios interactúan con más frecuencia.
1. **Tendencias actuales**: recomienda los artículos con el mayor aumento en la velocidad de participación en un período reciente. Está diseñado para mostrar elementos que están experimentando viralidad en las interacciones de los usuarios.
**nota**
La activación de los modelos de IA con Predictive Insights está disponible en versión preliminar. Es posible que se apliquen precios adicionales en el futuro.
**Límites de artículos por tipo de recomendación**
En la siguiente tabla se describe el número máximo de elementos que se tienen en cuenta para la generación de recomendaciones, en función del tipo de recomendación utilizado.
| **Tipo de recomendación** | **Descripción** | **Límite** |
| --- | --- | --- |
| Recomendaciones | Número máximo de elementos considerados para obtener información predictiva | 40 millones |
| Artículos similares | Número máximo de elementos considerados para obtener información predictiva | 10 millones |
| Todos los demás escenarios empresariales | Número máximo de elementos considerados para obtener información predictiva | 750.000 |
## Paso 4: Uso de Predictive Insights en todos los canales de captación de clientes
### Uso de recomendaciones de perfiles de clientes en Connect Flows
En esta sección, se describe cómo puede utilizar el bloque de flujo Obtener recomendaciones de perfiles de clientes para enriquecer la experiencia del usuario durante un contacto mediante la generación de recomendaciones de perfil impulsadas por la IA en tiempo real.
**Propiedades del bloque de flujo**
El bloque de flujo **Obtener recomendaciones de perfiles** tiene las siguientes propiedades para configurar:
1. **ID de perfil (obligatorio):**
Se requiere un ID de perfil para que este bloque funcione. El bloque de flujo **Obtener recomendaciones de perfil** genera recomendaciones para el ID de perfil que se proporciona aquí. Tiene la opción de introducir manualmente el ID de perfil o utilizar un valor predefinido almacenado en un atributo. Si utiliza un valor predefinido, asegúrese de proporcionar el ID de perfil mediante un bloque anterior de **Obtener perfil**. Utilice el bloque de **obtención de perfil** para identificar el perfil específico antes de continuar y generar recomendaciones en el bloque siguiente.
1. **Nombre del recomendante (obligatorio):**
Se necesita un nombre de recomendante para que este bloque funcione. Este es el nombre del recomendante que quieres usar para generar recomendaciones para el ID de perfil indicado. Solo puedes usar los recomendadores que estén activos para generar recomendaciones.
1. **Resultados máximos (obligatorio):**
El número máximo de recomendaciones que se generarán para el ID de perfil dado. Puede oscilar entre 1 y 3 recomendaciones.
1. **Atributos de la recomendación (obligatorios):**
Defina qué atributos de la respuesta a las recomendaciones permanecerán en el atributo de contacto.
1. **ID del artículo:**
Este es el identificador del artículo que se proporciona como contexto adicional para generar recomendaciones para el identificador de perfil indicado. El identificador de artículo solo es obligatorio cuando se utiliza un tipo de recomendación de «*artículos similares»* o «*artículos emparejados con frecuencia».* Tienes la opción de introducir manualmente el ID de perfil o usar un valor predefinido almacenado en un atributo. Si utiliza un valor predefinido, asegúrese de proporcionar el ID del elemento mediante un bloque anterior **para obtener atributos calculados**. Usa el bloque **Obtener atributos calculados** para identificar el ID de artículo específico antes de continuar y generar recomendaciones en el bloque siguiente.
**Ramas del bloque de flujo**
El bloque de flujo **Obtener recomendaciones de perfil** puede enrutar los contactos por las siguientes ramas:
1. **Éxito:**
Se generaron correctamente las recomendaciones para el ID de perfil proporcionado. Los atributos de recomendación seleccionados se conservaron en el atributo de contacto \$1.Customer.Recommendations.
1. **Error:**
Se ha producido un error al intentar generar recomendaciones. Esto puede deberse a un error del sistema o a la configuración del bloque **Obtener recomendaciones de perfil**.
1. **No se encontró ninguno:**
No se pudo generar ninguna recomendación.
**Uso de las recomendaciones del bloque**
La respuesta a las recomendaciones se conserva en el atributo de contacto \$1.Customer.Recommendations JSONPath como una lista JSON de objetos de recomendación. **Cada objeto de recomendación contendrá los atributos de recomendación seleccionados.**
El siguiente fragmento de código de Python de ejemplo de una función Lambda muestra cómo se puede utilizar para transformar las recomendaciones del bloque **Get profile recommendations** y conservarlas en otros atributos de contacto, de modo que las recomendaciones se puedan utilizar en los bloques siguientes.
```
import boto3
import json
# Handle lambda request
def lambda_handler(event, context):
print("Contact flow data: ", event)
# Transform recommendations
recommendations = event['Details']['Parameters']['Recommendations']
contact_attributes = {}
for i, rec in enumerate(recommendations):
contact_attributes.update(flatten(rec, i))
# Set contact attributes using each recommendation attribute value
print("Setting contact attributes: ", contact_attributes)
try:
client = boto3.client('connect', region_name="us-west-2")
client.update_contact_attributes(
InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1],
InitialContactId=event['Details']['ContactData']['InitialContactId'],
Attributes=contact_attributes
)
print("Contact attributes set successfully.")
except Exception as e:
print("Error setting contact attributes: ", e)
# Success response
return {
'statusCode': 200,
'body': json.dumps('Success')
}
# Flatten a nested object into a simple string:string object
def flatten(recommendation, index):
flat = {}
for key, value in recommendation.items():
if isinstance(value, dict):
flat.update(flatten(value, index))
else:
flat[f"Rec{index}_{key}"] = str(value)
return flat
```
Una vez que hayas configurado tu flujo con el bloque **Obtener recomendaciones de perfil**, puedes empezar a usarlo para generar recomendaciones para tus clientes durante sus contactos.
### Uso de las recomendaciones de perfiles de clientes en las campañas salientes
Puede integrar Predictive Insights con las campañas salientes de Amazon Connect para ofrecer recomendaciones personalizadas a través de los canales de correo electrónico y SMS. Al crear una campaña activada por eventos, puede configurar la sección de recomendaciones para que genere automáticamente recomendaciones basadas en la inteligencia artificial para los perfiles de clientes asociados a la campaña.
Esta integración utiliza el mapeo de objetos de Web Analytics como categoría de eventos para recopilar los datos de interacción con los clientes, lo que permite al motor de recomendaciones ofrecer sugerencias relevantes y específicas basadas en el comportamiento de los clientes.
Para step-by-step obtener instrucciones sobre cómo configurar las recomendaciones en las campañas activadas por eventos, consulte. [Creación de una campaña saliente con activadores de eventos](how-to-create-campaigns-using-event-triggers.md)
### Configuración de Connect AI Agents para recomendaciones de ventas
Amazon Q in Connect mejora las capacidades de los agentes mediante su nuevo tipo de agente «Orchestration». Esta funcionalidad es especialmente valiosa para crear un agente de ventas con inteligencia artificial que pueda ofrecer recomendaciones de artículos, lo que resulta especialmente útil en situaciones de ventas adicionales y cruzadas.
**Introducción**
Para comenzar la implementación, acceda a Amazon Connect Consola de administración de AWS y navegue hasta allí. Tras iniciar sesión en su instancia de Connect a través de la URL de acceso, busque Amazon Q en el menú de la izquierda y seleccione agentes de IA. Encontrarás un agente de IA preconfigurado del tipo Orchestration (SalesAgent) en estado de borrador en la página de QiC, en la sección Agentes de IA. Esta plantilla viene equipada con todas las configuraciones necesarias para las herramientas de 1P e incluye ejemplos de recomendaciones.
**Creación de su agente personalizado**
Para crear un agente de ventas personalizado, comience por crear un nuevo agente de IA del tipo orquestación y cópielo de la SalesAgent plantilla existente. Este proceso transfiere todas las herramientas y configuraciones de la plantilla a tu nuevo agente.
**Personalización del agente**
Cuando se trata de actualizar la solicitud del agente, los administradores tienen dos opciones principales. Pueden añadir su mensaje de agente actual al mensaje del agente de ventas y añadir instrucciones de identificación de ventas adicionales, o pueden empezar de cero eliminando el SalesAgent mensaje y creando un nuevo mensaje de organización basado en su agente publicado actualmente y añadiéndole el mensaje del agente de ventas. Esta flexibilidad permite crear soluciones personalizadas que se adapten a las necesidades empresariales específicas y a los requisitos del dominio.
**Configuración e integración de flujos**
Tras finalizar la configuración del agente y publicarla, el siguiente paso consiste en crear un bot de Amazon Lex en Flows. El flujo entrante debe actualizarse para incluir el GetCustomerInput bloque con el bot Lex creado, y el nuevo SalesAgent debe seleccionarse en opciones adicionales. Tendrá que añadir el bloque de flujo del perfil del cliente para recuperar el ID del perfil y el bloque de flujo Set-Contact Attributes, configurándolo como clave para el ID del perfil y el valor CustomerId como \$1Customer. ProfileId.
La implementación admite tanto contactos de chat como llamadas de voz, y las entradas del cliente se transmiten sin problemas al agente de QIC en el bot Lex. Esta configuración integral permite recomendaciones de ventas impulsadas por la IA y oportunidades de ventas adicionales dentro de su entorno Amazon Connect. La flexibilidad del sistema permite la personalización en función de las necesidades específicas del sector y, al mismo tiempo, mantiene la funcionalidad básica de la asistencia de ventas inteligente. Esta solución proporciona un marco para mejorar las interacciones con los clientes con recomendaciones basadas en la IA y, en última instancia, respaldar operaciones de ventas y servicio al cliente más eficaces. Los administradores pueden perfeccionar aún más la implementación añadiendo instrucciones específicas para cada dominio y personalizando los tipos de recomendaciones para que se ajusten a sus requisitos empresariales.
### Se configura SalesAgent para su uso con fines de asistencia a agentes
Puede configurarlo SalesAgent para que se utilice en el widget de chat Q in connect de Agent Workspace. Para hacerlo, debe modificar dos cosas principales.
1. Actualice el AIAgent mensaje con instrucciones para acceder a la transcripción del contacto.
1. Abre el mensaje asociado al SalesAgent editor de Prompt y actualízalo para añadir instrucciones para acceder a la transcripción del contacto, al que se puede acceder mediante ` {{$.transcript}} `
1. A continuación se muestra un ejemplo de mensaje que puede adjuntar al SalesAgent mensaje.
```
**IMPORTANT**
**Guide on how to process requests and information:**
- The messages section contains YOUR conversation with the customer service agent
- Respond to the agent's questions/requests in the messages section
- The transcript below is background information about the agent's conversation with their customer
- Do not respond directly to the customer - you are helping the AGENT
Background context from agent-customer conversation.
The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do.
IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..."
{{$.transcript}}
```
1. AIAgent Actualícelo con la nueva versión del indicador y actualice la configuración predeterminada → Asistencia con agentes en caso de uso con este agente.
**nota**
Se recomienda utilizar 2 casos de uso diferentes de Sales AIAGent for Self Service y Agent Assistance, ya que ambos requieren pequeñas modificaciones en el mensaje. Y esto se puede hacer clonando el agente y simplemente cambiando la versión del mensaje y actualizando la configuración predeterminada para que apunte a los agentes de IA correctos para cada caso de uso
1. Actualice el flujo entrante de contactos.
1. Elimine el GetCustomerInput bloque y añada el bloque de flujo Connect Assistant en su lugar
1. Complete la configuración del bloque de flujo con el AIAssistant ARN y seleccione el apropiado. AIAGent
Ahora puedes usar este flujo como entrada habitual y el widget de chat de Q in connect debería poder ofrecer recomendaciones para ayudar con las solicitudes del usuario.
## Consideraciones sobre los datos
Las siguientes secciones proporcionan orientación sobre cómo combinar los casos de uso y evaluar la preparación de los datos para Predictive Insights.
### ¿Ha adaptado sus casos de uso a Predictive Insights?
Los tipos de personalización de Predictive Insights pueden abordar los siguientes casos de uso:
+ Generar recomendaciones personalizadas para un usuario
+ Recomendar elementos similares o relacionados
+ Recomendar elementos populares o de moda
+ Reordenar los elementos por relevancia
### ¿Tiene suficientes datos de interacciones de elementos?
Para todos los casos de uso y tipos de personalización, debes tener al menos 1000 interacciones entre artículos para 25 usuarios únicos con al menos dos interacciones cada uno. Para obtener recomendaciones de calidad, le sugerimos que tenga al menos 50 000 interacciones de elementos de al menos 1000 usuarios, con dos o más interacciones de elementos cada uno.
### ¿Cuenta con una arquitectura de streaming de eventos en tiempo real?
Si tiene la capacidad de transmitir eventos en tiempo real a Connect Customer Profiles, podrá aprovechar la personalización en tiempo real. Con algunos tipos de personalización, Predictive Insights puede aprender de la actividad más reciente de sus usuarios y actualizar las recomendaciones a medida que utilizan su aplicación.
### ¿Están sus datos optimizados para Predictive Insights?
Le recomendamos que compruebe lo siguiente en sus datos:
+ Compruebe si faltan valores. Recomendamos que un mínimo del 70 % de sus registros contenga datos para cada atributo. Recomendamos que las columnas que permiten valores nulos estén completas al menos en un 70 %.
+ Corrija cualquier imprecisión o problema en sus datos, como convenciones de nomenclatura incoherentes, categorías duplicadas para un elemento, discrepancias IDs entre conjuntos de datos o duplicados. IDs Estos problemas pueden afectar negativamente a las recomendaciones o generar un comportamiento inesperado. Por ejemplo, es posible que tenga ambos caracteres «»N/A” and “Not Applicable” in your data, but filter out recommendations based on only “N/A. El filtro no tendría en cuenta los elementos marcados como “No aplicable”.
+ Si un elemento, usuario o acción puede tener varias categorías, como una película con varios géneros, combine los valores categóricos en un atributo y separe cada valor con el operador \$1. Por ejemplo, los datos de GÉNEROS de una película pueden ser Acción \$1 Aventura \$1 Thriller.
+ Evite tener más de 1000 categorías posibles para una columna (a menos que la columna contenga datos únicamente con fines de filtrado).
# Uso de las API de Perfiles de clientes de Amazon Connect
Para obtener información sobre cómo administrar dominios y perfiles mediante programación, consulte la [Referencia de la API de Perfiles de clientes de Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
La ListObjectTypeAttributeValues API proporciona acceso a los valores distintos más recientes de cualquier atributo especificado, lo que la hace valiosa para la validación de datos en tiempo real y las comprobaciones de coherencia de los tipos de objetos. Esta API funciona en todos los dominios y admite tipos de objetos estándar y personalizados. La API acepta el nombre del tipo de objeto, el nombre del atributo y el nombre de dominio como parámetros de entrada y devuelve valores con un límite de almacenamiento de aproximadamente 350 KB.
**Nota:**
+ Almacenamos hasta 350 KB de valores de atributo por campo y priorizamos primero los valores más recientes. Una vez alcanzado este límite, los valores más antiguos se eliminarán automáticamente para dejar espacio a las nuevas entradas.
## GetObjectTypeAttributeValues API
La GetObjectTypeAttributeValues API proporciona información estadística sobre los atributos de un tipo de objeto específico, pero está disponible exclusivamente para los dominios con el almacén de datos habilitado. Esta API realiza cálculos diarios para proporcionar información estadística sobre los valores de sus atributos, lo que le ayuda a comprender los patrones y las tendencias de sus datos. Los cálculos estadísticos se realizan una vez al día, lo que proporciona una instantánea coherente de las características de los datos de los atributos.
**Nota:**
+ Recibirás valores nulos en dos escenarios:
+ Durante el primer período después de habilitar el almacén de datos (a menos que se produzca un ciclo de cálculo, que ocurre una vez al día).
+ Para los atributos que no contienen valores numéricos.
Recomendamos utilizar la biblioteca de código abierto CustomerProfile JS al integrar los perfiles de clientes en su propia aplicación de agente. Para obtener más información, consulta el repositorio de CustomerProfiles JS en [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Para obtener más información sobre cómo integrar sus aplicaciones existentes con Amazon Connect utilice [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams). Puede incrustar los componentes del Panel de control de contacto (CCP) en su aplicación.
# Descripción del IPv6 soporte en los perfiles de clientes de Amazon Connect
## Conectividad pública
Todos los perfiles de clientes de Amazon Connect APIs ofrecen asistencia IPv4 y IPv6 llamadas completas.
```
profile.Region.api.aws
```
**Por ejemplo**:
```
profile.us-east-1.api.aws
```
Para la CLI de AWS, necesitará estos puntos de conexión de forma explícita:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Los antiguos todavía APIs están disponibles como compatibles con versiones anteriores. Solo admiten IPv4 llamadas.
```
profile.Region.amazonaws.com
```
**Por ejemplo**:
```
profile.us-east-1.amazonaws.com
```
## Conectividad privada
Puede crear un punto de conexión de VPC para el servicio Perfiles de clientes de Amazon Connect mediante la consola de Amazon VPC o la Interfaz de la línea de comandos de AWS (AWS CLI). Para obtener más información, consulte [Creación de un punto final de interfaz](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) en la PrivateLink Guía de AWS.
Cree un punto de conexión de VPC para Perfiles de clientes de Amazon Connect mediante el siguiente nombre de servicio:
```
com.amazonaws.Region.profile
```
**Por ejemplo**:
```
com.amazonaws.us-east-1.profile
```
Si habilita el DNS privado para el punto final, puede realizar solicitudes de API a los perfiles de los clientes de Amazon Connect utilizando su nombre de DNS IPv4 y el IPv6 compatible de la región, por ejemplo, profile.us-east-1.api.aws.
Como alternativa, también se admite como único nombre DNS antiguo de la región. IPv4
**Por ejemplo**:
```
profile.us-east-1.amazonaws.com
```
# Ejemplo: Integración de S3 en Perfiles de clientes de Amazon Connect mediante programación
Con la [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API de perfiles de clientes, puede crear integraciones para S3, Salesforce, Marketo y más mediante programación.
En este tema mostramos cómo crear una integración de S3 con un intervalo de sincronización de 15 minutos, el valor mínimo admitido actualmente.
## Paso 1: crear un archivo JSON
Cree un archivo JSON con el siguiente contenido:
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
Para personalizar el código JSON con sus propios valores, siga estas indicaciones:
+ `FlowName`: puede ser STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`: establézcalo a `DateTime` \$1 5 minutos en tiempo Unix.
+ `FirstExecutionFrom`: vaya a S3, consulte la fecha del archivo y utilice una fecha anterior a la más antigua.
+ `Tasks`: defina `TaskType`. En el campo `Sourcefields`, debe proporcionar TODAS las columnas que tiene en su CSV en esa matriz. A continuación, para cada uno de los elementos de esa matriz, debe especificar el `ConnectorOperator`. Este ejemplo corresponde a un documento CSV con dos columnas: `colA` y `colB`.
## Paso 2: Llama a la API PutIntegration
Una vez que haya creado y personalizado el archivo JSON con sus valores, llame a la [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, como se muestra en el siguiente ejemplo:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
La respuesta de `PutIntegration` devuelve un URI de flujo. Por ejemplo:
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## Paso 3: Llama a la AppFlow StartFlow API de Amazon
Usa el URI de flujo para llamar a la AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API de Amazon. Por ejemplo:
```
aws appflow start-flow —flow-name uri --region us-west-2
```