View a markdown version of this page

Configurar fluxos de eventos do Connect Customer Cases - Amazon Connect Customer

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ê ligue para as APIs https://docs.aws.amazon.com/cases/latest/APIReference/Welcome.html Connect Customer Cases.

Etapa 1: criar uma instância do Connect Customer e ativar os perfis do cliente

  1. Verifique se você tem uma instância do Connect Customer funcionando em um dos Regiões da AWS casos em que os casos estão disponíveis. Consulte Disponibilidade de Chamados por região.

  2. Ative os perfis de clientes do Connect Customer. Para instruções, consulte Habilite perfis de clientes para sua instância Connect Customer.

    O Connect Customer Cases exige perfis de clientes porque cada caso deve ser 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 Ative casos usando o console Connect Customer.

Se você quiser adicionar um domínio de caso usando a API, consulte a API na Referência da CreateDomain API Connect Customer Cases.

Etapa 1: Criar um modelo de chamado

Crie um modelo de chamado. 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 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 Região da AWS mesmo 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, comotemplateId,caseId, caseArnapproximateChangeTime, 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.

# 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 um alvo para os eventos Connect Customer Cases em seu EventBridge barramento, para que todos os eventos do caso sejam entregues à fila do 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\"], \"detail-type\": [\"Amazon Connect Cases Change\"]}" --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.

  2. Criar um perfil de cliente e associá-lo ao contato do chat.

  3. 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 SQS ativado 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 e 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 alvo 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.