チャット API プラットフォームで仮想タスク アシスタントを使用する

このページでは、チャット API プラットフォームを使用して構築されたカスタムアプリを使用して、仮想タスク アシスタントをチャット セッションに組み込む方法について説明します。人間のエージェントがチャット セッションを仮想タスク アシスタントに転送すると、仮想タスク アシスタントは人間のエージェントに表示されることなく、エンドユーザーにメッセージを送信できます。これにより、エンドユーザーのプライバシーを保護しながら、機密情報の収集やデータ検索などのプロセスを自動化できます。

チャット セッションに参加する仮想タスク アシスタントのワークフロー

カスタムアプリを使用してチャット セッションに参加する仮想タスク アシスタントのワークフローは次のとおりです。

  1. 人間のエージェントがカスタム チャットアプリのチャット セッションを仮想タスク アシスタントに転送します。

  2. チャットアプリは、次のエンドポイントに POST リクエストを使用してエンドユーザーのメッセージを送信します。基本認証を使用して認証します。

    https://YOUR_CCAAS_HOST/apps/api/v1/chats/CHAT_ID/message

    次のように置き換えます。

    • YOUR_CCAAS_HOST: Contact Center AI Platform（CCAI Platform）ホスト

    • CHAT_ID: チャット ID

    リクエストの本文

    リクエスト本文の例を次に示します。

    {
  "from_user_id": 12345,
  "message": {
    "type": "text",
    "content": {
      "text": "Example response from an end-user."
    }
  }
}

  3. システムがアクティブな仮想タスク アシスタントを検出すると、メッセージは仮想タスク アシスタントに直接転送されます。メッセージは server_message タイプとして指定され、エンドユーザーのプライバシーを保護するために人間のエージェントには表示されません。システムがアクティブな仮想タスク アシスタントを検出しない場合、メッセージは利用可能な人間のエージェントに転送されます。

  4. 仮想タスク アシスタントがレスポンスを送信すると、Webhook エンドポイントは message_received イベントを受け取ります。この Webhook ペイロードには、仮想タスク アシスタントからのメッセージが server_message プロパティに含まれているため、メッセージを取得するために別の API 呼び出しを行う必要はありません。詳細については、Chat プラットフォーム API ガイドをご覧ください。

    Webhook ペイロードの例

    Webhook ペイロードの例を次に示します。

    {
  "event_type": "message_received",
  "timestamp": "2025-09-25T14:30:00Z",
  "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."
      }
    }
  }
}

  5. 仮想タスク アシスタントがタスクを完了すると、チャット セッションは人間のエージェントに戻されます。