電話を受ける
着信した xAssist コールを受け入れる。
識別子:accept_call
例
<accept_call id="myaction"/>
データソース・タスク・ステータスの更新
データソースタスクのステータスを更新する。
識別子:update_datasource_task_status
エレメント
- datasource_task_id:フェッチすべきタスクのIDを含む。これはデータソースの設定で識別子として設定されたカラムの値である。
- ステータス:タスクの現在のステージ (
DONE
、CANCELED
、PAUSED
、IN_PROGRESS
など)。 - connection_timeout:ミリ秒単位のタイムアウト値。
出力
このイベントのイベント・タグはupdate_datasource_task_status
です。
- OK:データソースタスクが正常に取得されました。
- ERROR: タスクのフェッチ中にエラーが発生しました。サーバーがエラーメッセージを提供する場合、それはペイロードの中にある。ペイロードは次のような構造になっている。
- エラーメッセージ
- エラークラス
- エラーカテゴリ
- エラーコード
- TIMEOUT:サーバーが指定された時間内に応答を送信しなかった
(connection_timeout)
例
この例では、データソース入力と組み合わせて使用できることを示している:
<update_datasource_task_status id="cancel_ds_task">
<param name="datasource_task_id" type="string">?{context.ds_§{ replace validation.datasource.value.id '-' '' }§_task.id}?</param>
<param name="status" type="string">CANCELED</param>
<param name="connection_timeout" type="string">10000</param>
</update_datasource_task_status>
通話メニュー
xAssist 通話中にメニューを開きます。
識別子:call_menu
例
<call_menu id="myaction"/>
ストリーム量の変化
通話中のストリーム音量を調整します。
識別子:change_stream_volume
例
<change_stream_volume id="myaction"/>
連絡先を選択リストに変換
連絡先のセットを選択可能なリストに変換します。
識別子:convert_contacts_to_selection_list
出力
- contacts_converted:アクションは正常に完了しました。
- BUSY_CONTACT_ID:コンタクトは現在使用中です。
例
<convert_contacts_to_selection_list id="myaction"/>
着信拒否
着信した xAssist コールを拒否する。
識別子:reject_call
例
<reject_call id="myaction"/>
通話開始
xAssistコールを開始する。
識別子:start_call
例
<start_call id="stopcall"/>
ストップ・コール
進行中の xAssist コールを停止する。
識別子:stop_call
例
<stop_call id="stopcall"/>
トグル・ストリーム
xAssist 通話中のビデオおよびオーディオストリームのオン/オフを切り替えます。
識別子:toggle_stream
例
<toggle_stream id="myaction"/>
写真を撮る
xAssist 通話中に写真を撮る。
識別子:xassist_take_picture
例
<xassist_take_picture id="myaction"></xassist_take_picture>
トリガーオートフォーカス
xAssist 通話中のオートフォーカス機能のオン/オフを切り替えます。
識別子:trigger_auto_focus
例
<trigger_auto_focus id="focus"/>
ワークフローのメタデータ
タスクの実行中に xAssist 呼び出しが行われると、事前に定義された情報がチャットで共有されます。データ形式はテキストメッセージ、画像、ファイルです。
識別子:call_metadata
属性
ここでは、利用可能な属性について説明する:
- delete_after: 1回のコール開始後にメタデータを削除する。
- replace:前のデータを拡張する代わりに削除します。
エレメント
各要素は以下の通り:
例
<call_metadata id="call_metadata" delete_after="false" replace="true">
<list name="data" listType="UNNAMED" defaultElemType="string">
<elem>Hey</elem>
<elem>#{xassist::activated}</elem>
<elem>xai:/xassist_pictures/ceggert_hmd_2023-03-03_17-35-01_highres-pic.jpg?version=1</elem>
</list>
</call_metadata>