音声データ取得API

機能

リクエストされたタイミングで、指定された通話の音声データを返却します

一定期間に多数のリクエストを実施された場合、エラーを返却する可能性があります（概ねリクエスト間隔は、5秒以上としてください）

エラー

存在しないリクエストパラメータ

リクエストパラメータ不足

許可されていないテナントの情報要求

31日以上前の音声データを要求

未完了の通話に対する取得要求

Requestパラメータ

Pathパラメータ

apiVersion

string

必須

APIバージョンを示す文字列

サンプル値:

sourceUuid

string

必須

APIの利用者ごとに発行されるUUID形式の文字列

サンプル値:

d70c9bba-b71f-4021-b68c-0dccb2d99999

Headerパラメータ

Authorization

string

必須

Bearer e0167b81201d415ab0d7ce9081849999 形式のAPIキーを設定する
APIキーは、事前共有する

Request Bodyパラメータapplication/json

tenantId

string

テナントID

必須

CT-e1が発行するテナントID。テナントを一意に特定する

sessionId

integer

セッションID

必須

CTe-1で生成されるテナント単位で通話を識別するID。転送時も変化しない。複数テナントの情報を扱う場合、重複することがある。

recordId

integer

レコードID

必須

保留・転送等で通話が分かれた場合に発番されるID 同一sessionId内で１からシーケンシャルに付与される

例

{
  "tenantId": "05053698341",
  "sessionId": 942125,
  "recordId": 1
}

サンプルコード

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Response

🟢200成功

multipart/form-data

Body

status

string

ステータス

必須

成功：complete 失敗：error

tenantId

string

テナントID

必須

CT-e1が発行するテナントID。テナントを一意に特定する

sessionId

integer

セッションID

必須

CTe-1で生成されるテナント単位で通話を識別するID。転送時も変化しない。複数テナントの情報を扱う場合、重複することがある。

recordId

integer

レコードID

必須

保留・転送等で通話が分かれた場合に発番されるID 同一sessionId内で１からシーケンシャルに付与される

direction

integer

方向

必須

0:着信, 1:発信

ani

string

発信者番号

必須

着信：発信者番号（非通知の場合は、anonymous）
発信：発信先番号

dnis

string

着信番号

必須

着信：着信番号
発信：発信元番号

agentId

string

エージェントID

必須

CT-e1のエージェントID

agentName

string

エージェント名

必須

CT-e1のエージェント名

connectTime

string

通話開始時刻

必須

SO8601 形式(GMT)

disconnectTime

string

通話終了時刻

必須

SO8601 形式(GMT)

例

{
  "status": "complete",
  "tenantId": "05058085500",
  "sessionId": 35087858,
  "recordId": 1,
  "direction": 0,
  "ani": "08075082398",
  "dnis": "05053698333",
  "agentId": "F99971353",
  "agentName": "コムデザイン一郎",
  "connectTime": "2023-01-04T11:22:33.123Z",
  "disconnectTime": "2023-01-04T11:27:13.570Z"
}

🟢200失敗

音声データ取得API

機能#

エラー#

Requestパラメータ

サンプルコード

Response

機能

エラー