CreateCallAnalyticsCategory - Transcribe
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateCallAnalyticsCategory

Membuat kategori Analytics Panggilan baru.

Semua kategori secara otomatis diterapkan ke transkripsi Call Analytics. Perhatikan bahwa untuk menerapkan kategori pada transkripsi Anda, Anda harus membuatnya sebelum mengirimkan permintaan transkripsi Anda, karena kategori tidak dapat diterapkan secara surut.

Saat membuat kategori baru, Anda dapat menggunakanInputType parameter untuk memberi label kategori sebagaiREAL_TIME kategoriPOST_CALL atau. POST_CALLkategori hanya dapat diterapkan pada transkripsi pasca-panggilan danREAL_TIME kategori hanya dapat diterapkan untuk transkripsi real-time. Jika Anda tidak menyertakanInputType, kategori Anda dibuat sebagaiPOST_CALL kategori secara default.

Kategori Call Analytics terdiri dari aturan. Untuk setiap kategori, Anda harus membuat antara 1 dan 20 aturan. Aturan dapat mencakup parameter ini:InterruptionFilter,NonTalkTimeFilter,SentimentFilter, danTranscriptFilter.

Untuk memperbarui kategori yang ada, lihatUpdateCallAnalyticsCategory.

Untuk mempelajari lebih lanjut tentang kategori Analytics Panggilan, lihat Membuat kategori untuk transkripsi pasca-panggilan dan Membuat kategori untuk transkripsi real-time.

Sintaksis Permintaan

{
   "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"
         }
      }
   ]
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

CategoryName

Nama unik, yang dipilih oleh Anda, untuk kategori Analitik Panggilan Anda. Sangat membantu untuk menggunakan sistem penamaan terperinci yang akan masuk akal bagi Anda di future. Misalnya, lebih baik digunakansentiment-positive-last30seconds untuk kategori di atas nama generik sepertitest-category.

Nama kategori peka huruf besar/kecil.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.

Pola: ^[0-9a-zA-Z._-]+

Diperlukan: Ya

InputType

Pilih apakah Anda ingin membuat kategori real-time atau pasca-panggilan untuk transkripsi Analytics Panggilan Anda.

MenentukanPOST_CALL menetapkan kategori Anda untuk transkripsi pasca-panggilan; kategori dengan jenis masukan ini tidak dapat diterapkan untuk streaming (real-time) transkripsi.

MenentukanREAL_TIME menetapkan kategori Anda untuk streaming transkripsi; kategori dengan jenis masukan ini tidak dapat diterapkan untuk transkripsi pasca-panggilan.

Jika Anda tidak menyertakanInputType, kategori Anda dibuat sebagai kategori pasca-panggilan secara default.

Jenis: String

Nilai yang Valid: REAL_TIME | POST_CALL

Wajib: Tidak

Rules

Aturan menentukan kategori Analytics Panggilan. Saat membuat kategori baru, Anda harus membuat antara 1 dan 20 aturan untuk kategori itu. Untuk setiap aturan, Anda menetapkan filter yang ingin diterapkan ke atribut panggilan. Misalnya, Anda dapat memilih filter sentimen yang mendeteksi apakah sentimen pelanggan positif selama 30 detik terakhir panggilan.

Tipe: Array objek Rule

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 20 item.

Wajib: Ya

Sintaksis Respons

{
   "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"
            }
         }
      ]
   }
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

CategoryProperties

Menyediakan properti kategori baru Anda, termasuk aturan terkait.

Tipe: Objek CategoryProperties

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

BadRequestException

Permintaan Anda tidak lulus satu atau beberapa tes validasi. Hal ini dapat terjadi ketika entitas yang Anda coba hapus tidak ada atau jika itu dalam keadaan non-terminal (sepertiIN PROGRESS). Lihat kolom pesan pengecualian untuk informasi selengkapnya.

Kode Status HTTP: 400

ConflictException

Sumber daya sudah ada dengan nama ini. Nama sumber daya harus unik dalamAkun AWS.

Kode Status HTTP: 400

InternalFailureException

Ada kesalahan internal. Periksa pesan kesalahan, perbaiki masalah, dan coba permintaan Anda lagi.

Kode Status HTTP: 500

LimitExceededException

Anda telah mengirim terlalu banyak permintaan atau file input Anda terlalu panjang. Tunggu sebelum mencoba ulang permintaan Anda, atau gunakan file yang lebih kecil dan coba lagi permintaan Anda.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API di salah satuAWS SDK khusus bahasa, lihat yang berikut ini: