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 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
```