StartCallAnalyticsJob

Transcreve o áudio de uma chamada de atendimento ao cliente e aplica quaisquer parâmetros de solicitação adicionais que você escolher incluir em sua solicitação.

Além de muitos recursos de transcrição padrão, o Call Analytics fornece as características da chamada, o resumo da chamada, o sentimento do palestrante e a redação opcional da transcrição do texto e do arquivo de áudio. Você também pode aplicar categorias personalizadas para sinalizar condições especificadas. Para saber mais sobre esses recursos e insights, consulte Análise do áudio do call center com o Call Analytics.

Se você quiser aplicar categorias ao seu trabalho de Call Analytics, você deve criá-las antes de enviar sua solicitação de emprego. As categorias não podem ser aplicadas retroativamente a uma vaga. Para criar uma nova categoria, use aCreateCallAnalyticsCategory operação. Para saber mais sobre as categorias de análise de chamadas, consulte Criação de categorias para transcrições pós-chamada e Criação de categorias para transcrições em tempo real.

Para fazer umaStartCallAnalyticsJob solicitação, você deve primeiro carregar seu arquivo de mídia em um bucket do Amazon S3; depois, você pode especificar a localização do arquivo no Amazon S3 usando oMedia parâmetro.

Você deve incluir os seguintes parâmetros em suaStartCallAnalyticsJob solicitação:

• region: ORegião da AWS local em que você está fazendo sua solicitação. Para obter uma lista deRegiões da AWS opções compatíveis com o Amazon Transcribe, consulte os endpoints e cotas do Amazon Transcribe.

• CallAnalyticsJobName: um nome personalizado que você cria para seu trabalho de transcrição que é exclusivo dentro do seuConta da AWS.

• DataAccessRoleArn: o nome de recurso da Amazon (ARN) de um perfil do IAM que tem permissões para acessar o bucket do Amazon S3 que contém seus arquivos de entrada.

• Media(MediaFileUriouRedactedMediaFileUri): a localização do seu arquivo de mídia no Amazon S3.

nota

Com o Call Analytics, você pode editar o áudio contido em seu arquivo de mídia incluindoRedactedMediaFileUri, em vez deMediaFileUri, especificar a localização do áudio de entrada. Se você optar por redigir seu áudio, poderá encontrar sua mídia editada no local especificado noRedactedMediaFileUri campo de sua resposta.

Sintaxe da solicitação

{
   "CallAnalyticsJobName": "string",
   "ChannelDefinitions": [ 
      { 
         "ChannelId": number,
         "ParticipantRole": "string"
      }
   ],
   "DataAccessRoleArn": "string",
   "Media": { 
      "MediaFileUri": "string",
      "RedactedMediaFileUri": "string"
   },
   "OutputEncryptionKMSKeyId": "string",
   "OutputLocation": "string",
   "Settings": { 
      "ContentRedaction": { 
         "PiiEntityTypes": [ "string" ],
         "RedactionOutput": "string",
         "RedactionType": "string"
      },
      "LanguageIdSettings": { 
         "string" : { 
            "LanguageModelName": "string",
            "VocabularyFilterName": "string",
            "VocabularyName": "string"
         }
      },
      "LanguageModelName": "string",
      "LanguageOptions": [ "string" ],
      "VocabularyFilterMethod": "string",
      "VocabularyFilterName": "string",
      "VocabularyName": "string"
   }
}

Parâmetros de solicitação

Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

CallAnalyticsJobName

Um nome exclusivo, escolhido por você, para seu trabalho de Call Analytics.

Esse nome diferencia maiúsculas de minúsculas, não pode conter espaços e deve ser exclusivo em umConta da AWS. Se você tentar criar um novo trabalho com o mesmo nome de um trabalho existente, você receberá umConflictException erro.

Tipo: String

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

Padrão: ^[0-9a-zA-Z._-]+

Obrigatório: Sim

ChannelDefinitions

Permite especificar qual alto-falante está em qual canal. Por exemplo, se seu agente for o primeiro participante a falar, você configurariaChannelId para0 (para indicar o primeiro canal) eParticipantRole paraAGENT (para indicar que é o agente falando).

Tipo: matriz de objetos ChannelDefinition

Membros da matriz: número fixo de 2 itens.

Obrigatório: não

DataAccessRoleArn

O nome de recurso da Amazon (ARN) de um perfil do IAM que tem permissões para acessar o bucket do Amazon S3 que contém seus arquivos de entrada. Se a função especificada não tiver as permissões apropriadas para acessar o local especificado do Amazon S3, sua solicitação falhará.

Os ARNs da função IAM têm o formatoarn:partition:iam::account:role/role-name-with-path. Por exemplo: arn:aws:iam::111122223333:role/Admin.

Para obter mais informações, consulte ARNs do IAM.

Tipo: String

Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2048.

Padrão: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

Obrigatório: não

Media

Descreve a localização do arquivo de mídia no Amazon S3 que você deseja usar em sua solicitação de Call Analytics.

Tipo: objeto Media

Obrigatório: Sim

OutputEncryptionKMSKeyId

