View a markdown version of this page

Saída do formulário de avaliação do agente no Connect Customer - 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á.

Saída do formulário de avaliação do agente no Connect Customer

Esta seção mostra o caminho de saída de exportação para avaliações e fornece um exemplo de pontuações do formulário de avaliação e descreve os respectivos metadados.

Verificar o bucket do S3

Ao habilitar Avaliações de contato no console do Connect Customer , você receberá a solicitação de criar ou escolher um bucket do S3 para armazenar as avaliações. Para verificar o nome do bucket, acesse o alias da instância, escolha Armazenamento físico de dados, Avaliações de contato e Editar.

Exemplos de locais de saída

A seguir encontra-se o caminho do arquivo de saída para formulários de avaliação:

  • contact_evaluations_S3_bucketYYYY/MM/DD/hh:mm:ss.sTZD/Avaliações/ - .json evaluation_id

Por exemplo:

amazon-connect-s3/Evaluations/2022/04/14/05:04:20.869Z-11111111-2222-3333-4444-555555555555.json

Problema conhecido: dois arquivos de saída para a mesma avaliação

O Contact Lens gera dois arquivos de saída para o mesmo formulário de avaliação.

  • Um arquivo é gravado no novo caminho padrão do S3. Você pode configurar o caminho no AWS console.

  • Outro arquivo, que será descontinuado, é gravado em um caminho anterior diferente do S3. Você pode ignorar esse arquivo.

    O caminho anterior do S3 tem a seguinte aparência:

    • s3_bucket/Evaluations/contact_ contactId evaluationId /avaliação_/YYYY-MM-DDThh:mm:ss.sTZD.json

Exemplos de pontuação

O exemplo a seguir mostra uma pontuação típica.

