録音ファイルをバッチ処理で外部の音声認識システムと連携を行い、音声データのテキスト化を行うために用いることができます。通話の上り・下りチャネル毎の通話録音ファイルをBIZTELサーバ内に保存し、ダウンロード用のAPIを使用して外部システムから連携することが可能です。

また、一括ダウンロードオプションの契約がある場合は、前日分の上り・下りチャネル毎の通話録音ファイルのダウンロードを行い、日次処理での音声データのテキスト化にも用いることができます。

【ステレオ録音】

上り(オペレータ側音声)と下り(相手側音声)の音声をそれぞれ分離した録音データです。

※3.4.0ではMP3形式の録音ファイルとなります。

【外部音声認識システム】

通話音声データをソフトウェアが解析してテキスト化するシステムです。

※この機能性をご利用いただくには、別途、外部音声認識システムのご契約が必要です。

【WebAPI】

汎用的なWeb技術を利用し、インターネットを介して外部システムとの連携を容易にする仕組み。外部システムごとにWebAPIで用いるパラメーターは異なり、各システムで仕様を公開しています。

【BIZTEL API】

BIZTELが公開するAPIを示します。外部システムからBIZTELに対して実行処理や履歴などの取得を行うことができるパラメーターが用意されています。（録音ファイル取得APIはBIZTEL APIの1つとなります。)

・本機能は、BIZTEL バージョン 3.4.0以降でご利用可能です。

・本機能をご利用いただくには、「ステレオ録音」「コールアクション」「録音ファイル取得API」のオプション契約が必要です。
※BIZTELバージョン 3.11.10以降、「ステレオ録音」を「音声ファイル分離」ライセンスに名称変更しています。
※外部連携先の基本契約ライセンスの追加・変更等が必要な場合がございます。
　お客様の契約状況によって異なりますので、詳しくはこちらのフォームよりお問い合わせください。

・お客様(もしくは外部音声認識システム)にて、録音ファイル取得サーバと録音ファイル情報を受信するためのAPIをご用意いただく必要があります。

・BIZTEL API（本マニュアル内では録音ファイル取得API）の実行にはAPIリクエスト数の上限と、連続実行に関する制限があります。
(詳細はBIZTEL 管理画面 > システム設定 > ライセンス設定をご参照ください)

・月間のAPIリクエスト数、APIレスポンスオブジェクト数の上限は、各100,000件となります。
（「録音ファイル取得API」に関する制限かつBIZTEL API全体での上限となります。）

・BIZTELバージョン3.12.0以降、音声ファイル分離を行う対象を設定可能です。詳細は「5.音声ファイル分離設定」を参照ください。

通話終了後、オペレータ（上り）と相手（下り）のそれぞれの録音ファイルが生成されたことを、コールアクション機能でお客様側の録音ファイル取得サーバへ情報を通知します。

※あらかじめ、コールアクション機能の設定が必要です。設定例は「2.1 コールアクション設定例」を参照ください。

①の通知を受け、お客様側のAPIからBIZTEL側に、該当録音ファイルのダウンロードを要求します。

BIZTEL側の録音ファイル取得APIより、指定した録音ファイルをダウンロードします。
録音ファイル取得APIの詳細は「3. 録音ファイル取得APIについて」を参照ください。

お客様側で利用している音声認識システムに録音ファイルを連携し、音声認識の処理が行われます。

お客様側で利用している音声認識システムで録音ファイルの音声をテキスト化します。

録音完了/音声認識サービス連携完了

※BIZTELバージョン 3.4.Xまで、「ステレオ録音完了／音声認識サービス連携完了」と表示されます。

APIトークンによるアカウント認証が必要です。

リクエストヘッダにAuthorization: Token (APIトークン)を指定します。

※アカウント>APIトークンタブから払い出します。詳細は「1.APIトークン」を参照ください。

※リクエストID＝通知されてきた{ID}の値です。

録音ファイルの種別

●monaural
→通常の録音ファイル指定（デフォルト・指定不要）

●left
→相手側の録音ファイル指定

●right
→オペレータ側の録音ファイル指定

■録音ファイル取得APIの実行例

macOSのコンソールにて下記コマンドを入力し実行します。

curl -X GET --header 'Authorization: Token ★払い出しトークン★' 'https://★契約BIZTELサーバFQDN★:8000/public/api/v1/monitor/★リクエストID★?content_type=★コンテンツ種別★' -o ★保存するファイル名★.mp3

■入力サンプル

curl -X GET --header 'Authorization: Token f7e51c7c8b97963e423d7206d75762b7bba2954efabb64aab5734773bf5e5265bf5d79a7be0f1b97' 'https://XXXXXXXXXXXX.u.biztel.jp:8000/public/api/v1/monitor/21091300000468000050?content_type=monaural' -o test.mp3

※上記★〜★の箇所はそれぞれの要件に合わせて変更します。
※curlコマンドを利用する際は必要に応じてcurlコマンドのインストールを行います。

Forbidden

録音ファイルが存在しない場合に出力される

バースト上限値を超過した場合

システム障害

{
Server: nginx
Content-Type: audio/mpeg
Content-Length: 7920
Connection: keep-alive
Cache-Control: no-cache, private
Date: Thu, 17 Jun 2021 05:10:45 GMT
Last-Modified: Thu, 17 Jun 2021 05:06:33 GMT
Content-Disposition: attachment; filename=20210617140624-2001-2004-21061700000668000050-SRC.mp3
Accept-Ranges: bytes
X-Account-ID: 10006
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Strict-Transport-Security: max-age=31536000; includeSubDomains
Referrer-Policy: same-origin
Access-Control-Expose-Headers: Content-Disposition, isCalling
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, DELETE
Access-Control-Allow-Headers: Origin, Content-Type, Authorization, X-Auth-Token, x-xsrf-token
Access-Control-Allow-Credentials: true
X-Robots-Tag: noindex
}

●ファイル名はhttp標準仕様のレスポンスヘッダに含まれます。
Content-Disposition: attachment; filename="(ファイル名)"
※録音ファイル名の命名規則は「4. 録音ファイルの仕様」を参照してください。

対象が存在しません

This action is unauthorized.

exceptions.AccessLimitException.
REQUEST_BURST_LIMIT_EXCEEDED

累積APIリクエスト数、累積APIレスポンスオブジェクト数ともに１づつ消費します。