商品卡片/订单卡片

客源多 AI 版支持网站访客在咨询时主动发送商品/订单卡片给客服，帮助客服快速了解访客关注的商品或订单需求，从而提升接待效率与转化率。常用于电商详情页咨询、订单售后咨询等场景。

使用前提：本接口面向具备前端开发能力的技术人员，调用前请确保已获取客源多对话链接基础 URL（即含 cptid 参数的链接，cptid 为接待组件 id）。
接口能力概览

参数：cardinfo=卡片JSON字符串

位置：对话链接 URL 查询参数（?cptid=接待组件id&cardinfo=...）

支持类型：商品卡片、订单卡片

参数说明

参数 类型 说明
cardinfo string 商品/订单卡片 JSON 字符串，需先 JSON.stringify 再 encodeURIComponent 编码

商品卡片

字段 类型 说明
title string 商品标题
price string 商品价格（含货币符号）
img string 商品图片链接
url string 商品跳转链接

示例代码

// 商品卡片
var card = {
    title: '商品标题内容',
    price: '￥66666',
    img:   '商品图片链接',
    url:   '商品链接'
};

// 将商品信息编码
var carddata = encodeURIComponent(JSON.stringify(card));

// cardinfo 参数，参数值为商品卡片
http://www.域名.net/chat?cptid=######&cardinfo=carddata

订单卡片

字段 类型 说明
orderid string 订单 ID
title string 商品标题
price string 商品价格（含货币符号）
img string 商品图片链接
url string 商品跳转链接
description string 订单详情 JSON 字符串，由 [{ title, content }] 数组 JSON.stringify 而成

示例代码

// 订单信息
var description = [
    { title: '订单号：',   content: '1232554685455645' },
    { title: '创建时间：', content: '2024-10-31 18:23:15' },
    { title: '商品数量：', content: '1' }
];

// 订单卡片
var order = {
    orderid:      '订单ID',
    title:        '商品标题内容',
    price:        '￥66666',
    img:          '商品图片链接',
    url:          '商品链接',
    description:  JSON.stringify(description)
};

// 将订单卡片编码
var orderdata = encodeURIComponent(JSON.stringify(order));

// cardinfo 参数，参数值为订单卡片
http://www.域名.net/chat?cptid=######&cardinfo=orderdata
相关文档： 如需发送更通用的卡片消息（自定义标题/描述/图片/链接），请参考 对话链接 - 自定义消息，两者结构相近但本接口专为电商商品/订单场景设计。
本篇目录