AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Transcribes the audio from a customer service call and applies any additional Request Parameters you choose to include in your request.
In addition to many standard transcription features, Call Analytics provides you with call characteristics, call summarization, speaker sentiment, and optional redaction of your text transcript and your audio file. You can also apply custom categories to flag specified conditions. To learn more about these features and insights, refer to Analyzing call center audio with Call Analytics.
If you want to apply categories to your Call Analytics job, you must create them before submitting your job request. Categories cannot be retroactively applied to a job. To create a new category, use the operation. To learn more about Call Analytics categories, see Creating categories for post-call transcriptions and Creating categories for real-time transcriptions.
To make a StartCallAnalyticsJob request, you must first upload your media file
into an Amazon S3 bucket; you can then specify the Amazon S3 location of the file
using the Media parameter.
Note that job queuing is enabled by default for Call Analytics jobs.
You must include the following parameters in your StartCallAnalyticsJob request:
region: The Amazon Web Services Region where you are making your request.
For a list of Amazon Web Services Regions supported with Amazon Transcribe, refer
to Amazon
Transcribe endpoints and quotas.
CallAnalyticsJobName: A custom name that you create for your transcription
job that's unique within your Amazon Web Services account.
DataAccessRoleArn: The Amazon Resource Name (ARN) of an IAM role that has
permissions to access the Amazon S3 bucket that contains your input files.
Media (MediaFileUri or RedactedMediaFileUri): The Amazon S3
location of your media file.
With Call Analytics, you can redact the audio contained in your media file by including
RedactedMediaFileUri, instead of MediaFileUri, to specify the location
of your input audio. If you choose to redact your audio, you can find your redacted
media at the location specified in the RedactedMediaFileUri field of your response.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginStartCallAnalyticsJob and EndStartCallAnalyticsJob.
Namespace: Amazon.TranscribeService
Assembly: AWSSDK.TranscribeService.dll
Version: 3.x.y.z
public abstract Task<StartCallAnalyticsJobResponse> StartCallAnalyticsJobAsync( StartCallAnalyticsJobRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the StartCallAnalyticsJob service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| BadRequestException | Your request didn't pass one or more validation tests. This can occur when the entity you're trying to delete doesn't exist or if it's in a non-terminal state (such as IN PROGRESS). See the exception message field for more information. |
| ConflictException | A resource already exists with this name. Resource names must be unique within an Amazon Web Services account. |
| InternalFailureException | There was an internal error. Check the error message, correct the issue, and try your request again. |
| LimitExceededException | You've either sent too many requests or your input file is too long. Wait before retrying your request, or use a smaller file and try your request again. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer