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á.

# Configurar atributos calculados no Amazon Connect Customer Profiles
<a name="customerprofiles-calculated-attributes"></a>

*Atributos calculados* são valores derivados de outros atributos usando fórmulas. Você pode usá-los para identificar os comportamentos agregados dos usuários.

É possível criar atributos calculados para definir sua própria lógica de negócios a fim de transformar os dados do perfil do cliente em pontos de dados acionáveis. Isso permite que você personalize experiências automatizadas, como respostas de voz interativas.

Ao usar atributos calculados, é possível identificar os principais atributos sobre o comportamento passado do cliente. Por exemplo: 
+ O último site visitado ou o último atendente com quem conversou.
+ Padrões de comportamento, como canal preferido e frequência de contato.
+ Valor do cliente, como novo cliente e tamanho médio do tíquete.

Você pode usar a API de atributos calculados para criar um atributo usando operações de agregação comuns, como média, contagem, mínimo, máximo e soma.

Os atributos calculados transformam dados brutos em métricas e pontos de dados acionáveis de forma automática e em tempo real. Os administradores da central de atendimento podem definir e configurar cálculos com base nos dados brutos disponíveis nos perfis dos clientes. Esses atributos calculados facilitam a criação de experiências automatizadas, como Interactive Voice Response (IVR – Resposta de Voz Interativa) ou chatbots. Você pode criar experiências personalizadas e ajudar os atendentes a entender o contexto do cliente com mais rapidez.

Para obter uma lista das AWS regiões em que os atributos calculados APIs estão disponíveis, consulte[Customer Profiles atributos calculados disponibilidade da API por região](regions.md#customerprofiles_calculatedattributesregion). 

**Topics**
+ [Conceitos básicos dos atributos calculados](customerprofiles-calculated-attributes-admin-website.md)
+ [Atributos calculados APIs](customerprofiles-calculated-attributes-apis.md)
+ [Criar uma definição personalizada de atributo calculado](customerprofiles-calculated-attributes-creating-definition.md)
+ [Validar valores de atributos calculados](customerprofiles-calculated-attributes-validating-values.md)
+ [Atributos calculados padrão](customerprofiles-default-calculated-attributes.md)
+ [Mensagens de erro e resoluções](customerprofiles-calculated-attributes-troubleshooting.md)

# Introdução aos atributos calculados nos Perfis de Amazon Connect clientes
<a name="customerprofiles-calculated-attributes-admin-website"></a>

Use os atributos calculados para definir sua própria lógica de negócios a fim de transformar os dados do perfil do cliente em pontos de dados acionáveis para personalizar experiências automatizadas, como respostas de voz interativas.

Ao usar atributos calculados, é possível identificar os principais atributos sobre o comportamento passado, os padrões de comportamento e o valor do cliente.

Os tópicos desta seção mostram como criar, visualizar, editar e excluir Atributos calculados.

**Topics**
+ [Criar atributos calculados](calculated-attributes-admin-website-create.md)
+ [Configurar filtros de eventos](calculated-attributes-admin-website-event-filters.md)
+ [Visualizar atributos calculados](calculated-attributes-admin-website-view.md)
+ [Editar atributos calculados](calculated-attributes-admin-website-edit.md)
+ [Excluir atributos calculados](calculated-attributes-admin-website-delete.md)

# Criar atributos calculados no Amazon Connect
<a name="calculated-attributes-admin-website-create"></a>

1. Pré-requisitos: verifique se você tem as permissões de perfil de segurança necessárias. Para obter mais informações, consulte [Atualizar permissões para atributos calculados no Amazon Connect Customer Profiles](security-profile-customer-profile-calc-attribs.md).

1. No site do Amazon Connect administrador, navegue até **Perfis de clientes**, **Atributos calculados** e escolha **Criar atributo** na exibição da tabela de **atributos calculados**.  
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)

1. Para criar um atributo calculado, atribua um nome descritivo, adicione uma descrição (opcional) com detalhes sobre o atributo e configure os campos obrigatórios:
   + **Cálculo:** define como os atributos são computados (average/count/sum/minimum/first occurrence/last occurrence/maxocorrência).
   + **Atributo:** um ponto de dados dos dados dos perfis de cliente.
**nota**  
Se você estiver selecionando um atributo de um tipo de objeto padrão (`_asset``_case`,,`_order`), os atributos devem estar dentro PascalCase. Isso significa que a primeira letra de cada palavra no nome do atributo está em letra maiúscula, como `_case.CreatedBy` ou `_order.TotalPrice`.  
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)

