音声認識結果一括取得API

機能

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

基本的には、通話ステータス通知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。転送時も変化しない。複数テナントの情報を扱う場合、重複することがある。

例

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

サンプルコード

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Response

🟢200成功

application/json

Body

conversation

object

必須

status

string

ステータス

必須

成功：complete 失敗：error

tenantId

string

テナントID

必須

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

sessionId

integer

セッションID

必須

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

direction

integer

通話方向

必須

0:着信, 1:発信

connectTime

string

通話開始時刻

必須

ISO8601 形式(GMT)

disconnectTime

string

通話終了時刻

可選

ISO8601 形式(GMT) 通話が完了していない場合は、ブランク

completed

integer

音声認識完了フラグ

必須

通話内の全音声認識の完了状況を示す
0:通話内の全音声認識が未完了
1:通話内の全音声認識が完了

recordList

array [object {10}]

必須

discription

string

説明

可選

失敗の場合、失敗原因を表す任意のメッセージ

例

{
    "conversation": {
        "status": "complete",
        "tenantId": "05053698333",
        "sessionId": 942125,
        "direction": 1,
        "connectTime": "2024-06-21T08:27:34.084Z",
        "disconnectTime": "2024-06-21T08:28:36.930Z",
        "completed": 1,
        "recordList": [
            {
                "recordId": 1,
                "ani": "08075082398",
                "dnis": "05053698333",
                "agentId": "T83330001",
                "agentName": "コムデザイン一郎",
                "skillId": "S01@0368939999",
                "skillName": "着信スキル名１",
                "groupId": "0368509999@0368939999",
                "groupName": "局番スキル名1",
                "sentenceList": [
                    {
                        "sequence": 1,
                        "speakerId": 2,
                        "startTime": "2024-06-21T08:27:38.444Z",
                        "endTime": "2024-06-21T08:27:40.244Z",
                        "text": "私はコムデザイン一郎です"
                    },
                    {
                        "sequence": 2,
                        "speakerId": 1,
                        "startTime": "2024-06-21T08:27:42.264Z",
                        "endTime": "2024-06-21T08:27:44.094Z",
                        "text": "パソコンの調子が悪いです"
                    }
                ]
            },
            {
                "recordId": 2,
                "ani": "08075082398",
                "dnis": "05053698332",
                "agentId": "T83330002",
                "agentName": "コムデザイン二郎",
                "skillId": "S01@0368938888",
                "skillName": "着信スキル名2",
                "groupId": "0368508888@0368938888",
                "groupName": "局番スキル名2",
                "sentenceList": [
                    {
                        "sequence": 1,
                        "speakerId": 2,
                        "startTime": "2024-06-21T08:28:38.444Z",
                        "endTime": "2024-06-21T08:28:40.244Z",
                        "text": "コムデザイン二郎に電話が変りました"
                    },
                    {
                        "sequence": 2,
                        "speakerId": 1,
                        "startTime": "2024-06-21T08:28:42.264Z",
                        "endTime": "2024-06-21T08:28:44.094Z",
                        "text": "まだ、パソコンの調子が悪いです"
                    }
                ]
            }
        ],
        "description": ""
    }
}

🟢200失敗

音声認識結果一括取得API

機能#

エラー#

Requestパラメータ

サンプルコード

Response

機能

エラー