CreateCallAnalyticsCategory - Transcribe
リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateCallAnalyticsCategory

コール分析カテゴリを新規作成します。

すべてのカテゴリがCall Analyticsの文字起こしに自動的に適用されます。カテゴリーは遡って適用できないため、文字起こしにカテゴリーを適用するには、文字起こしリクエストを送信する前にカテゴリーを作成する必要があることに注意してください。

新しいカテゴリを作成するときに、InputTypePOST_CALLREAL_TIMEパラメータを使用してカテゴリにまたはカテゴリのラベルを付けることができます。 POST_CALLカテゴリは通話後の文字起こしにのみ適用でき、REAL_TIMEカテゴリはリアルタイムの文字起こしにのみ適用できます。含めない場合InputType、POST_CALLカテゴリはデフォルトでカテゴリとして作成されます。

コール分析カテゴリはルールで構成されています。カテゴリごとに、1 から 20 のルールを作成する必要があります。ルールには、InterruptionFilter、NonTalkTimeFilterSentimentFilter、およびのパラメータを含めることができますTranscriptFilter。

既存のカテゴリを更新するには、を参照してくださいUpdateCallAnalyticsCategory。

通話分析カテゴリの詳細については、「通話後の文字起こし用のカテゴリの作成」と「リアルタイムの文字起こし用のカテゴリの作成」を参照してください。

リクエストの構文

{
   "CategoryName": "string",
   "InputType": "string",
   "Rules": [ 
      { 
         "InterruptionFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "NonTalkTimeFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "SentimentFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Sentiments": [ "string" ]
         },
         "TranscriptFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Targets": [ "string" ],
            "TranscriptFilterType": "string"
         }
      }
   ]
}

リクエストパラメータ

すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。

リクエストは以下の JSON 形式のデータを受け入れます。

CategoryName

コール分析カテゴリ用に自分で選んだ一意の名前。future 的にわかりやすい詳細な命名システムを使用すると便利です。たとえば、sentiment-positive-last30secondstest-categoryカテゴリには次のような一般的な名前よりも使用する方が適切です。

カテゴリ名では大文字と小文字が区別されます。

タイプ: 文字列

長さの制限: 最小長は 1 です。最大長は 200 です。

パターン: ^[0-9a-zA-Z._-]+

必須: はい

InputType

Call Analyticsの文字起こし用に、リアルタイムカテゴリと通話後のカテゴリのどちらを作成するかを選択します。

指定すると、POST_CALLカテゴリが通話後の文字起こしに割り当てられます。この入力タイプのカテゴリは、ストリーミング (リアルタイム) 文字起こしには適用できません。

指定すると、REAL_TIMEカテゴリがストリーミング文字起こしに割り当てられます。この入力タイプのカテゴリは、通話後の文字起こしには適用できません。

含めない場合InputType、カテゴリはデフォルトでポストコールカテゴリとして作成されます。

タイプ: 文字列

有効な値: REAL_TIME | POST_CALL

必須: いいえ

Rules

ルールはコール分析カテゴリを定義します。新しいカテゴリを作成する場合、そのカテゴリに対して 1 から 20 のルールを作成する必要があります。ルールごとに、コールの属性に適用するフィルターを指定します。たとえば、通話の最後の 30 秒間に顧客のセンチメントがポジティブだったかどうかを検出するセンチメントフィルターを選択できます。

型: Rule オブジェクトの配列

配列メンバー: 最小数は 1 項目です。最大数は 20 項目です。

必須: はい

レスポンスの構文

{
   "CategoryProperties": { 
      "CategoryName": "string",
      "CreateTime": number,
      "InputType": "string",
      "LastUpdateTime": number,
      "Rules": [ 
         { 
            "InterruptionFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "NonTalkTimeFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "SentimentFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Sentiments": [ "string" ]
            },
            "TranscriptFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Targets": [ "string" ],
               "TranscriptFilterType": "string"
            }
         }
      ]
   }
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

CategoryProperties

新しいカテゴリのプロパティと、関連するルールが表示されます。

型: CategoryProperties オブジェクト

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

BadRequestException

リクエストは 1 つ以上の検証テストに合格しませんでした。削除しようとしているエンティティが存在しない場合、または非終端状態 (例:「進行中」IN PROGRESS) の場合。例外の詳細については、例外の詳細については、例外の詳細を参照してください。

HTTP ステータスコード: 400

ConflictException

この名前のリソースは既に存在します。リソース名は内で一意である必要がありますAWS アカウント。

HTTP ステータスコード: 400

InternalFailureException

インターナルエラーが発生しました。エラーメッセージを確認して、問題を修正して、リクエストを再実行してください。

HTTP ステータスコード: 500

LimitExceededException

送信されたリクエストが多すぎるか、または入力ファイルが長すぎます。リクエストを再試行してください。または小さいファイルを使用してリクエストを再試行してください。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。