SIPREC セッションのプログラミング

SIPREC セッションがアクティブな場合、SIPREC セッションのオーディオ・ストリームを制御するように Voice Gateway デプロイメントまたは Watson Assistant インスタンスをプログラミングできます。

Watson Assistant によって送信されるアクション

一部のアクション・タグに participants パラメーターを使用して、アクションを適用するオーディオ・ストリームを指定することができます。

participants パラメーターは、アクションが適用される参加者のコンマ区切りリストです。 participants リストが提供されない場合、アクションはすべての参加者または SIPREC ストリームに適用されます。

以下のコード例は、john@example.com の DTMF 収集セッションを一時停止するために、Watson Assistant がアクション・コマンドを Voice Gateway に渡しているのを示しています。

{
  "command": "vgwActPauseDTMF",
  "parameters": {
    "participants": ["john@example.com"]
  }
}

SIPREC セッション中に以下のアクション・コマンドを使用して、エージェント・アシスタントによる通話の処理方法を定義できます。

表 1. SIPREC セッション中に Watson Assistant から開始できるアクション。
アクションのコマンド 説明 パラメーター
vgwActPauseSTT vgwActUnPauseSTT アクションによって再び有効にされるまで、speech-to-text の処理を一時停止します。 録音が有効になっていて、speech-to-text の処理が一時停止している場合、発信者からの音声は取り込まれません。 アクション・タグを参照してください。 participants
vgwActUnPauseSTT vgwActPauseSTT アクションによって前に一時停止された speech-to-text 処理を再開します。 アクション・タグを参照してください。 participants
vgwActPauseDTMF DTMF 入力を無効にします。 vgwActUnPauseDTMF アクションによって再び有効にされるまで、すべての DTMF 入力が無視されます。 アクション・タグを参照してください。 participants
vgwActUnPauseDTMF vgwActPauseDTMF アクションによって無効にされた DTMF 入力を再び有効にします。 アクション・タグを参照してください。 participants
vgwActSetSTTConfig Voice Gateway が Watson Speech to Text サービスに渡すパラメーターのセットを適用します。 アクション・タグを参照してください。 participants
vgwActHangup 通話を終了します。 アクション・タグを参照してください。 N/A

SIPREC セッション中のダイナミック・プログラミング

re-INVITE または UPDATE が到着すると、Voice Gateway はメディアの機能または SIPREC セッションの変更を Watson Assistant サービスに通知します。 Voice Gateway は、vgwMediaCapsChanged テキストを送信して、Watson Assistant サービスへの turn を開始します。

re-INVITE または UPDATE のメッセージの結果として SIPREC セッション詳細が変更されると、各状態変数が更新されます。