このページでは、Chat API プラットフォームを使用して構築されたカスタムアプリを使用して、仮想タスク支援（機能）をチャット セッションに組み込む方法について説明します。人間のエージェントがチャット セッションを仮想タスク支援（機能）に転送すると、仮想タスク支援（機能）は人間のエージェントに表示されることなく、エンドユーザーにメッセージを送信できます。これにより、エンドユーザーのプライバシーを保護しながら、機密情報の収集やデータ検索などのプロセスを自動化できます。
チャット セッションに参加する仮想タスク支援（機能）アシスタントのワークフロー
カスタムアプリを使用してチャット セッションに参加する仮想タスク支援（機能）のワークフローは次のとおりです。
- 人間のエージェントが、カスタム チャットアプリのチャット セッションを仮想タスク支援（機能）に転送します。
チャットアプリは、
POSTリクエストを使用して、次のエンドポイントにエンドユーザーのメッセージを送信します。基本認証を使用して認証します。https://YOUR_CCAAS_HOST/apps/api/v1/chats/CHAT_ID/message次のように置き換えます。
YOUR_CCAAS_HOST: コンタクト センター AI プラットフォーム（CCAI プラットフォーム）ホストCHAT_ID: チャット ID
リクエストの例
リクエスト本文の例を次に示します。
{ "from_user_id": 12345, "message": { "type": "text", "content": "This is my response to the Task VA." } }アクティブな仮想タスク アシスタントが検出されると、メッセージは仮想タスク アシスタントに直接ルーティングされます。メッセージは
server_messageタイプとして指定され、task_virtual_agentの可視性値を持ちます。CCAI Platform エージェント アダプタは、この値を使用して人間のエージェントにメッセージを非表示にします。カスタム エージェント インターフェースは、可視性の値を確認し、同じフィルタリングを適用する必要があります。システムがアクティブな仮想タスク支援（機能）を検出しない場合、メッセージはセッションの現在のハンドラ（人間のエージェントまたはサポート仮想エージェント）にルーティングされます。仮想タスク アシスタントがレスポンスを送信すると、Webhook エンドポイントは
message_receivedイベントを受信します。この Webhook ペイロードには、server_messageプロパティに仮想タスク支援（機能）からのメッセージが含まれているため、メッセージを取得するために別の API 呼び出しを行う必要はありません。詳細については、Chat プラットフォーム API ガイドをご覧ください。Webhook ペイロードの例
Webhook ペイロードの例を次に示します。
{ "event_type": "message_received", "timestamp": "2025-09-25 14:30:00 UTC", "chat_id": 37, "body": { "sender": { "id": 71, "type": "task_virtual_agent", "status": "connected" }, "message": { "type": "server_message", "message_id": 1, "visibility": "task_virtual_agent" }, "server_message": { "content": { "type": "text", "content": "Thank you. Please enter the 6-digit code sent to your device." } } } }仮想タスク アシスタントはタスクを完了すると、チャット セッションを人間のエージェントに戻します。