音声認識メッセージ形式

音声認識メッセージの種別は msgType に設定されます

メッセージの Header 項目は制御情報なので無視して下さい

JSON の項目は固定ではなく将来的に増える事があるので、書かれていない項目は無視するようにして下さい

JSON の項目が増えた場合でも、対応出来る作りにして下さい

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  }
  "msgType":"StartRecognize"
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  ...
}

TelStart

回線に呼が接続された事を示します

項目名	データ型	説明
msgType	文字列	TelStart 固定
tenantId	文字列	テナントID
sessionId	整数	呼を識別するID
connectTime	文字列	接続時間（ISO 8601形式例: 2023-01-01T11:22:33.123Z）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_NotifyEvent"
  },
  "msgType":"TelStart",
  "tenantId":"0366726697d",
  "sessionId":35087858,
  "connectTime":"2023-01-01T11:22:33.123Z"
}

TelEnd

回線の呼が切断された事を示します

項目名	データ型	説明
msgType	文字列	TelEnd 固定
tenantId	文字列	テナントID
sessionId	整数	呼を識別するID
disconnectTime	文字列	切断時間（ISO 8601形式：例 "2023-01-01T11:22:33.123Z"）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_NotifyEvent"
  },
  "msgType":"TelEnd",
  "tenantId":"0366726697d",
  "sessionId":35087858,
  "disconnectTime":"2023-01-01T11:22:33.123Z"
}

CallStart

エージェントに呼が接続された事を示します

項目名	データ型	説明
msgType	文字列	CallStart 固定
tenantId	文字列	テナントID
agentId	文字列	エージェントID
sessionId	整数	呼を識別するID
connectTime	文字列	接続時間（ISO 8601形式：例 "2023-01-01T11:22:33.123Z"）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  },
  "msgType":"CallStart",
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  "connectTime":"2023-01-01T11:22:33.123Z"
}

CallEnd

エージェントから呼が離れた事を示します

項目名	データ型	説明
msgType	文字列	CallEnd 固定
tenantId	文字列	テナントID
agentId	文字列	エージェントID
sessionId	整数	呼を識別するID
disconnectTime	文字列	切断時間（ISO 8601形式：例 "2023-01-01T11:22:33.123Z"）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  },
  "msgType":"CallEnd",
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  "disconnectTime":"2023-01-01T11:22:33.123Z"
}

StartRecognize

音声認識が開始された事を示します

項目名	データ型	説明
msgType	文字列	StartRecognize 固定
recognizeId	文字列	音声認識の識別ID（StartRecognize ～ StopRecognize を区別）
tenantId	文字列	テナントID
agentId	文字列	エージェントID
sessionId	整数	呼を識別するID
extension	文字列	内線番号
dnis	文字列	着信番号（発信時は発信元番号）
ani	文字列	発信者番号（発信時は発信先番号）
direction	整数	発着信種別（0: 着信, 1: 発信）
startTime	文字列	音声認識開始時間（ISO 8601形式：例 "2023-01-01T11:22:33.123Z"）
recordCount	整数	CallStart からの StartRecognize の通番（通常、保留ごとに+1）

{
  "Header":
  {
    "sType":"#AsrResultV1"
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  },
  "msgType":"StartRecognize",
  "recognizeId":"RIDBA4B5534EB970002",
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  "extension":"1053",
  "dnis":"0366660715",
  "ani":"0262322088",
  "direction":0,
  "startTime":"2023-01-01T11:22:33.123Z",
  "recordCount":1
}

StopRecognize

音声認識が終了した事を示します

項目名	データ型	説明
msgType	文字列	StopRecognize 固定
recognizeId	文字列	音声認識の識別ID（StartRecognize ～ StopRecognize を区別）
tenantId	文字列	テナントID
agentId	文字列	エージェントID
sessionId	整数	呼を識別するID
duration	浮動小数	通話時間（秒）（StartRecognize ～ StopRecognize の継続時間
stopTime	文字列	終了時間（ISO 8601形式：例 "2023-01-01T11:22:33.123Z"）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  },
  "msgType":"StopRecognize",
  "recognizeId":"RIDBA4B5534EB970002",
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  "duration":76.39,
  "stopTime":"2023-01-01T11:22:33.123Z"
}

RecognizeResult

音声認識結果を示します

項目名	データ型	説明
msgType	文字列	RecognizeResult 固定
recognizeId	文字列	音声認識ID（StartRecognize ～ StopRecognize を識別）
tenantId	文字列	テナントID
agentId	文字列	エージェントID
sessionId	整数	呼を識別するID
status	文字列	Final（確定文）または Partial（中間結果1センテンスのみ）。Final 以外は無視。
data	配列	センテンス情報の配列
data.sequence	整数	センテンスの順序（認識エンジンから出力された順、発話時系列順ではない）
data.speakerId	整数	話者の識別（1: カスタマ側、2: エージェント側）
data.message	文字列	音声認識結果のテキスト
data.audioStart	浮動小数	テキストの音声開始時間（秒）
data.audioLength	浮動小数	テキストの音声長さ（秒）

{
  "Header":
  {
    "sType":"#AsrResultV1",
    "sChannel":"Server:AsrResultV1:05012341234_F123456789"
  },
  "msgType":"RecognizeResult",
  "recognizeId":"RIDBA4B5534EB970002",
  "tenantId":"0366726697d",
  "agentId":"F66971353",
  "sessionId":35087858,
  "status":"Final",
  "data":[
    {"sequence":1,"speakerId":2,"message":"もしもし。",
    "audioStart":0.95,"audioLength":1.2},
    {"sequence":2,"speakerId":1,"message":"お世話になっております。こちらデザイン事務所でございます。",
    "audioStart":3.35,"audioLength":4.68},
    {"sequence":3,"speakerId":2,"message":"相談をしたくて電話したんですけど",
    "audioStart":9.3,"audioLength":2.45}
  ]
}

音声認識メッセージ形式

音声認識メッセージ形式#

TelStart#

TelEnd#

CallStart#

CallEnd#

StartRecognize#

StopRecognize#

RecognizeResult#

音声認識メッセージ形式

TelStart

TelEnd

CallStart

CallEnd

StartRecognize

StopRecognize

RecognizeResult