智能会话助手为您提供了通用API插件，您可以使用对应的API插件来调用通用的API接口，灵活开发并集成智能会话助手的原子能力；同时，在企业微信和自有客服系统的集成场景下，智能会话助手也为您提供了不同的集成方案。

• API插件：通用的API插件能力，可调用API集成调用智能会话助手，详情请参见下文的集成方式1：基于API插件。
• 企微集成：在企业微信中集成智能会话助手能力时，您需要开通企微客服完成相关准备工作配置，详情请参见下文的集成方式2：企微集成。
• 自有客服系统集成：如果您已有客服系统希望集成智能会话助手能力，请参见下文的集成方式3：自有客服系统集成。

• 如果您希望集成智能会话助手能力，可阅读本文了解大致集成能力与流程，在进行集成操作时可联系项目经理进行详细集成方案咨询和集成实施支持。
• 以下集成说明中的示例数据均为mock模拟数据，请勿直接使用。

前提条件

已在智能会话助手页面中创建API应用，并获取API应用相关信息。详情请参见使用实践：客服 / 导购场景。

API插件说明

API 应用请求和返回结构：

• 请求说明：
  请求支持 OpenAI Client 调用，结构和 OpenAI 接口类似，请求 body 示意：

  {
      "messages": [
          {
              "content": "1111",
              "role": "user"
          }
      ],
      "metadata": {
          "id_type": "baseid_1219",
          "id_value": "111111111"
      },
      "stream": true
  }
  

• 返回说明
  返回结构支持结构化返回，其返回接口可以自定义配置，默认返回结构和 OpenAI Client 返回相同，支持流式和非流式两种：

  • 流式示例：

    data: {"choices":[{"delta":{"role":"assistant","content":"好"}}]}
    
      data: {"choices":[{"delta":{"role":"assistant","content":"的"}}]}
    
      ...
    
      data: [DONE]
    

  • 非流式：

    {
        "choices": [
          {
            "message": {
              "role": "assistant",
              "content": "约365.256天。"
            },
          }
        ]
      }
    

API插件列表

客户画像总结

• API介绍：根据客户的标签、属性、行为、明细、会话数据、深入分析并总结客户画像。
• 请求参数：
  • id_value: 客户 id 值
  • id_type_code: 客户 id 类型码
• 返回结果：
  content：无结构画像内容，例如：

  // 内容示例：
  ### 客户画像摘要
  【客户ID】：594593900216197530
  【画像标签】：60后女性、嘻哈风格、高收入、金牌会员、高券敏感度
  【客户价值评级】：高价值客户。判断依据：该客户为金牌会员，有较高的积分余额，且年收入极高，具备较强的消费能力，同时对优惠券敏感度高，有较大的消费潜力。
  【生命周期阶段】：成熟期。该客户已是金牌会员，处于相对稳定的消费阶段。
  
  ### 详细画像分析
  【基础属性】
  - 人口统计特征：女性，年龄在50 - 59岁，属于60后。
  - 地理位置特征：居住省份为四川省，但城市显示为太原（此处可能存在数据误差）。
  - 社会经济特征：年收入高达28463449，经济实力雄厚。
  
  【行为特征】
  - 消费行为模式：由于是金牌会员且积分余额较多，消费频率可能较高。对优惠券敏感度高，说明在消费时可能会比较关注优惠活动，倾向于在有优惠时进行消费。
  - 产品偏好分析：喜欢嘻哈风格的服装，鞋码在38 - 40，衣服尺寸偏好XXL及以上。
  - 渠道互动习惯：暂未获取到相关数据，无法准确判断线上/线下渠道偏好、设备使用习惯和应用使用频率。
  - 服务需求特点：可能希望获得与金牌会员身份相匹配的优质服务，如专属的优惠活动、优先的售后服务等。
  
  【心理特征】
  - 消费动机分析：可能兼具情感型和自我实现型。选择嘻哈风格的服装，可能是出于对这种风格的喜爱和情感认同，同时也通过穿着展现自己独特的个性，实现自我表达。
  - 决策风格推断：由于对优惠券敏感度高，可能在消费决策时会比较理性，会综合考虑价格因素。
  - 价值观取向：可能更注重性价比，在追求自己喜欢风格的同时，也希望能获得价格上的优惠。
  
  【关系网络】
  - 社交影响力：暂未获取到相关数据，无法判断是意见领袖、跟随者还是独立型。
  - 家庭决策角色：暂未获取到相关数据，无法判断是决策者、影响者、使用者还是付款者。
  - 社群归属：暂未获取到相关数据，无法判断属于兴趣社群、专业社群还是地域社群。
  
  ### 营销建议
  【个性化营销策略】
  - 产品推荐：推荐嘻哈风格的服装，包括不同款式、材质的XXL及以上尺寸的衣服，以及38 - 40码的鞋子。
  - 价格策略：提供专属的优惠券、折扣活动，如满减券、会员日折扣等，满足其对价格优惠的需求。
  - 沟通渠道：可以通过短信、会员专属APP推送等方式与客户保持沟通。
  - 促销方式：举办会员专属的促销活动，如限时抢购、积分兑换等。
  
  【客户发展建议】
  - 短期互动策略：定期向客户推送嘻哈风格的新品信息和优惠活动，邀请客户参加线下的时尚活动。
  - 长期关系维护：为客户提供个性化的服务，如专属的时尚顾问、生日惊喜等，增强客户的忠诚度。
  - 潜在风险预警：关注客户的消费频率和金额变化，如果出现明显下降，及时了解原因并采取相应的措施。 
  

