

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

# Exportar dados unificados do perfil de cliente
<a name="set-up-real-time-export"></a>

Amazon Connect O Customer Profiles fornece exportação de dados em tempo real de perfis unificados de clientes para um Amazon Kinesis Data Stream. Você pode habilitar o fluxo de dados e receber automaticamente dados de novos perfis e atualizações de perfis existentes no Amazon Kinesis Data Stream.

Você pode manter seus dados de sistemas de origem, como ferramentas CRMs de automação de marketing, up-to-date com as informações mais recentes dos perfis de Amazon Connect clientes. Por exemplo, quando um cliente liga para sua central de atendimento para atualizar seu endereço, um atendente pode fazer a alteração para adicionar o novo endereço do cliente, e as informações atualizadas do perfil são enviadas para um Kinesis Data Stream em tempo real.

Para configurar isso, você precisa ativar a **exportação de dados** no console do Customer Profiles.

## Habilitar exportação em tempo real
<a name="enable-real-time-export"></a>

**Para habilitar o fluxo de dados para seu domínio**

1. Abra o console Perfis de Amazon Connect clientes.

1. Selecione a guia **Exportação de dados** e escolha **Ativar streaming de dados**  
![\[A exportação de dados em tempo real permite o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-real-time-export-1.png)

1. Escolha **Ativar streaming de dados** e selecione um fluxo de dados do Kinesis existente no menu suspenso ou escolha **Criar um novo fluxo de dados do Kinesis** para abrir o console do Kinesis e criar o fluxo. Para obter mais informações, consulte [Creating and Managing Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).  
![\[A exportação de dados em tempo real permite o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/enable-real-time-export-2.png)

1. Escolha o botão **Ativar streaming de dados** para salvar suas configurações.

## Habilitar a exportação em tempo real
<a name="disable-real-time-export"></a>

**Para desabilitar o fluxo de dados para seu domínio**

1. Abra o console Perfis de Amazon Connect clientes.

1. Selecione a guia **Exportação de dados** e escolha **Desabilitar o streaming de dados**  
![\[A exportação de dados em tempo real desabilita o fluxo de dados do Kinesis.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/disable-real-time-export-1.png)

## Exportação da carga útil do Kinesis em tempo real
<a name="real-time-export-kinesis-payload"></a>

**Exemplo de evento de saída em 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**  
A versão atual do esquema.

**EventId**  
O ID exclusivo do evento.

**EventTimestamp**  
Registro de data e hora do evento usando o ISO8601 padrão.

**EventType**  
O tipo de evento exportado.  
Valores: CREATED, UPDATED, HEALTH\$1CHECK  
+ CRIADO: O evento de exportação foi para CreateProfile.
+ ATUALIZADO: O evento de exportação foi para um UpdateProfile.
+ HEALTH\$1CHECK: O evento de exportação foi para garantir que os perfis de clientes pudessem ser bem-sucedidos no `putEvent` Kinesis Stream. HealthCheck 

**DomainName**  
O domínio ao qual o evento `/Domain` pertence.

**ObjectTypeName**  
Tipo de objeto do evento  
Valores: `_profile`, `_asset`, `_order`, `_case`. Você também pode usar um nome de modelo predefinido, como `Salesforce-Account` ou um nome de objeto definido personalizado que você pode criar usando a [ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)API.

**AssociatedProfileId**  
ID do perfil padrão ao qual o objeto está associado. Ele só estará presente se o tipo de objeto não for `_profile`

**ProfileObjectUniqueKey**  
O identificador exclusivo do ProfileObject gerado pelo serviço.  
Tipo: string

**Object**  
O perfil padrão ou o próprio objeto de perfil padrão.

**IsMessageRealTime**  
Sinalize para informar se a mensagem está em tempo real ou foi redirecionada.

**Exemplo de carga útil em 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
}
```

# Solucionar problemas de exportação de eventos em tempo real para o fluxo de dados do Kinesis
<a name="real-time-export-troubleshooting"></a>

Pode haver um atraso na primeira exportação de eventos para o fluxo de dados do Kinesis. Isso se deve ao tempo necessário para propagar as permissões do IAM para a função vinculada ao serviço. Quando ocorre um problema real, o status de transmissão pode entrar em um estado de erro.

![\[Eventos incapazes de alcançar o fluxo de dados do Kinesis de destino entrando em um estado de erro.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/real-time-export-troubleshooting.png)


As seções a seguir exibem as possíveis mensagens de erro que você pode encontrar. Ele também fornece a causa e a resolução de cada problema.

## Erro: o Kinesis Data Stream não está ativo. Verifique a configuração e recrie o fluxo de eventos mais tarde
<a name="real-time-export-kinesis-not-active"></a>

O Kinesis Data Stream de destino não está no estado `ACTIVE`. Isso pode acontecer quando seu Kinesis Data Stream está sendo criado ou excluído. Para resolver o erro, verifique se o Kinesis Data Stream está no estado ACTIVE e reative a configuração do streaming de dados.

## Erro: o Kinesis Data Stream não existe. Recrie o fluxo de eventos com um destino do Kinesis Data Stream válido
<a name="real-time-export-kinesis-not-found"></a>

O Kinesis Data Stream de destino foi excluído. Para resolver o erro, reative o streaming de dados com um Kinesis Data Stream existente como destino.

## Erro: a utilização do Kinesis Data Stream está sendo controlada. Considere provisionar adequadamente uma taxa de transferência maior do Kinesis
<a name="real-time-export-kinesis-throttling"></a>

A utilização do Kinesis Data Stream de destino está sendo controlada (subprovisionado). Para resolver o erro, certifique-se de que o Kinesis Data Stream de destino tenha contagem de fragmentos suficiente e reative o streaming de dados.

## Erro: a utilização da chave do KMS usada para criptografar o Kinesis Data Streams está sendo controlada. Considere aumentar a cota de solicitações do KMS de forma adequada
<a name="real-time-export-kms-throttling"></a>

A utilização da chave do KMS usada pelo Kinesis Data Streams está sendo controlada. Para resolver o erro, reative o streaming de dados.

## Erro: verifique a configuração da chave do KMS do seu Kinesis Data Streams
<a name="real-time-export-kms-error"></a>

O Customer Profiles não pode acessar a chave do KMS usada pelo Kinesis Data Streams. Isso pode acontecer quando sua chave do KMS tem uma política de chave que nega o acesso da função vinculada ao serviço Customer Profiles ou quando a chave não está no status habilitado. Para resolver o erro, a política de chaves do KMS não deve negar o acesso da função vinculada ao serviço Customer Profiles e a chave deve estar no status Habilitado. Reative o streaming de dados para resolver o erro.