Zoho Voice録音API

Zoho Voice録音API

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

録音／ボイスメールのダウンロードAPI

このAPIを使用して、録音またはボイスメールのファイルをダウンロードできます。

メモ。

1. ボイスメールと録音ログファイルのダウンロードには、同じAPIが使用されます。ダウンロードするファイルはファイル名によって決まります。

2. このURLのしきい値は1分あたり30通話で、ロック期間は10分です

認証。

ユーザーOAuthに対応しています

スコープ：ZohoVoice.call.READ

  GET     https://voice.zoho.com/rest/json/zv/logs/voicerecording


クエリーパラメーター

recording_filename *

単一またはカンマ区切りのファイル名
max-len = 10,000

 ダウンロードするファイル名です。

例：recording_filename=1469501_16641882751_1469501.wav,1469501_16641881845_1469501.wav
メモ：ダウンロード上限は10ファイル、ファイルサイズの上限は1GBです。

password

safestring

パスワード設定です。パスワードに値が設定されている場合、Zipファイルがダウンロードされます。

mode

play|download

初期値はdownloadです

zuid

int

組織OAuthを使用する場合は、ユーザーのzuidを渡します。この値は、ユーザーに録音ファイルの表示権限があるかどうかを確認するための条件に設定されます。


バッチ通話履歴の録音およびボイスメールを取得するAPI

このAPIを使用して、録音ファイルまたはボイスメールファイルを取得します。

メモ。

1. ボイスメールファイルと録音ファイルの取得には同じAPIを使用します。各ファイルを取得するには、以下に示す該当キーにブール値を設定します。

2. このURLのしきい値：1分あたり30件の通話、ロック期間は10分です。

3. 最大ダウンロードサイズは50GBです。5GBずつ10個のパートに分けてダウンロードされます。バッチは、sendMailパラメーターが'true'に設定されている場合、ユーザーのメールに送信され、ZohoVoiceの通知センターにも表示されます。

4. 最大ファイル数の上限は10,000ファイルです

認証。

OAuthスコープ：ZohoVoice.call.CREATE


  POST     https://voice.zoho.com/rest/json/zv/logs/recording/batch/download


フォームパラメーター。

fromDate

yyyymmdd HH:MM

開始日時フィルター（例）：2022-09-22 00:00

toDate

yyyymmdd HH:MM

終了日時フィルター（例）：2022-09-28 24:00

agent

単一の値またはカンマ区切りの値 -
onlyNumbers

エージェントに関連する通話ログのフィルター（例）：612000000,612000000

callType

incoming|outgoing|missed|bridged|forward

通話種別フィルターに基づいて通話ログを取得します
メモ：初期値はすべての通話種別です

numberIds

単一の値またはカンマ区切りの値 -
onlyNumbers

この番号に最新情報をお知らせします。

userNumber

onlyNumbers

電話番号と国で絞り込みます。国番号のみを設定するか、国番号を電話番号に追加し、isAllCountryキーをfalseに設定できます。
例：userNumber:44
isAllCountry:false


isAllCountry

真偽値

値がtrueに設定されている場合、国検索なしで通話履歴を取得します。

isVoiceMail

真偽値

値がtrueに設定されている場合、ボイスメールを含む通話履歴を取得します

isRecording

真偽値

値がtrueに設定されている場合、録音を含む通話履歴を取得します

メモ：isVoiceMailとisRecordingがfalseの場合、すべての通話録音が取得されます

password

safestring

パスワードの設定です。パスワードに値がある場合、Zipファイルがダウンロードされます。

departmentId

単一またはコンマ区切りの値-
onlyNumbers

部署に関連付けられた通話履歴のフィルター。例：612000000,612000000

groupIds

単一の値またはコンマ区切りの値-
onlyNumbers

キューに関連付けられた通話ログをフィルターします。例：612000000,61200000

sendMail

真偽値

ZIPファイルのリンクがユーザーのメールアドレスに送信されます

recordingFileNames

単一のファイル名またはコンマ区切りのファイル名

ダウンロードするファイル名。

例：recording_filename=1469501_1664188275111194_1469501.wav,14695095_1664188184571227_14695012.wav