View a markdown version of this page

Monitore eventos de falha na avaliação de desempenho - Amazon Connect Customer
Step-by-step guiaExemplo de EventBridge carga útilErros comuns

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

Monitore eventos de falha na avaliação de desempenho

Você pode monitorar falhas de avaliações automatizadas, bem como exportações S3 de avaliações de contato usando e. EventBridge CloudWatch Você pode usar esses eventos para investigar e corrigir falhas. O guia a seguir mostra o processo de criação de EventBridge regras personalizadas para monitorar eventos de falha na avaliação de desempenho.

Step-by-step guia

Este é um guia sobre como criar uma EventBridge regra para registrar eventos de envio com falha na avaliação automática do Connect Customer e falhas nas exportações S3 de avaliações de contatos em seu console. AWS

  1. Faça login na sua AWS conta e navegue até o EventBridge console. Escolha Regras na seção Ônibus.

    A guia Regras na seção Ônibus no EventBridge console.

  2. Escolha Criar regra com o barramento de eventos padrão selecionado.

    O botão Criar regra com o barramento de eventos padrão selecionado.

  3. Dê um nome à regra e selecione Regra com um padrão de evento para o tipo de regra. Escolha Próximo.

    O nome da regra e a opção Regra com um padrão de evento selecionados.

  4. Com eventos da AWS ou eventos de EventBridge parceiros selecionados em Eventos, selecione a opção Usar formulário padrão em Padrão de eventos. É aqui que você definirá o padrão a ser combinado para acionar a regra.

  5. Digite e selecione Amazon Connect na lista suspensa de serviços da AWS para restringir os tipos de eventos. Selecione o tipo de evento desejado no menu suspenso abaixo. Escolha Avançar depois que o padrão for configurado.

    Para se inscrever em tipos de EventBridge eventos, crie uma EventBridge regra personalizada que corresponda ao seguinte:

    • "source" = "aws.connect"

    • "detail-type" pode ser um dos seguintes:

      • "Contact Lens Automated Evaluation Submission Failed"

      • "Contact Lens Evaluation Export Failed"

    O padrão de evento com o Amazon Connect selecionado como serviço da AWS.

  6. Na próxima etapa, você pode configurar o (s) alvo (s) para process/receive os eventos correspondentes. Para simplificar, selecione a opção de grupo de CloudWatch registros em Selecionar um destino e escolha um grupo de registros.

  7. Escolha Avançar e avance para a etapa final de revisão e criação. Escolha Criar regra mais uma vez para concluir o processo de criação da regra.

  8. Agora, se a regra estiver no estado Ativado e ocorrer um evento correspondente, os registros correspondentes deverão aparecer no grupo de CloudWatch registros configurado com os IDs relevantes na seção de metadados e o motivo da falha na seção de dados.

    CloudWatch grupo de log mostrando EventBridge eventos correspondentes.
    CloudWatch detalhe do log mostrando os metadados e o motivo da falha.

Exemplo de EventBridge carga útil

Veja a seguir um exemplo de EventBridge carga útil quando a regra é correspondida:

{  
  "version": "0",  
  "id": "00005435-d12d-c93b-d9d2-b64cba85fbb6",
  "detail-type": "Contact Lens Automated Evaluation Submission Failed",  
  "source": "aws.connect",  
  "account": "Your AWS account ID",  
  "time": "2025-10-02T10:34:56Z",  
  "region": "us-west-2",
  "resources": [],  
  "detail": {  
    "version": "1.0.0",  
    "metadata": {  
      "contactId": "4266f8e9-8420-4ee7-96cd-515d2edae1f2",
      "instanceId": "d9b0b09d-7dab-47e5-9f82-d6787fbc068c",
      "formId": "8b1365bd-1415-41a9-a491-af226e1bda4e"
    },  
    "data": {  
      "reasonCode": "ANALYSIS_FILE_ERROR",
      "message": "Automated contact evaluation submission failed due to an error when searching/retrieving/parsing the analysis file."
    }  
  }  
}

Erros comuns

Os erros a seguir podem ocorrer quando o sistema eventualmente não consegue processar as avaliações após várias tentativas de repetição.

Erros automatizados de envio de avaliação

Erro Mensagem de erro
AUTOMATED_SUBMISSION_FAILED O envio automatizado da avaliação de contato falhou porque algumas das perguntas não puderam ser respondidas. Verifique o formulário de avaliação ou as configurações das regras do Connect Customer.
ANALYSIS_FILE_ERROR O envio automatizado da avaliação de contato falhou devido a um erro ao searching/retrieving /analisar o arquivo de análise.
INTERNAL_SERVER_ERROR O envio automatizado da avaliação de contato falhou devido a um erro interno do servidor. Por favor, espere um atraso no processamento.
QUOTA_EXCEEDED_ERROR O envio automatizado da avaliação de contato falhou porque a cota restante para usar a IA generativa para responder automaticamente às perguntas de avaliação do contato é insuficiente.

Erros de exportação do S3 de avaliação

Erro Mensagem de erro
S3_BUCKET_ACCESS_DENIED A exportação JSON da avaliação de contatos falhou devido a permissões insuficientes.
S3_STORAGE_NOT_CONFIGURED O bucket de exportação do S3 não está configurado para sua instância.
INTERNAL_SERVER_ERROR A exportação JSON da avaliação de contato falhou devido a um erro interno do servidor. Aguarde um atraso na entrega do arquivo de exportação.