A chave do KMS que você deseja usar para criptografar sua saída do Call Analytics.

Se estiver usando uma chave localizada na atualConta da AWS, você pode especificar sua chave KMS de uma das quatro maneiras:

1. Use o próprio ID da chave KMS. Por exemplo, 1234abcd-12ab-34cd-56ef-1234567890ab.

2. Use um alias para o ID da chave do KMS. Por exemplo, alias/ExampleAlias.

3. Use o nome de recurso da Amazon (ARN) para o nome de recurso da Amazon (ARN) para a ID de chave do KMS. Por exemplo, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

4. Use o ARN para o alias da chave do KMS. Por exemplo, arn:aws:kms:region:account-ID:alias/ExampleAlias.

Se estiver usando uma chave localizada em umaConta da AWS posição diferente da atualConta da AWS, você pode especificar sua chave KMS de duas maneiras:

1. Use o ARN para o ID da chave KMS. Por exemplo, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

2. Use o ARN para o alias da chave do KMS. Por exemplo, arn:aws:kms:region:account-ID:alias/ExampleAlias.

Se você não especificar uma chave de criptografia, sua saída será criptografada com a chave do Amazon S3 (SSE-KMS).

Se você especificar uma chave KMS para criptografar sua saída, também deverá especificar um local de saída usando oOutputLocation parâmetro.

Observe que a função que faz aStartCallAnalyticsJob solicitação deve ter permissão para usar a chave do KMS selecionada.

Tipo: String

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

Padrão: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

Obrigatório: não

OutputLocation

O local do Amazon S3 em que você deseja que a saída da transcrição do Call Analytics. Você pode usar qualquer um dos seguintes formatos para especificar o local de saída:

1. s3://DOC-EXAMPLE-BUCKET

2. s3://DOC-EXAMPLE-BUCKET/my-output-folder/

3. s3://DOC-EXAMPLE-BUCKET/my-output-folder/my-call-analytics-job.json

A menos que você especifique um nome de arquivo (opção 3), o nome do seu arquivo de saída tem um valor padrão que corresponde ao nome que você especificou para o trabalho de transcrição usando oCallAnalyticsJobName parâmetro.

Você pode especificar uma chave KMS para criptografar sua saída usando oOutputEncryptionKMSKeyId parâmetro. Se você não especificar uma chave do KMS, o Amazon Transcribe usa a chave do Amazon S3 para a chave do Amazon S3.

Se você não especificarOutputLocation, sua transcrição será colocada em um bucket Amazon S3 gerenciado por serviços e você receberá um URI para acessar sua transcrição.

Tipo: String

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

Padrão: (s3://|http(s*)://).+

Obrigatório: não

Settings

Especifique configurações opcionais adicionais em suaStartCallAnalyticsJob solicitação, incluindo redação de conteúdo; permite que você aplique modelos de linguagem personalizados, filtros de vocabulário e vocabulários personalizados ao seu trabalho de Análise de Chamadas.

Tipo: objeto CallAnalyticsJobSettings

Obrigatório: não

Sintaxe da resposta

{
   "CallAnalyticsJob": { 
      "CallAnalyticsJobName": "string",
      "CallAnalyticsJobStatus": "string",
      "ChannelDefinitions": [ 
         { 
            "ChannelId": number,
            "ParticipantRole": "string"
         }
      ],
      "CompletionTime": number,
      "CreationTime": number,
      "DataAccessRoleArn": "string",
      "FailureReason": "string",
      "IdentifiedLanguageScore": number,
      "LanguageCode": "string",
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "Settings": { 
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "LanguageIdSettings": { 
            "string" : { 
               "LanguageModelName": "string",
               "VocabularyFilterName": "string",
               "VocabularyName": "string"
            }
         },
         "LanguageModelName": "string",
         "LanguageOptions": [ "string" ],
         "VocabularyFilterMethod": "string",
         "VocabularyFilterName": "string",
         "VocabularyName": "string"
      },
      "StartTime": number,
      "Transcript": { 
         "RedactedTranscriptFileUri": "string",
         "TranscriptFileUri": "string"
      }
   }
}

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

CallAnalyticsJob

Fornece informações detalhadas sobre o trabalho atual do Call Analytics, incluindo o status do trabalho e, se aplicável, o motivo da falha.

Tipo: objeto CallAnalyticsJob

Erros

Para obter informações sobre os erros comuns a todas as ações, consulteErros comuns.

BadRequestException

Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou se está em um estado não terminal (comoIN PROGRESS). Consulte o campo da mensagem de exceção para obter mais informações.

Código de status HTTP: 400

ConflictException

Já existe um recurso com esse nome. Os nomes de recurso devem ser exclusivos dentro de umaConta da AWS.

Código de status HTTP: 400

InternalFailureException

Ocorreu um erro interno. Verifique a mensagem de erro, corrija o problema e tente novamente.

Código de status HTTP: 500

LimitExceededException

Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Espere antes de repetir sua solicitação ou use um arquivo menor e tente novamente.

Código de status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK para Java V2

• AWSSDK para JavaScript

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK for Ruby V3