AIオペレータ・メッセージの通知

AIオペレータ と 通話相手先 との会話において、AIオペレータが発話した際に、commubo から呼び出されます。

発話内容 (メッセージ) を通知するのみで、コールバックに対する応答に関わらず、commubo はその通話の処理を継続します。
コールバックAPI は「commubo connect ご契約ユーザーさま ダッシュボード・ページ」内の 「AIオペレータ管理 / 会話シナリオ」メニューから登録できます。

リクエスト

POST <お客様アプリケーションのAPIエンドポイントのURL>
リクエスト・ヘッダ
Content-type

stringrequired

"application/json" が指定されます。
リクエスト・ボディ
AIオペレータの発話内容 (メッセージ) のオブジェクトが送られます。
{
    "callId": "1234567890123456",
    "seq": "1",
    "messageType": "0",
    "operator": {
        "operatorId": "11112222-3333-4444-5555-6666777788889999"
    },
    "nodeName": "hijklmn",
    "nodeType": "opqrstu",
    "checkPoint": "abcdefg",
    "startMsec": "123",
    "endMsec": "456",
    "text": "よろしくお願いします",
    "dictation": "よろしくおねがいします"
}
callId

string

個々の通話を識別するコールID。
seq

integer

発話の順序を示すシーケンス番号 (1 から始まる番号)。
messageType

integer

発話者の種別を、次の値により示します。
0
AIオペレータの発話。
1
通話相手先 (人) の発話。
operator

object

発話したAIオペレータのオブジェクト。
operatorId

string

AIオペレータのID。
個々のAIオペレータを識別するIDです。
nodeName

string

会話の位置を示す、会話シナリオ中のノード名。
会話シナリオの対応する位置にノード名が存在しない場合には、このオブジェクトの内容は含まれません。
nodeType

string

発話の種別を示す、会話シナリオ中のノードタイプ。
会話シナリオの対応する位置にノードタイプが存在しない場合には、このオブジェクトの内容は含まれません。
checkPoint

string

会話の到達位置を示す、会話シナリオ上のチェックポイント。
会話シナリオの対応する位置にチェックポイントが存在しない場合には、このオブジェクトの内容は含まれません。
startMsec

integer

発話の開始時間を示す、通話開始からの時間 (ミリ秒)。
startMsec と endMsec は同じ値になる場合があります。
endMsec

integer

発話の終了時間を示す、通話開始からの時間 (ミリ秒)。
startMsec と endMsec は同じ値になる場合があります。
text

string

発話内容のテキスト。
dictation

string

発話内容の text を補足する、聞き取り文などのテキスト。

レスポンス

200 OK
メッセージの通知に対して応答します。
レスポンス・ヘッダ
レスポンス・ヘッダは必要ありません。
レスポンス・ボディ
レスポンス・ボディは必要ありません。