As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usar a API do Amazon Connect Customer Profiles
Para obter informações sobre como gerenciar programaticamente domínios e perfis, consulte a [Referência de API do Amazon Connect Customer Profiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).
## ListObjectTypeAttributeValues API
A ListObjectTypeAttributeValues API fornece acesso aos valores distintos mais recentes para qualquer atributo especificado, tornando-a valiosa para validação de dados em tempo real e verificações de consistência em seus tipos de objetos. Essa API funciona em vários domínios, oferecendo suporte a tipos de objetos personalizados e padrão. A API aceita o nome do tipo de objeto, o nome do atributo e o nome do domínio como parâmetros de entrada e retorna valores até o limite de armazenamento de aproximadamente 350 KB.
**Observação:**
+ Armazenamos até 350 KB de valores de atributos por campo, priorizando primeiro os valores mais recentes. Quando esse limite for atingido, os valores mais antigos serão removidos automaticamente para abrir espaço para novas entradas.
## GetObjectTypeAttributeValues API
A GetObjectTypeAttributeValues API fornece informações estatísticas sobre atributos dentro de um tipo de objeto específico, mas está disponível exclusivamente para domínios com armazenamento de dados ativado. Essa API realiza cálculos diários para fornecer informações estatísticas sobre seus valores de atributos, ajudando você a entender padrões e tendências em seus dados. Os cálculos estatísticos são realizados uma vez por dia, fornecendo uma visão geral consistente das características dos seus dados de atributos.
**Observação:**
+ Você receberá valores nulos em dois cenários:
+ Durante o primeiro período após a ativação do data vault (a menos que ocorra um ciclo de cálculo, que acontece uma vez por dia).
+ Para atributos que não contêm valores numéricos.
Recomendamos usar a biblioteca de código aberto CustomerProfile JS ao integrar perfis de clientes em seu próprio aplicativo de agente. Para obter mais informações, consulte o repositório CustomerProfiles JS no [Github](https://github.com/amazon-connect/amazon-connect-customer-profiles).
Para obter mais informações sobre como integrar as aplicações existentes com o Amazon Connect, use o [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams). Você pode incorporar os componentes do Painel de controle do contato (CCP) em seu aplicativo.
# Entendendo IPv6 o suporte nos perfis de clientes do Amazon Connect
## Conectividade pública
Todos os perfis de clientes do Amazon Connect oferecem suporte APIs total IPv4 e IPv6 ligações.
```
profile.Region.api.aws
```
**Por exemplo**:
```
profile.us-east-1.api.aws
```
Para a AWS CLI, você precisará usar esses endpoints explicitamente:
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
Os antigos ainda APIs estão disponíveis como compatibilidade com versões anteriores. Eles só suportam IPv4 chamadas.
```
profile.Region.amazonaws.com
```
**Por exemplo**:
```
profile.us-east-1.amazonaws.com
```
## Conectividade privada
É possível criar um endpoint da VPC para o Amazon Connect Customer Profiles usando o console do Amazon VPC ou a AWS Command Line Interface (AWS CLI). Para obter mais informações, consulte [Criação de um endpoint de interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) no PrivateLink Guia da AWS.
Crie um endpoint da VPC para o Amazon Connect Customer Profiles usando o seguinte nome de serviço:
```
com.amazonaws.Region.profile
```
**Por exemplo**:
```
com.amazonaws.us-east-1.profile
```
Se você habilitar o DNS privado para o endpoint, poderá fazer solicitações de API aos perfis de clientes do Amazon Connect usando seu nome DNS IPv4 e o nome DNS IPv6 suportado para a região, por exemplo, profile.us-east-1.api.aws.
Como alternativa, o nome DNS antigo da região também é suportado IPv4 apenas como.
**Por exemplo**:
```
profile.us-east-1.amazonaws.com
```
# Exemplo: Integrar programaticamente o S3 ao Amazon Connect Customer Profiles
Usando a [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API Customer Profiles, você pode criar programaticamente integrações para S3, Salesforce, Marketo e muito mais.
Neste tópico, mostramos como criar uma integração do S3 com um intervalo de sincronização de 15 minutos, o valor mínimo atualmente compatível.
## Etapa 1: Criar um arquivo JSON
Crie um arquivo JSON com o seguinte conteúdo:
```
{
"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 o JSON com seus próprios valores, siga estas diretrizes:
+ `FlowName`: pode ser STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`: defina como `DateTime` atual \$1 5 minutos no horário da época.
+ `FirstExecutionFrom`: vá para o S3, veja a data do arquivo e use uma data anterior à data mais antiga.
+ `Tasks`: defina `TaskType`. No campo `Sourcefields`, você deve fornecer TODAS as colunas que tem em seu CSV nessa matriz. Em seguida, para cada um dos itens dessa matriz, você precisa especificar `ConnectorOperator`. Este exemplo é para um documento CSV com duas colunas: `colA` e `colB`.
## Etapa 2: chame a PutIntegration API
Depois de criar e personalizar o arquivo JSON com seus valores, chame a [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html)API, conforme mostrado no exemplo a seguir:
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
A resposta de `PutIntegration` retorna um URI de fluxo. Por exemplo:
```
{
"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": {}
}
```
## Etapa 3: chame a AppFlow StartFlow API da Amazon
Use o URI de fluxo para chamar a AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html)API da Amazon. Por exemplo:
```
aws appflow start-flow —flow-name uri --region us-west-2
```