将虚拟任务助理与聊天 API 平台搭配使用

本页面介绍了如何使用通过 Chat API 平台构建的自定义应用，将虚拟任务辅助整合到对话中。人工客服将聊天会话转接给虚拟任务助理后，虚拟任务助理可以向最终用户传达消息，而人工客服看不到该消息。这样，您就可以自动执行收集敏感信息或执行数据查找等流程，同时保护最终用户的隐私。

虚拟任务助理参与聊天会话的工作流

以下是虚拟任务辅助使用自定义应用参与对话的工作流程：

  1. 人工客服将自定义聊天应用中的聊天会话转接给虚拟任务辅助。

  2. Chat 应用使用 POST 请求将最终用户的消息发送到以下端点。使用基本身份验证进行身份验证。

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

    替换以下内容：

    • YOUR_CCAAS_HOST：您的 Contact Center AI 平台 (CCAI Platform) 主机

    • CHAT_ID：对话 ID

    示例请求

    以下是请求正文的示例：

    {
  "from_user_id": 12345,
  "message": {
    "type": "text",
    "content": "This is my response to the Task VA."
  }
}

  3. 如果系统检测到活跃的虚拟任务助理，则会将消息直接路由到虚拟任务助理。该消息被指定为 server_message 类型，并带有 task_virtual_agent 的可见性值。CCAI Platform 代理适配器使用此值向人工客服隐藏消息。自定义代理接口必须检查公开范围值，并自行应用相同的过滤。如果系统未检测到活跃的虚拟任务辅助，则会将消息路由到会话的当前处理程序，该处理程序可以是人工客服或支持虚拟客服。

  4. 当虚拟任务助理发送响应时，您的 webhook 端点会收到 message_received 事件。此网络钩子载荷在 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."
      }
    }
  }
}

  5. 当虚拟任务助理完成其任务后，会将聊天会话转回给人工客服。