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 fluxos de eventos do Connect Customer Cases
Este tópico explica como configurar e usar fluxos de eventos de caso. Algumas das etapas de integração exigem que você chame as [APIs Connect Customer Cases](https://docs.aws.amazon.com/cases/latest/APIReference/Welcome.html).
## Etapa 1: criar uma instância do Connect Customer e habilitar os perfis de clientes
1. Certifique-se de ter uma instância Connect Customer em funcionamento em um dos locais em Regiões da AWS que os Cases estejam disponíveis. Consulte [Disponibilidade de Chamados por região](regions.md#cases_region).
1. Ative o Connect Customer Customer Profiles. Para instruções, consulte [Ative perfis de clientes para sua instância do Connect Customer](enable-customer-profiles.md).
O Connect Customer Cases requer perfis de clientes porque cada caso deve estar associado a um perfil de cliente do serviço Customer Profiles.
## Etapa 2: adicionar um domínio Cases à sua instância do Connect Customer
Para instruções, consulte [Habilite casos usando o console Connect Customer](enable-cases.md).
Se você quiser adicionar um domínio de caso usando a API, consulte a API na *Referência da [CreateDomain](https://docs.aws.amazon.com/cases/latest/APIReference/API_CreateDomain.html)API Connect Customer Cases*.
## Etapa 1: Criar um modelo de chamado
[Crie um modelo de chamado](case-templates.md). Na *Etapa 6: Fluxos de eventos de chamados de teste*, você usará o modelo.
Se você quiser criar um modelo de caso usando a API, consulte a API na *Referência da [CreateTemplate](https://docs.aws.amazon.com/cases/latest/APIReference/API_CreateTemplate.html)API Connect Customer Cases*.
## Etapa 4: Habilitar fluxos de eventos de chamados e configurar para receber eventos em uma fila SQS
Execute o comando a seguir para habilitar fluxos de eventos de chamados para seu domínio de Chamados. Depois que esse comando é executado, quando os casos são criados ou atualizados, um evento é publicado no barramento padrão do EventBridge serviço em sua conta (ele deve estar no mesmo Região da AWS domínio de Casos).
```
aws connectcases put-case-event-configuration --domain-id {{dad5efb6-8485-4a55-8241-98a88EXAMPLE}} --event-bridge enabled=true
```
Por padrão, os eventos publicados pelo Connect Customer Cases contêm apenas metadados sobre o caso, como`templateId`,`caseId`, `caseArn``approximateChangeTime`, e muito mais. Você pode executar o comando a seguir para obter mais informações sobre o chamado (no momento em que o evento foi gerado) a ser incluído no evento.
**nota**
Se você quiser incluir um campo personalizado no evento, use o ID do campo personalizado. Para obter instruções sobre como localizar o ID do campo personalizado, consulte [Encontrar o ID do campo personalizado](cases-block.md#get-case-properties-find-uuid).
```
# You can include any other field defined in your cases domain in the fields section.
# To list the fields that are defined in your cases domain, call the Cases ListFields API.
# To include case fields that you create (custom fields) in the event, enter the custom field ID.
aws connectcases put-case-event-configuration --domain-id {{YOUR_CASES_DOMAIN_ID}} --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"customer_id\"
},
{
\"id\": \"{{your custom field ID}}\"
}
]
},
\"relatedItemData\": {
\"includeContent\": true
}
}
}"
```
Em seguida, crie uma fila do Amazon SQS e defina-a como destino para os eventos Connect Customer Cases em seu EventBridge ônibus, para que todos os eventos do caso sejam entregues à fila SQS para processamento posterior.
```
# Create an SQS queue
aws sqs create-queue --queue-name case-events-queue --attributes "{\"Policy\": \"{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": [{ \\\"Sid\\\": \\\"case-event-subscription\\\", \\\"Effect\\\": \\\"Allow\\\", \\\"Principal\\\": { \\\"Service\\\": \\\"events.amazonaws.com\\\"}, \\\"Action\\\": \\\"SQS:SendMessage\\\", \\\"Resource\\\": \\\"*\\\"}]}\"}"
# Create an rule on the EventBridge default bus that represents the case events
aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"]}" --state ENABLED
# Ask event bridge to publish case events to the SQS queue.
aws events put-targets --rule case-events-to-sqs-queue --target "[{
\"Id\": \"target-1\",
\"Arn\": \"arn:aws:sqs:{{The AWS Region of your Amazon Connect instance}}:{{your AWS account ID}}:case-events-queue\"
}]"
```
## Etapa 5: Testar fluxos de eventos de chamados
Use o aplicativo de agente Connect Customer para:
1. Aceitar um contato de chat.
1. Criar um perfil de cliente e associá-lo ao contato do chat.
1. Crie um caso.
**nota**
O botão **Criar chamado** na guia **Chamados** fica inativo até que você aceite um contato e associe esse contato a um perfil de cliente.
Navegue até o console do Amazon SQS e verifique se um evento de chamado (tipo:`CASE.CREATED`) para o chamado recém-criado está disponível na fila do SQS. Da mesma forma, você pode modificar o chamado criado acima e obter um evento de chamado correspondente (tipo:`CASE.UPDATED`) na fila do SQS. Você pode associar o contato ao chamado e deixar um comentário sobre o chamado para obter os eventos do chamado para essas ações também.
## Etapa 6: Casos de uso dos fluxos de eventos de chamados
Os fluxos de eventos de chamado publicam eventos sempre que um chamado é criado, um chamado é atualizado, um contato é associado ao chamado e um comentário é adicionado a um chamado. Você pode usar esses eventos para:
+ Métricas, análises e painéis
+ Criar aplicações que notificam os usuários (por exemplo, enviam e-mails)
+ Ações automatizadas que são acionadas com base em determinados tipos de atualizações de chamados
Por exemplo, você pode usar o destino do SQS em EventBridge (conforme mostrado na etapa 4) para armazenar temporariamente os eventos do caso na fila do SQS e usar as funções do Lambda para processar eventos no SQS para criar aplicativos personalizados, como enviar e-mails ao cliente quando o caso for atualizado, resolver automaticamente todas as tarefas vinculadas ao caso e muito mais. Da mesma forma, você pode usar o destino Firehose no EventBridge para armazenar os eventos do caso em um bucket do S3 e, em seguida, usar o AWS Glue para ETL, o Athena para análises ad-hoc e o Quick para painéis.