{ "schemaVersion": "3.5", "evaluationId": "fb90de35-4507-479a-8b57-970290fd5c2c", "metadata": { "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb", "accountId": "874551140838", "instanceId": "8f753c94-9cd2-4f16-85eb-945f7f0d559a", "agentId": "286bcec0-e722-4166-865f-84db80252218", "evaluationDefinitionTitle": "Compliance Evaluation Form", "evaluator": "jane", "evaluationDefinitionId": "15d8fbf1-b4b2-4ace-869b-82714e2f6e3e", "evaluationDefinitionVersion": 2, "evaluationStartTimestamp": "2025-11-14T17:57:08.649Z", "evaluationSubmitTimestamp": "2025-11-14T17:59:29.052Z", "score": { "percentage": 100 }, "creator": "jane.doe@acme.com", "autoEvaluated": false, "resubmitted": false, "evaluationSource": "ASSISTED_BY_AUTOMATION", "evaluationType": "CONTACT_EVALUATION", "evaluationAcknowledgerComment": "The Acknowledgment comment", "evaluationAcknowledgedTimestamp": "2025-12-22T05:20:39.297Z", "evaluationAcknowledgedByUserName": "john", "evaluationAcknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218" }, "sections": [ { "sectionRefId": "s1a1b58d6", "sectionTitle": "The title of the section", "notes": "Section note", "score": { "percentage": 100 } }, { "sectionRefId": "s46661c49", "sectionTitle": "The title of the subsection", "parentSectionRefId": "s1a1b58d6", "score": { "percentage": 100 } } ], "questions": [ { "questionRefId": "q570b206a", "sectionRefId": "s46661c49", "questionType": "NUMERIC", "questionText": "How do you rate the contact between 1 and 10?", "answer": { "value": "", "notes": "Add more information here", "metadata": { "notApplicable": true } }, "score": { "notApplicable": true } }, { "questionRefId": "q73bc5b9d", "sectionRefId": "s46661c49", "questionType": "SINGLESELECT", "questionText": "Did the agent introduce themselves?", "answer": { "values": [ { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": true }, { "valueText": "No", "valueRefId": "o284e4d9e", "selected": false }, { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false } ], "notes": "Add more information here", "automation": { "status": "SYSTEM_ANSWER", "systemSuggestedValue": "Yes" }, "metadata": { "notApplicable": false } }, "score": { "percentage": 100 } }, { "questionRefId": "h89bc7a9t", "sectionRefId": "s46661c49", "questionType": "SINGLESELECT", "questionText": "Did the agent offer a promotion?", "answer": { "values": [ { "valueText": "Yes", "valueRefId": "p7888bb85", "selected": false }, { "valueText": "No", "valueRefId": "p395f5e8f", "selected": true }, { "valueText": "Maybe", "valueRefId": "p2c3g1b25", "selected": false } ], "notes": "Add more information here", "assistedSuggestion": { "value": "No. A promotion was not offered by the agent." }, "metadata": { "notApplicable": false } }, "score": { "percentage": 100 } }, { "questionRefId": "qc2effc9d", "sectionRefId": "s46661c49", "questionType": "TEXT", "questionText": "Describe the outcome.", "answer": { "value": "Example answer text", "notes": "Add more information here", "metadata": { "notApplicable": false } }, "score": { "percentage": 50 } } ] }

Definições de metadados do formulário de avaliação

A lista a seguir descreve os campos no formulário de avaliação.

evaluationId

Um identificador exclusivo para a avaliação de contato

Tipo: String

Restrições de tamanho: tamanho mínimo de 1. Tamanho máximo de 500

metadata
contactId

O identificador do contato nesta instância do Amazon Connect.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 256

accountId

O identificador da AWS conta que executa a instância do Connect Customer.

Tipo: String

Restrições de tamanho: restrições: 12 dígitos

Padrão: ^\d{12}$

instanceId

O identificador da instância do Amazon Connect. Você pode encontrar o ID da instância no nome do recurso da Amazon (ARN) da instância.

Restrições de tamanho: tamanho mínimo de 1 e máximo de 100

agentId

O identificador do atendente que realizou o contato.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 500

avaliação DefinitionTitle

O título do formulário de avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 128

evaluator

Nome do usuário que atualizou a avaliação por último.

Tipo: String

avaliação DefinitionId

O identificador exclusivo do formulário de avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 500.

avaliação DefinitionVersion

A versão do formulário de avaliação.

Tipo: Inteiro

Intervalo válido: valor mínimo de 1

avaliação StartTimestamp

A data e hora de criação da avaliação.

Tipo: data e hora

Exemplo — 2025-11-14 T17:57:08.649Z

avaliação SubmitTimestamp

A data e hora de envio da avaliação.

Tipo: data e hora

Exemplo — 2025-11-14 T17:59:29.052Z

score

A pontuação da avaliação.

creator

A entidade que criou a avaliação pela primeira vez (em vez de “avaliador”, que representa a entidade que enviou a avaliação por último). Quando a chamada é feita a partir do site Connect Customer administrativo, ela contém o nome de usuário. Quando a chamada vem da API, ela contém o ARN do chamador.

Tipo: String

autoEvaluated

Indica se a avaliação foi enviada usando avaliações totalmente automatizadas.

Tipo: booliano

resubmitted

Indica se a avaliação foi reenviada (editada e enviada novamente).

Tipo: booliano

evaluationSource

O tipo de fonte de resposta da avaliação.

Tipo: String

Valores válidos:

  • ASSISTED_BY_AUTOMATION: indica que a automação de perguntas foi usada para responder a algumas das perguntas.

  • MANUAL: indica que a avaliação foi realizada manualmente.

  • AUTOMATED: indica que a avaliação foi enviada usando avaliações totalmente automatizadas (consulte o campo “autoEvaluated”).

Tipo de avaliação

O tipo de avaliação.

Tipo: String

Valores válidos:

  • CONTACT_EVALUATION- avaliação de um contato.

calibração SessionId

O identificador da sessão de calibração associada a essa avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 500

avaliado ParticipantId

O identificador do participante que está sendo avaliado.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 256

avaliado ParticipantRole

O papel do participante que está sendo avaliado.

Tipo: String

Valores válidos:

  • AGENT- o agente participante.

  • CUSTOMER- o cliente participante.

  • SYSTEM- o participante do sistema.

acknowledgerComment

Comentário deixado pelo usuário que confirmou a avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 0 e máximo de 3072

avaliação AcknowledgedByUserId

O identificador da pessoa que confirmou a avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 500

avaliação AcknowledgedByUserName

O nome da pessoa que confirmou a avaliação.

Tipo: String

avaliação AcknowledgedTimestamp

O carimbo de data/hora de confirmação da avaliação.

Tipo: data e hora

Exemplo — 2025-12-24 T15:45:56.662Z

sections

Matriz das seções da avaliação.

seção RefId

O identificador da seção. Um identificador deve ser exclusivo no formulário de avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 40

pai SectionRefId

O identificador da seção pai.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 40

sectionTitle

O título da seção.

Tipo: String

Restrições de tamanho: restrições: tamanho mínimo de 0 e máximo de 128

observações

As observações deixadas para a seção.

Tipo: String

Restrições de tamanho: tamanho mínimo de 0 e máximo de 3072

nota

As observações têm os seguintes limites:

  • As observações individuais têm um limite de 3.072 caracteres.

  • As observações combinadas em uma avaliação têm um limite de N x 1.024 caracteres, em que N é o número de perguntas na avaliação.

score

A pontuação da seção.

percentage

A porcentagem de pontuação de um item em uma avaliação de contato.

Tipo: duplo

Intervalo válido: valor mínimo de 0 e máximo de 100

automaticFail

O sinalizador que marca o item como falha automática. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro.

Tipo: booliano

notApplicable

O sinalizador que marca o item como falha automática. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro.

Tipo: booliano

perguntas

Matriz das perguntas da avaliação.

pergunta RefId

O identificador da pergunta. Um identificador deve ser exclusivo no formulário de avaliação.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 40.

seção RefId

O identificador da seção pai.

Tipo: String

Restrições de tamanho: tamanho mínimo de 1 e máximo de 40

questionType

O tipo da pergunta.

Tipo — as notas StrThe combinadas em uma avaliação têm um limite de N x 1024 caracteres, onde N é o número de perguntas na avaliação.ing

Valores válidos: TEXT | SINGLESELECT | NUMERIC

questionText

O título da pergunta.

Tipo: String

Restrições de tamanho: tamanho mínimo de 0 e máximo de 350

answer

A resposta para a pergunta.

valor

O string/numeric valor de uma resposta em uma avaliação de contato.

Tipo: String/Double

Restrições de tamanho: string: tamanho mínimo de 0 e máximo de 128

observações

As observações deixadas para a seção.

Tipo: String

Restrições de tamanho: tamanho mínimo de 0. Tamanho máximo de 3.072

nota

As observações têm limites de dois caracteres. As observações individuais têm um limite de 3.072 caracteres. As observações combinadas em uma avaliação têm um limite de N x 1.024 caracteres, em que N é o número de perguntas na avaliação.

metadata

notApplicable

Sinalizador que marca a pergunta como não aplicável.

Tipo: booliano

assistedSuggestion

Resposta sugerida pela IA generativa.

Tipo: String

automação
status

O status da resposta de automação.

Tipo: String

Valores válidos: UNAVAILABLE | SYSTEM_ANSWER | OVERRIDDEN_ANSWER

sistema SuggestedValue

A string ou valor numérico de uma resposta de automação em uma avaliação de contato.

Tipo: string ou duplo

Restrições de tamanho: string: tamanho mínimo de 0 e máximo de 128

score

A score da pergunta.

  • automaticFail: o sinalizador que marca o item como crítico para o formulário e o formulário completo falhará (marcado com pontuação zero) quando o item falhar. Se o item ou um item secundário obtiver uma resposta de falha automática, esse sinalizador será verdadeiro e o formulário completo também falhará.

    Tipo: booliano

  • Não aplicável: o sinalizador que marca o item como não aplicável para pontuação será excluído dos cálculos de pontuação.

    Tipo: booliano

Exemplo de avaliação exportada

O exemplo a seguir mostra uma avaliação exportada típica.

{ "schemaVersion": "3.5", "evaluationId": "fb90de35-4507-479a-8b57-970290fd5c2c", "metadata": { "accountId": "874551140838", "instanceId": "8f753c94-9cd2-4f16-85eb-945f7f0d559a", "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb", "agentId": "286bcec0-e722-4166-865f-84db80252218", "evaluationDefinitionTitle": "Legal Compliance Evaluation Form", "evaluator": "jane", "evaluationDefinitionId": "15d8fbf1-b4b2-4ace-869b-82714e2f6e3e", "evaluationDefinitionVersion": 2, "evaluationStartTimestamp": "2022-11-14T17:57:08.649Z", "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z", "score": { "percentage": 85 }, "autoEvaluated": false, "creator": "john", "resubmitted": false, "evaluationSource": "ASSISTED_BY_AUTOMATION", "evaluationType": "CONTACT_EVALUATION", "calibrationSessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "evaluationAcknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218", "evaluationAcknowledgedByUserName": "mike", "evaluationAcknowledgedTimestamp": "2022-12-24T15:45:56.662Z", "evaluationAcknowledgerComment": "Manager walked through the evaluation during coaching", "evaluatedParticipantId": "participant-123", "evaluatedParticipantRole": "AGENT" }, "sections": [ { "sectionRefId": "s1a1b58d6", "sectionTitle": "Communication Skills", "notes": "Overall communication was professional", "score": { "percentage": 90 } }, { "sectionRefId": "s46661c49", "sectionTitle": "Greeting and Introduction", "parentSectionRefId": "s1a1b58d6", "notes": "Agent followed proper greeting protocol", "score": { "percentage": 100 } } ], "questions": [ { "questionRefId": "q570b206a", "sectionRefId": "s46661c49", "questionType": "NUMERIC", "questionText": "How many times did agent interrupt the customer", "answer": { "value": "2", "notes": "Interruptions were minimal and appropriate", "metadata": { "notApplicable": false, "automation": { "status": "OVERRIDDEN_ANSWER", "systemSuggestedValue": "3" } } }, "score": { "percentage": 80 } }, { "questionRefId": "q73bc5b9d", "sectionRefId": "s46661c49", "questionType": "SINGLESELECT", "questionText": "Did the agent introduce themselves?", "answer": { "values": [ { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": true }, { "valueText": "No", "valueRefId": "o284e4d9e", "selected": false }, { "valueText": "N/A", "valueRefId": "system_default_null_value", "selected": false } ], "notes": "Agent provided clear introduction with name and department", "metadata": { "notApplicable": false, "assistedSuggestion": { "value": "The agent introduced themselves at the beginning of the call." } } }, "score": { "percentage": 100 } }, { "questionRefId": "h89bc7a9t", "sectionRefId": "s46661c49", "questionType": "SINGLESELECT", "questionText": "Did the agent ask for consent to perform a credit check", "answer": { "values": [ { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": false }, { "valueText": "No", "valueRefId": "o284e4d9e", "selected": true }, { "valueText": "N/A", "valueRefId": "system_default_null_value", "selected": false } ], "notes": "Agent failed to obtain consent before credit check", "metadata": { "notApplicable": false } }, "score": { "percentage": 0, "automaticFail": true } }, { "questionRefId": "qc2effc9d", "sectionRefId": "s46661c49", "questionType": "MULTISELECT", "questionText": "What topics were discussed during the call", "answer": { "values": [ { "valueText": "Account balance", "valueRefId": "topic_balance", "selected": true }, { "valueText": "Payment options", "valueRefId": "topic_payment", "selected": true }, { "valueText": "Account closure", "valueRefId": "topic_closure", "selected": false } ], "notes": "Customer inquired about balance and payment plans", "metadata": { "notApplicable": false } }, "score": { "notApplicable": true } }, { "questionRefId": "q8a9b0c1d", "sectionRefId": "s46661c49", "questionType": "TEXT", "questionText": "What was your general impression about the customer's satisfaction", "answer": { "value": "The customer seemed satisfied with the resolution and thanked the agent", "notes": "Positive customer sentiment throughout the call", "metadata": { "notApplicable": false } }, "score": { "notApplicable": true } }, { "questionRefId": "q2b3c4d5e", "sectionRefId": "s46661c49", "questionType": "DATETIME", "questionText": "What time was the follow-up scheduled", "answer": { "value": "2024-04-16T14:30:00+01:00", "notes": "Follow-up appointment confirmed with customer", "metadata": { "notApplicable": false } }, "score": { "notApplicable": true } } ] }