提供: Bright Pattern Documentation
• 日本語

Revision as of 10:15, 21 September 2026 by BpDeeplTranslateMaintenance (talk | contribs) (Updated via BpDeeplTranslate extension)

< 前へ | 次へ >
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
移動先: 案内検索
• English

voice_recordings

voice_recordings テーブルの各行には、音声録音の保存場所や消去された音声録音に関する情報など、音声録音に関連するデータが含まれています。なお、1回のやり取りに対して複数の音声録音が存在する場合があることにご注意ください。

なお、Bright Pattern Contact Center ソフトウェアのバージョン 3x では、 call_detail テーブルには、caller_recording_url フィールドと callee_recording_url フィールドが含まれていました。これらのフィールドに含まれていたデータは、現在、このテーブルの interaction_id フィールドおよび rec_url フィールドに格納されています。

データの説明

以下の表は、voice_recordings テーブルの各メトリック(列)について、名前(id)、データ型(例:BIGINT、BINARY、BIT、DATETIME、ENUM、INT、VARCHAR など)、および説明を示しています。

なお、時刻関連のメトリックについては、時刻は協定世界時(UTC)で表記されます。


列名 データ型 説明
id BINARY (16) プライマリキー
interaction_id BINARY (16) 音声録音に関連付けられたインタラクションのid
start_time DATETIME 音声録音の特定のセグメントの開始時刻です。これは、rec_url が指し示すものです。
end_time DATETIME 音声録音の特定のセグメントの終了時刻です。これは、rec_url が指し示すものです。
rec_url VARCHAR 特定の音声録音のURL。フォルダー、日付、およびidで構成されています
rec_server_id BINARY (16) 音声録音が保存されているサーバーのidです
encryption_key_id BINARY (16) スクリーン録画の暗号化が有効になっている場合、音声録音の暗号化キー id です。詳細については、『コンタクトセンター管理者ガイド』の以下のセクションをご参照ください。 「暗号化キーの管理」
s3_rec_url VARCHAR 音声録音が Amazon Web Services (AWS) S3
s3_bucket VARCHAR 以下のURLです。 Amazon S3 バケットの; ここにS3の音声録音が保存されます
erase_time DATETIME 音声録音が消去された時刻
erase_login_id VARCHAR 録音を消去したユーザーのログイン id
erase_reason LONGTEXT 音声録音を消去したユーザーによって指定された、音声録音が削除された理由
start_reason ENUM 音声録音が開始された場合、このフィールドは以下の理由のいずれかを返します:
  • CONFIGURATION - 設定された設定(つまり、「通話録音およびモニタリング」セクションのユーザー、サービス、または録音関連の設定)に基づいて音声録音が開始されました。
  • NONE - 理由は不明です。
  • (BAN - シナリオ変数 $(banVoiceRecording) が false に設定されているため、録音が開始されました。
  • DO_NOT_RECORD - シナリオ変数 $(doNotRecord) が false に設定されているため、録音が開始されました。
  • API - エージェントデスクトップから録音が始まりました(エージェントによる手動操作、またはデスクトップ API 経由のいずれか)。
  • INTERNAL - 転送または会議の結果として録音が始まりました。
  • RTP_CHANGED - 通話が別の RTP プロセッサに移動したため、音声録音が開始されました。
stop_reason ENUM 音声録音が停止された場合、このフィールドは以下の理由のいずれかを返します:

CONFIGURATION - 設定された設定(つまり、「通話録音およびモニタリング」セクションのユーザー、サービス、または録音関連の設定)に基づき、音声録音が停止されました。

  • なし - 理由は不明です。
  • BAN - $(banVoiceRecording) シナリオ変数が設定され、音声録音が無効化されました。
  • DO_NOT_RECORD - $(doNotRecord) シナリオ変数が設定され、音声録音が無効化されました。
  • API - エージェントデスクトップから録音停止が行われました(つまり、エージェントによる手動操作、またはデスクトップ API 経由での操作のいずれかです)。
  • INTERNAL - 転送後、通話が切断された、またはシナリオが終了したため、録音が終了しました。
  • RTP_CHANGED - 通話が別の RTP プロセッサに移動したため、音声録音が停止しました。
  • RTP_ERROR - 障害により音声録音が停止しました。障害の種類は error フィールドに報告されます。


注:インタラクション完了後に消去された可能性のある録音のレコードは、消去されたという事実の影響を受けません。その代わりに、この事実は `call_detail` テーブル内の当該通話のレコードにある `erased_voice_recording` フィールドに反映され、消去の詳細は同テーブルの `erase_` フィールドに記録されます。

エラー INT (プライマリ RTP プロセッサ上で)音声録音エラーが発生した場合、このフィールドはエラーの種類を示す数値を返します。エラーの種類は以下の通りです:
  • 0 - この録音セグメントにはいかなるエラーも発生しませんでした(つまり、stop_reason が RTP_ERROR ではありません)。
  • 1 - 将来の使用のために予約済みです
  • 2 - ファイルフォルダーのアクセス権が正しくないため、音声録音が行われませんでした。
  • 3 - ディスクの空き容量が不足しているため、音声録音が行われませんでした。
  • 5 - サービスプロバイダーによって設定された可能性のある、同時録音数の最大制限を超過したため、音声録音が実行されませんでした。
  • 6 - お使いのコンタクトセンターで災害対策録音(すなわち、冗長化)が利用可能な場合、冗長化ホストへの接続が失われました。
  • 7 - お使いのコンタクトセンターでは、災害対策用録音(つまり、冗長化)機能が利用できません。
  • 8 - お使いのコンタクトセンターでは、災害対策用録音(つまり、冗長化)の設定が正しく行われていません。
  • 9 - 暗号化キーのエラーにより、音声録音が行われませんでした。
  • 10 - 無効な音声ペイロードタイプのため、音声録音が行われませんでした。
  • 503 - 録音を担当するホストへの接続が切断されています。
fallback_error INT 取り得る値のリストは、上記(「エラー」フィールドの分)と同じです。
< 前へ | 次へ >