客户情绪识别

• API介绍：检测话术中的潜在风险，比如合规性、情感冲突、法律问题等。
• 请求参数：
  • id_value: 客户 id 值
  • id_type_code: 客户 id 类型码（例如系统 base_id，phone_id ）
  • messages: 会话记录
• 返回结果：
  结构化示例：

  {
    "attitude": "友好、礼貌",
    "reason": "用户发送了‘你好呀’，这是常见的友好问候语，体现出用户以友好、礼貌的态度开启交流。"
  }
  

导购/客服计划生成

• API介绍：全流程的规划和个性化服务，包括客户分层、需求分析、触点规划、目标设定等。
• 请求参数：
  • id_value: 客户 id 值
  • id_type_code: 客户 id 类型码（例如系统 base_id，phone_id ）
  • messages: 会话记录
• 返回结果：
  返回无结构示例：

  # 智能音箱客户服务流程
  
  ## 1. 了解客户诉求
  **目标**：深度挖掘客户对智能音箱的真实需求和潜在关注点。
  
  **具体操作方法**：
  -  通过客户对产品性能、音质和智能控制的提问，结合客户画像判断其为首次购买智能音箱的科技爱好者。
  -  询问客户对智能设备兼容性的具体需求及使用场景。
  
  **注意事项**：
  -  避免过早推销产品，确保充分理解客户需求，建立信任感。
  
  ## 2. 分析问题并制定解决方案
  
  ## 3. 推荐解决方案
  
  ## 4. 处理反馈
  
  ## 5. 协助方案执行
  
  ## 6. 完成服务
  
  ## 7. 送别客户
  

知识查询

• API介绍：根据问题，实时查询匹配的结果。
• 请求参数：
  • query: 查询内容
• 返回结果：
  返回无结构示例（提问为： 某某集团是怎样的一家公司？它主要有哪些品牌和业务范围？）：

  某某集团是全球知名的家电制造商，旗下拥有xx家电、xxx家电等品牌。公司致力于提供高品质、设计卓越且性能出众的家用电器产品，服务全球市场。某某集团在中国市场也有广泛布局，推动智能家居和便捷生活解决方案的发展。
  

话术推荐

• API介绍：基于客户历史数据、当前需求等因素，生成合适的沟通语言，目的是提升沟通效果。
• 请求参数：
  • id_value: 客户 id 值
  • id_type_code: 客户 id 类型码（例如系统 base_id，phone_id ）
  • messages: 会话记录
• 返回结果：
  生成三条话术

  - 您好，很高兴为您服务！您先别着急，跟我详细说说遇到什么问题了呢？如果之后还有其他问题，随时可以跟我说。
  - 您好呀！请您把遇到的问题跟我讲一下，我来帮您解决。要是后续还有疑问，随时联系我就行。
  - 您好，很乐意为您服务！麻烦您描述一下遇到的问题，我会尽力帮您处理。若还有别的问题，随时都能问我。
  

商品服务推荐

• API介绍：根据客户画像+上下文进行实时推荐。
• 请求参数：
  • id_value: 客户 id 值
  • id_type_code: 客户 id 类型码（例如系统 base_id，phone_id ）
  • messages: 会话记录