1. Além disso, você pode adicionar outro atributo selecionando o ícone de *adição*. Você pode escolher até dois atributos para o cálculo e combiná-los por um operador. Especifique um operador, como *adição* ou *subtração*, para combinar os valores de atributo.  
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)

1. Depois que o cálculo for selecionado, você terá a opção de configurar o Número de eventos, o Período e o Carimbo de data/hora da origem. Por padrão, os atributos calculados são configurados para usar eventos ilimitados, um período ilimitado e um carimbo de data/hora com base na data de ingestão.

   Uma saída é retornada quando há pelo menos um evento durante o período especificado.
   + **Número de eventos:** configure um limite ou use de forma ilimitada (padrão).
   + **Período:** defina um prazo específico ou use de forma ilimitada (padrão).
   + **Carimbo de data/hora da origem:** escolha entre um campo específico de carimbo de data/hora ou data de ingestão (padrão).
**nota**  
Embora não haja limite de eventos, existe um limite de tamanho de dados em que os dados mais antigos serão substituídos por dados mais novos. O carimbo de data/hora da origem não poderá ser alterado após a criação.  
![\[A guia Perfis de clientes no espaço de trabalho de atendente e o botão Associar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)

1. Também é possível definir critérios para incluir somente eventos relevantes nos cálculos. Consulte [Configurar filtros de eventos](calculated-attributes-admin-website-event-filters.md) para obter mais informações.

1. Selecione **Criar** para criar o atributo calculado.

1. Após a criação bem-sucedida de um atributo calculado, um banner é exibido na visualização de tabela para usar o atributo calculado em um segmento ou fluxo. Você também poderá ver o status dos atributos calculados com base na prontidão.  
![\[Um banner informando que o atributo calculado foi criado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)

# Configurar filtros de eventos
<a name="calculated-attributes-admin-website-event-filters"></a>

Os filtros de eventos permitem filtrar os objetos de perfil a serem usados no atributo calculado. Por exemplo, um filtro de eventos pode filtrar os objetos de ativos padrão do cliente para que somente os ativos com **Status Instalado OU Registrado** sejam incluídos no cálculo.

**nota**  
Não é possível editar filtros de eventos depois de criar uma definição de atributo calculado.

Ao criar um atributo calculado, você pode criar um ou mais filtros de eventos. Um filtro de eventos consiste nos seguintes componentes:

![\[Componentes do filtro de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)

+  **Grupos de filtros**: grupo de filtros que você aplica aos objetos de perfil. É possível adicionar vários grupos de filtros conectados por relações OR. 
+  **Filtros**: filtra os objetos de perfil incluídos no cálculo do atributo calculado ao especificar atributos, operadores e valores. Você pode escolher tantos filtros quantos forem necessários para o seu caso de uso. 
+  **Atributo**: o atributo do objeto pelo qual deseja filtrar. Você pode selecionar atributos de objetos armazenados no domínio do Customer Profiles ou usar os nomes de campo definidos na definição do tipo de objeto. Para obter mais informações sobre mapeamentos de tipos de objeto, consulte [Detalhes da definição de mapeamento de tipo de objeto no Amazon Connect Customer Profiles](object-type-mapping-definition-details.md).
**nota**  
 No site do Amazon Connect administrador, a lista suspensa de atributos mostra a data e hora da última vez em que qualquer objeto de perfil foi salvo ou atualizado com o atributo. 
 Se houver um atributo de um objeto de perfil e um campo de um tipo de objeto com o mesmo nome, o filtro de eventos priorizará o nome do campo de tipo de objeto em sua filtragem. Por exemplo, se um objeto de perfil tiver um atributo chamado **Status** e também houver um campo de tipo de objeto chamado **Status**, o filtro usará o campo de tipo de objeto **Status** para filtragem. 
+  **Operador**: o operador determina a relação do atributo com um valor que você insere. Para obter mais informações, consulte [Operadores de filtro](#calculated-attributes-admin-website-event-filter-operators)
+  **Valor**: o valor com o qual deseja filtrar objetos. É possível especificar vários valores conectados por relações OR. Por exemplo, *O status do ativo é Instalado ou Registrado*. Observe que os valores diferenciam letras maiúsculas de minúsculas. Por exemplo, *O status do ativo é Instalado* retorna resultados diferentes de *O status do ativo é instalado*. Para visualizar objetos de perfil, use a [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API Amazon Connect Customer Profiles.

 Opcionalmente, você pode criar até dois filtros de eventos e criar uma relação (AND/OR/EXCLUDE) entre eles. Para obter mais detalhes sobre o relacionamento, consulte[Relação entre filtros de eventos](#calculated-attributes-admin-website-relationship-between-event-filters). 

 

## Operadores de filtro
<a name="calculated-attributes-admin-website-event-filter-operators"></a>

Os operadores determinam a relação do atributo com um valor inserido por você. A tabela a seguir descreve os operadores disponíveis.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)

**nota**  
 Os atributos calculados no site do Amazon Connect administrador usam o fuso horário UTC e um horário padrão de 00:00:00 UTC para todos os filtros baseados em horário. Você pode filtrar por datas, mas as horas são registradas com o mesmo valor. Se você inserir uma data de 1/1/2024, o console enviará a hora como 2024-01-01T00:00:00Z. 

**nota**  
Por padrão, os filtros de eventos são avaliados quando um objeto de perfil é salvo ou atualizado. Por exemplo, se você filtrar objetos de ativo padrão em que `PurchaseDate` está na última semana, o tempo relativo é calculado como *na semana anterior ao momento em que o objeto de ativo é salvo ou atualizado*. Isso significa que os resultados da filtragem podem variar dependendo de quando o objeto é salvo ou atualizado.

## Relação entre filtros de eventos
<a name="calculated-attributes-admin-website-relationship-between-event-filters"></a>

 Você também pode adicionar o segundo filtro de eventos e definir uma relação com o primeiro filtro de eventos. Ao criar um atributo calculado no site de administração do Amazon Connect , você pode ter até dois filtros de eventos por atributo calculado. Se você adicionar o segundo filtro de eventos ao atributo calculado, poderá escolher uma das duas formas de especificar como os dois filtros de eventos se conectam: 
+  **Relação AND**: se você usar a relação AND para conectar os dois filtros de eventos, objetos que atendam ao primeiro e ao segundo filtro de eventos serão incluídos no cálculo. 
+  **Relação OR**: se você usar a relação OR para conectar os dois filtros de eventos, objetos que atendam ao primeiro ou ao segundo filtro de eventos serão incluídos no cálculo. 
+  **Relação EXCLUDE**: se você usar a relação EXCLUDE para conectar dois filtros de eventos, objetos que atendam ao primeiro filtro de eventos, mas não atendam ao segundo filtro de eventos, serão incluídos no cálculo. 

## Próximas etapas
<a name="calculated-attributes-admin-website-event-filter-next-steps"></a>
+  [Usar um atributo calculado em sua central de atendimento por meio do editor de fluxo](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes) 
+  [Usar um atributo calculado para definir um segmento de clientes](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+  [Exibir atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html) 
+  [Editar atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html) 
+  [Excluir atributos calculados no Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html) 

# Visualizar atributos calculados no Amazon Connect
<a name="calculated-attributes-admin-website-view"></a>

1. Faça login no site do Amazon Connect administrador em https://*instance name*.my.connect.aws/. Use uma conta de Administrador ou uma conta atribuída a um perfil de segurança que tenha permissão para **Customer Profiles - Atributos calculados**. 

1. No Amazon Connect, no painel de navegação esquerdo, escolha **Customer Profiles** e **Atributos calculados**.

1. Na página **Atributos calculados**, escolha um atributo calculado na coluna **Nome** da tabela. 

   A imagem a seguir mostra um exemplo de atributos calculados listados na coluna **Nome**.  
![\[Uma tabela que lista atributos calculados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)

1. Agora você pode visualizar os detalhes do atributo selecionado. A imagem a seguir mostra uma página de detalhes de um atributo calculado.  
![\[Visualização detalhada de um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)

# Editar atributos calculados no Amazon Connect
<a name="calculated-attributes-admin-website-edit"></a>

1. Para editar um atributo calculado, escolha um atributo na exibição de tabela selecionando o botão de opção, que habilita o botão **Editar**. Escolha **Editar**.  
![\[editar um atributo calculado\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)

1. Você poderá editar a **Descrição**, o **Número de eventos** e **Período**. Ao concluir, selecione **Salvar**.  
![\[Edite um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)

# Excluir atributos calculados no Amazon Connect
<a name="calculated-attributes-admin-website-delete"></a>

1. Para excluir um atributo calculado, escolha um atributo na tabela selecionando o botão de opção ao lado do atributo que você gostaria de excluir.

1. Depois de selecionado, escolha **Excluir**.

1. No menu pop-up **Excluir atributo**, verifique os detalhes e insira *confirmar* para habilitar o botão **Excluir**.  
![\[Exclua um atributo calculado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)

1. Escolha **Excluir**.

# Atributos calculados dos perfis de clientes do Amazon Connect APIs
<a name="customerprofiles-calculated-attributes-apis"></a>

Você pode usar o seguinte atributo calculado de Perfis de Cliente APIs

------
#### [ CreateCalculatedAttributeDefinition ]

**CreateCalculatedAttributeDefinition**

Crie um novo atributo calculado. Isso requer um tipo de objeto existente no domínio. Você pode definir os atributos que deseja extrair de um único objeto de origem e as operações matemáticas a serem aplicadas a eles de forma agregada, bem como o intervalo de tempo e a contagem de objetos.

Após a criação, novos dados de objetos ingeridos no Customer Profiles serão incluídos no atributo calculado, que pode ser recuperado para um perfil usando a API `GetCalculatedAttributeForProfile`. Para usar também dados históricos, especifique `UseHistoricalData` como true. Os campos `Readiness` e `Status` na resposta da API fornecerão informações sobre o status da inclusão de dados históricos no atributo calculado. 

A definição de um atributo calculado o disponibiliza para todos os perfis em um domínio. Cada atributo calculado só pode referenciar um ObjectType e no máximo dois campos a partir desse campo ObjectType.

**Solicitação**

```
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": {}
}
```

**Resposta**

```
{
    "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": {}
}
```

**Corpo da solicitação**
+ **CalculatedAttributeName**

  O nome exclusivo (por domínio) do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **DisplayName**

  O nome de exibição do atributo calculado.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
  + Obrigatório: não
+ **Descrição**

  A descrição do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.000.
  + Obrigatório: não
+ **UseHistoricalData**

  Indica se os dados históricos ingeridos antes da criação do atributo calculado devem ser incluídos nos cálculos.
  + Tipo: booleano
  + Obrigatório: não
+ **AttributeDetails**

  Detalhes dos atributos usados na definição e das operações matemáticas envolvidas entre os atributos. Consulte os seguintes componentes:
  + **Atributos.**

    Uma lista de itens de atributos especificados na expressão matemática.
    + **AttributeItem**

      Os detalhes de um item de atributo especificado na expressão matemática.
      + Nome
        + O nome de um atributo definido em um tipo de objeto de perfil.
        + Tipo: string
  + **Expressão**

    Expressão matemática executada em itens de atributos fornecidos na lista de atributos. Cada elemento na expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. AttributeName\$1\$1”.
    + Exemplo: `{ObjA.AttributeA} - {ObjA.AttributeB}`
    + Tipo: String
    + Só oferecemos suporte às seguintes operações matemáticas: `+ - * /`
    + Você não poderá fazer modificações na expressão depois que uma definição de atributo calculado for criada
+ **Condições**

  Define os critérios e o limite calculados da agregação de atributos.
  + Tipo: objeto Conditions
    + Intervalo
    + ObjectCount
    + Limite
+ **Intervalo**

  O período de tempo relativo durante o qual os dados são incluídos na agregação.
  + Tipo: objeto Range
    + Valor: o período das unidades especificadas. `ValueRange` substitui Value.
      + Tipo: inteiro
      + Obrigatório: não
    + ValueRange: uma estrutura que permite que os clientes especifiquem uma janela de tempo relativa durante a qual os dados são incluídos no Atributo Calculado. Use números positivos para indicar que o endpoint está no passado e números negativos para indicar que está no futuro. ValueRangesubstitui o valor.
      + Tipo: ValueRange
      + Obrigatório: não
        + Início
          + A hora de início da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
          + Tipo: inteiro
          + Obrigatório: Sim 
        + Fim
          + A hora de término da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
          + Tipo: inteiro
          + Obrigatório: Sim 
    + TimestampSource: uma expressão que especifica o campo em seu objeto JSON a partir do qual a data deve ser analisada. A expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. <Location of timestamp field in JSON pointer format>\$1\$1”. Por exemplo, se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "1737587945945"}}`, então TimestampSource deveria ser`"{MyType.generatedAt.timestamp}"`.
      + Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.
      + Obrigatório: não
    + TimestampFormat: o formato do campo de carimbo de data/hora em seu objeto JSON é especificado. Esse valor deve ser EPOCHMILLI (para timestamps de época Unix com precisão de nível) ou ISO\$18601 (seguindo o formato ISO\$18601 com precisão de second/millisecond nível, com um deslocamento opcional de Z ou no formato HH:MM ou second/millisecond HHMM.). Por exemplo, se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},`, então TimestampFormat deveria ser`"ISO_8601"`.
    + Unidade: unidade de tempo
      + Valores válidos: dias
      + Obrigatório: Sim
  + Obrigatório: Sim
  + Escopo inicial: máximo de 366 dias
+ **ObjectCount**

  O número de objetos de perfil usados para o atributo calculado.
  + Tipo: número
  + Alcance: de 1 a 100
  + Obrigatório: não
+ **Limite**

  A lógica de comparação para gerar um atributo true/false calculado.
  + Tipo: objeto Threshold
    + Valor
      + O valor do limite.
      + Tipo: string
      + Obrigatório: não
    + Operador
      + O operador do limite
      + Tipo: ENUM
      + Valores válidos:
        + GREATER\$1THAN
        + LESS\$1THAN
        + EQUAL\$1TO
        + NOT\$1EQUAL\$1TO
  + Obrigatório: não
+ **Estatística**

  A operação de agregação a ser executada para o atributo calculado.
  + Tipo: ENUM
  + Valores válidos:
    + FIRST\$1OCCURRENCE
    + LAST\$1OCCURRENCE
    + CONTAGEM
    + SUM
    + MINIMUM
    + MAXIMUM
    + AVERAGE
    + MAX\$1OCCURRENCE

------
#### [ UpdateCalculatedAttributeDefinition ]

**UpdateCalculatedAttributeDefinition**

Atualizar uma definição de atributo calculado. As atualizações estão limitadas ao nome de exibição, descrição, intervalo de tempo, contagem de objetos e limite. Essa API oferece suporte a atualizações parciais, portanto, somente os parâmetros que exigem atualização precisam ser incluídos.

**nota**  
Ao atualizar as condições:  
Aumentar o intervalo de datas de um atributo calculado não acionará a inclusão de dados históricos maiores que o intervalo de datas atual.
TimestampSource e TimestampFormat não pode ser atualizado após a criação de uma definição de atributo calculado.

**Solicitação**

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

**Resposta**

```
{
    "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": {}
}
```

**Corpo da solicitação**
+ **DisplayName**

  O nome de exibição do atributo calculado.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
  + Obrigatório: não
+ **Descrição**

  A descrição do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.000.
  + Obrigatório: não
+ **Condições**

  Define os critérios e o limite calculados da agregação de atributos.
  + Tipo: objeto Conditions
    + Intervalo
    + ObjectCount
    + Limite
+ **Intervalo**

  O período de tempo relativo durante o qual os dados são incluídos na agregação.
  + Tipo: objeto Range
    + Valor: o período das unidades especificadas
      + Tipo: inteiro
      + Obrigatório: não
    + ValueRange: uma estrutura que permite que os clientes especifiquem uma janela de tempo relativa durante a qual os dados são incluídos no Atributo Calculado. Use números positivos para indicar que o endpoint está no passado e números negativos para indicar que está no futuro. ValueRangesubstitui o valor.
      + Tipo: ValueRange
      + Obrigatório: não
        + Início
          + A hora de início da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
          + Tipo: inteiro
          + Obrigatório: Sim 
        + Fim
          + A hora de término da inclusão de objetos. Use números positivos para indicar que o ponto de partida está no passado e números negativos para indicar que está no futuro.
          + Tipo: inteiro
          + Obrigatório: Sim 
    + Unidade: unidade de tempo
      + Valores válidos: dias
      + Obrigatório: Sim
  + Obrigatório: Sim
  + Escopo inicial: máximo de 366 dias
+ **ObjectCount**

  O número de objetos de perfil usados para o atributo calculado.
  + Tipo: número
  + Alcance: de 1 a 100
  + Obrigatório: não
+ **Limite**

  A lógica de comparação para gerar um atributo true/false calculado.
  + Tipo: objeto Threshold
    + Valor
      + O valor do limite.
      + Tipo: string
      + Obrigatório: não
    + Operador
      + O operador do limite
      + Tipo: ENUM
      + Valores válidos:
        + GREATER\$1THAN
        + LESS\$1THAN
        + EQUAL\$1TO
        + NOT\$1EQUAL\$1TO
  + Obrigatório: não

------
#### [ GetCalculatedAttributeDefinition ]

**GetCalculatedAttributeDefinition**

Recupere uma definição de atributo calculado.

**Solicitação**

```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```

**Corpo da solicitação**

```
The request does not have a request body.
```

**Resposta**

```
{
"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 solicitação de URI**
+ **DomainName**

  O nome exclusivo do domínio.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **CalculatedAttributeName**

  O nome exclusivo (por domínio) do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim

------
#### [ DeleteCalculatedAttributeDefinition ]

**DeleteCalculatedAttributeDefinition**

Exclua uma definição de atributo calculado existente. Observe que é possível excluir um atributo calculado padrão. No entanto, uma vez excluído, você não poderá desfazer essa ação e precisará recriá-la sozinho usando a API `CreateCalculatedAttributeDefinition` se quiser recuperá-la.

**Solicitação**

```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```

**Corpo da solicitação**

```
The request does not have a request body.
```

**Resposta**

```
The response does not have a response body.
```

**Parâmetros de solicitação de URI**
+ **DomainName**

  O nome exclusivo do domínio.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **CalculatedAttributeName**

  O nome exclusivo (por domínio) do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim

------
#### [ ListCalculatedAttributeDefinitions ]

**ListCalculatedAttributeDefinitions**

Recupere todas as definições de atributos calculados para um domínio.

**Solicitação**

```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```

**Corpo da solicitação**

```
The request does not have a request body.
```

**Resposta**

```
{ 
    "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 solicitação de URI**
+ **DomainName**

  O nome exclusivo do domínio.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **MaxResults**

  O número máximo de objetos retornados por página.
  + Faixa válida: valor mínimo de 1. Valor máximo de 100
+ **NextToken**

  O token de paginação da chamada de ListCalculatedAttributeDefinition API anterior.
  + Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.024

------
#### [ GetCalculatedAttributeForProfile ]

**GetCalculatedAttributeForProfile**

Inicia o cálculo e recupera o resultado de um único atributo calculado para um único perfil.

**Solicitação**

```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```

**Corpo da solicitação**

```
The request does not have a request body.
```

**Resposta**

```
{
"Name": "string",
    "DisplayName": "string",
    "Value": "string",
    "IsDataPartial": "string",
    "LastObjectTimestamp" : number
}
```

**Parâmetros de solicitação de URI**
+ **DomainName**

  O nome exclusivo do domínio.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **CalculatedAttributeName**

  O nome exclusivo (por domínio) do atributo calculado.
  + Tipo: String
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim

------
#### [ ListCalculatedAttributesForProfile ]

**ListCalculatedAttributesForProfile**

Inicia o cálculo e recupera os resultados de um único atributo calculado para um único perfil.

**Solicitação**

```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```

**Corpo da solicitação**

```
The request does not have a request body.
```

**Resposta**

```
{
"Items": [
        {
"CalculatedAttributeName": "string",
            "DisplayName": "string",
            "Value": "string",
            "IsDataPartial" : "string",
            "LastObjectTimestamp" : number
        },
        ...
    ],
    "NextToken": "string"
}
```

**Parâmetros de solicitação de URI**
+ **DomainName**

  O nome exclusivo do domínio.
  + Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.
  + Padrão: `^[a-zA-Z0-9_-]+$`
  + Obrigatório: Sim
+ **ProfileId**
  + Padrão: `[a-f0-9]{32}`
  + Obrigatório: Sim
+ **MaxResults**

  O número máximo de objetos retornados por página.
  + Faixa válida: valor mínimo de 1. Valor máximo de 100
+ **NextToken**

  O token de paginação da chamada de ListCalculatedAttributeDefinition API anterior.
  + Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.024

------

# Criar uma definição personalizada de atributo calculado do Amazon Connect Customer Profiles
<a name="customerprofiles-calculated-attributes-creating-definition"></a>

Usando a [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API Customer Profiles, você pode criar programaticamente seu próprio atributo calculado com base em um tipo de objeto personalizado.

Neste tópico, mostramos como criar um atributo calculado usando um arquivo JSON personalizado.

## Etapa 1: Criar um arquivo JSON
<a name="step1-calculate-attribute-api"></a>

Crie um arquivo JSON com o seguinte conteúdo:

```
{
"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 o JSON com seus próprios valores, siga estas diretrizes:
+ **Atributos**: deve conter o nome do campo do seu tipo de objeto que você deseja usar para o atributo calculado. Há suporte para dois atributos referenciados nesta lista.
+ **Expressão**: expressões matemáticas básicas para execução entre atributos são compatíveis. Se você tiver apenas um atributo, esse campo deverá ser `{ObjectTypeName.AttributeName}`; caso contrário, se você tiver uma expressão matemática em mente, esse campo deverá conter os dois atributos.
+ **Estatística**: Essa é a operação executada quando você chama um dos cálculos APIs que realmente executa a operação de agregação. A maioria é autoexplicativa, mas adicionamos explicações para outras que não são. 

  **Estatísticas compatíveis**
  + `FIRST_OCCURRENCE` retorna o atributo especificado na expressão do primeiro objeto ingerido.
  + `LAST_OCCURRENCE` retorna o atributo especificado na expressão do último objeto ingerido.
  + `COUNT` retorna a contagem dos dados selecionados.
  + `SUM` retorna a soma dos dados selecionados.
  + `MINIMUM` retorna o mínimo dos dados selecionados.
  + `MAXIMUM` retorna o máximo dos dados selecionados.
  + `AVERAGE` retorna a média dos dados selecionados.
  + `MAX_OCCURRENCE` retorna o valor mais frequente especificado na expressão.
+ **Alcance**:
  + Units: no momento, só é compatível com DAYS.
  + ValueRange: especifique números positivos nos campos Início ou Fim para indicar de quantos dias começar e números negativos para indicar de quantos dias no futuro começar. ValueRange
  + TimestampSource: uma expressão que especifica o campo em seu objeto JSON a partir do qual a data deve ser analisada. A expressão deve seguir a estrutura de\$1 "\$1ObjectTypeName. <Location of timestamp field in JSON pointer format>\$1\$1”. Por exemplo; se seu tipo de objeto é MyType e o JSON de origem é`{"generatedAt": {"timestamp": "1737587945945"}}`, então TimestampSource deveria ser`"{MyType.generatedAt.timestamp}"`.
+ **ObjectCount**: indica em quantos objetos o cálculo do atributo calculado deve se basear.
+ **Threshold**: se, em vez do valor exato do atributo calculado, você quiser saber se ele é, por exemplo, maior que um determinado valor, você poderá usar um limite.

  O valor limite pode ser qualquer string, e os seguintes operadores de limite são compatíveis.
  + `GREATER_THAN`
  + `LESS_THAN`
  + `EQUAL_TO`
  + `NOT_EQUAL_TO`
+ UseHistoricalData: se os dados históricos ingeridos antes da criação do Atributo Calculado devem ser incluídos nos cálculos.

## Etapa 2: chame a CreateCalculatedAttributeDefinition API
<a name="step2-calculated-attribute-api"></a>

Depois de criar e personalizar o arquivo JSON com seus valores, chame a [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html)API, conforme mostrado no exemplo a seguir:

```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```

Você também pode usar o seguinte endpoint:

```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```

# Valide valores de atributos calculados nos perfis de clientes do Amazon Connect usando APIs
<a name="customerprofiles-calculated-attributes-validating-values"></a>

Existem dois APIs, `GetCalculatedAttributeForProfile` e`ListCalculatedAttributesForProfile`, que estão no nível do perfil.
+ **GetCalculatedAttributeForProfile**- recupera um único atributo calculado para um único perfil.
+ **ListCalculatedAttributesForProfile**- recupera uma lista de atributos calculados para um único perfil

Com um ID de perfil válido, você deve ver valores para seus atributos calculados:

**Exemplo de resposta**

```
{   
    "CalculatedAttributeName": "_average_hold_time",
    "DisplayName": "Average hold time",
    "IsDataPartial": "true",
    "Value": "24144"
}
```

**IsDataPartial**- Esse sinalizador significa que o intervalo de tempo (30 dias) ou a contagem de objetos não foram atingidos e, portanto, o atributo calculado ainda está sendo calculado. Por exemplo, se você quiser uma média de mais de 30 dias, somente depois de decorridos 30 dias o campo `IsDataPartial` será definido como falso.

## Recuperar uma lista de atributos calculados
<a name="calculated-attributes-validating-a-list-of-values"></a>

**Use a AWS CLI**

```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```

**Use a AWS CLI com um arquivo JSON personalizado**

Crie um arquivo JSON com o seguinte conteúdo:

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

**Endpoint:**

```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```

## Recuperar um único atributo calculado
<a name="calculated-attributes-validating-a-single-value"></a>

**Use a 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
```

**Use a AWS CLI com um arquivo JSON personalizado:**

Crie um arquivo JSON com o seguinte conteúdo:

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

**Endpoint:**

```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```

# Atributos calculados padrão no Amazon Connect Customer Profiles
<a name="customerprofiles-default-calculated-attributes"></a>

## Atributos calculados de CTR padrão
<a name="customerprofiles-default-calculated-attributes-ctr"></a>

Amazon Connect Os perfis de clientes fornecem atributos padrão de out-of-the caixa com base nos registros de contato. Os atributos são os seguintes:

**Canal mais frequente**

```
{
   "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": {
   }
}
```

**Canal mais recente**

```
{
   "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 do último atendente**

```
{
   "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": {
   }
}
```

**Chamador frequente**

```
{
   "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": {
   }
}
```

**Tempo médio 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": {
   }
}
```

**Duração média da chamada**

```
{
   "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": {
   }
}
```

**Tempo máximo de espera do 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 de perfil padrão
<a name="customerprofiles-default-calculated-attributes-profile"></a>

Amazon Connect Perfis de clientes fornecem um atributo padrão de out-of-the caixa com base em um perfil. Os atributos são os seguintes:

**Novo cliente**

```
{
   "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 de ativos padrão
<a name="customerprofiles-default-calculated-attributes-asset"></a>

Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos ativos. Os atributos são os seguintes:

**Contagem de ativos**

```
{
    "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
  }
```

**Data da primeira compra de ativo**

```
{
    "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
  }
```

**Data da última compra de ativo**

```
{
    "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
  }
```

**Preço total dos ativos**

```
{
    "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
  }
```

**Preço médio dos ativos**

```
{
    "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
  }
```

**Nome do primeiro ativo**

```
{
    "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
  }
```

**Nome do último ativo**

```
{
    "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 de chamados padrão
<a name="customerprofiles-default-calculated-attributes-case"></a>

Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos casos. Os atributos são os seguintes:

**Contagem de chamados**

```
{
    "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
  }
```

**Data de criação do primeiro chamado**

```
{
    "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
  }
```

**Data de criação do último chamado**

```
{
    "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
  }
```

**Contagem de chamados abertos**

```
{
    "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
  }
```

**Contagem de chamados encerrados**

```
{
    "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 de registros de comunicação padrão
<a name="customerprofiles-default-calculated-attributes-communication-record"></a>

Amazon Connect Os perfis de clientes fornecem atributos padrão de out-of-the caixa com base nos registros de comunicação. Os atributos são os seguintes:

**Data de abertura do último e-mail**

```
{
    "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
  }
```

**Contagem de e-mails abertos**

```
{
    "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
  }
```

**Contagem de e-mails entregues**

```
{
    "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
  }
```

**Contagem 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
  }
```

**Data do ú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
  }
```

**Data do último SMS bloqueado pela operadora**

```
{
    "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 de pedidos padrão
<a name="customerprofiles-default-calculated-attributes-order"></a>

Amazon Connect O Customer Profiles fornece atributos padrão de out-of-the caixa com base nos pedidos. Os atributos são os seguintes:

**Contagem 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
  }
```

**Data de criação do primeiro 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
  }
```

**Data de criação do ú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
  }
```

**Preço total de todos os 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
  }
```

**Média de preço entre todos os pedidos**

```
{
    "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
  }
```

# Mensagens de erro e resoluções para atributos calculados do Amazon Connect Customer Profiles
<a name="customerprofiles-calculated-attributes-troubleshooting"></a>

A tabela a seguir mostra as mensagens de erro, a causa e a resolução dos atributos calculados para cada erro.


| Mensagem de erro | Causa | Resolução | 
| --- | --- | --- | 
| A recuperação de um atributo calculado para um perfil mostra um valor nulo | Isso provavelmente se deve ao fato de o atributo calculado não ter dados. Após a criação de um atributo calculado, novos dados deverão ser ingeridos. | Ingira novos dados ou reingira dados antigos por meio de integrações ou e. CreateProfile PutProfileObject APIs |