• 返回结果：
  返回结构化信息，例如：

  [
    {
      "rank": 1,
      "item_id": "CS1T5MAG4W.goods",
      "item_type": "线上商品",
      "item_name": "【***】iQ500 触启款嵌入式,58升蒸烤一体机CS1T5****",
      "item_text": "****** 【***】iQ500 触启款嵌入式,58升蒸烤一体机CS1T5**** 颜色：黑色 功率：2900 瓦 尺寸：455x595x548 毫米 产品尺寸（高x宽x深）：455x595x548 毫米 清洁模式：无 Steam technology：蒸制 传感器：无",
      "score": 88.6457748413086,
      "item_cate1": "家电大类",
      "item_cate2": "蒸烤一体机",
      "price": 6965.27,
      "brand": "******",
      "reasons": [],
      "url_image": "",
      "url_landing": "",
      "resp_content": "您好！看到您想选购嵌入式蒸烤一体机，我为您推荐这款iQ500***蒸烤一体机。这款58升大容量的嵌入式蒸烤一体机采用触控操作，功率2900瓦，尺寸455x595x548毫米，非常适合家庭使用。它集成了蒸烤功能，能满足您日常烹饪的各种需求。请问您的厨房预留空间和预算大概是多少呢？这样我可以为您推荐更合适的产品。"
    },
    {
      "rank": 2,
      "item_id": "CSA58****.goods",
      "item_type": "线上商品",
      "item_name": "【******】45升大容量嵌入式蒸烤一体机",
      "item_text": "****** 【******】45升大容量嵌入式蒸烤一体机 颜色：不锈钢 功率：2900 瓦 尺寸：455x595x548 毫米 产品尺寸（高x宽x深）：455x595x548 毫米 清洁模式：无 Steam technology：蒸制 传感器：无",
      "score": 88.2789077758789,
      "item_cate1": "家电大类",
      "item_cate2": "蒸烤一体机",
      "price": 3890.0,
      "brand": "******",
      "reasons": [],
      "url_image": "",
      "url_landing": "",
      "resp_content": "您好，很高兴为您推荐嵌入式蒸烤一体机。我注意到您关注了该品牌，不过今天想特别为您推荐一款明星产品：【******】45升大容量嵌入式蒸烤一体机。这款产品采用专业蒸汽技术，2900W大功率，尺寸为455x595x548毫米，非常适合家庭使用。不锈钢外观也很百搭，现在特价3890元。请问您厨房预留的空间尺寸是多少呢？这样我可以帮您确认是否合适安装。"
    },
    {
      "rank": 3,
      "item_id": "CP269A****.goods",
      "item_type": "线上商品",
      "item_name": "【******】36升嵌入式智能微蒸烤一体机CP269A****",
      "item_text": "****** 【******】36升嵌入式智能微蒸烤一体机CP269A**** 颜色：不锈钢 容积：36 升 功率：3200 瓦 尺寸：455x594x545 毫米 安装位置：下嵌式 产品尺寸（高x宽x深）：455x594x545 毫米 Microwave power levels：90, 180, 360, 600, 1000 瓦 清洁模式：无",
      "score": 87.98370361328125,
      "item_cate1": "家电大类",
      "item_cate2": "蒸烤一体机",
      "price": 5722.17,
      "brand": "******",
      "reasons": [],
      "url_image": "",
      "url_landing": "",
      "resp_content": "您好！看到您想选购嵌入式蒸烤一体机，我为您推荐这款36升智能微蒸烤一体机CP269A****。它采用******技术，3200瓦大功率，支持多档微波调节(90-1000瓦)，不锈钢材质，尺寸为455x594x545毫米，非常适合下嵌式安装。目前售价5722.17元。想请问您厨房预留的安装空间尺寸是多少呢？还有您的预算范围大概是多少？这样我可以为您推荐更合适的产品。"
    }
  ]
  

准备工作

1. 需开通【企微客服】。

   

2. 注册应用 & 赋予应用API调用。

   

3. 客服账号托管，将客服账号托管给应用。

   

4. 设置应用页面。

   

5. 配置企微工具栏，指向应用。

   

集成会话助手能力

• H5页面集成企微

  • 初始化参数

    • ww初始化callback

  • 实例方法

    字段	能力
    getUserProfile()	获取用户画像
    getEventAndDetail()	获取用户行为 & 明细
    getEmotion(messages: string[])	客户情绪识别
    queryKnowledgeBase(query: string)	根据问题召回知识
    genMessage(messages: string[])	根据问题生成话术建议
    recommendProduct(messages: string[])	根据问题生成商品推荐

• API调用说明（自行开发H5的话可参见上文的集成方式1：基于API插件。）

后续对接与数据回传

1. 人工客服对接，接入用户，工具栏可以打开企微助手。

   
   

2. 企微会话回传CDP。

   • 开通企微会话存档：https://developer.work.weixin.qq.com/document/path/91360

   • 通过CDP数据接入企微会话数据。

     

   • 填写公钥，点击授权。

   
   
   

自有客服系统集成分为两类：

• 一类是仅集成API原子能力：可参见上文集成方式1：基于API插件。
• 另一类是直接集成会话助手Agent demo（将智能会话助手视作模型调用）。

前提条件

自有客服系统需支持能力

• 原子能力的配置：具有集成api原子能力。
• 上下文管理能力：将用户和客服，交流的内容作为上下文，按照给定结构传递至智能会话助手。
• 客户id转换能力：将自有客服系统中的用户身份，转换为CDP中可见id的能力。

API调用说明

主要包含接口调用和消息解析两部分，V1为当前版本。

curl --location 'http://****/profile_platform/api/v2/sse/agent/chat/completion' \
--header 'Content-Type: application/json' \
--data '
{
    "model": "MA_GUIDE_AGENT_V3",
    "messages": [
        {
            "role": "user",
            "content": "我的预算是5000，有啥线下的微波炉推荐吗？"
        }
    ],
    "stream": true,
    "user": "****-conversionid-****",
    "metadata": {
        "user_id": "576462951326679241",
        "id_type": "baseid",
        "tenant_id": "1"
    }
}'

后续步骤：客服会话回传CDP

直接通过智能体自动对话数据回传CDP，无需您手动配置。