客服系统传递订单/商品信息接口-99客服

客服系统被广泛用于电商平台，当顾客浏览某个商品页面发起咨询时，可通过99客服系统商品接口传递商品信息给客服，这样客服就可以明确知道买家要咨询的是具体哪个商品。效果类似如下：

截图

方法一 开启客服时传递

要实现这种效果，只需要在对应页面里把商品信息数据传递给_kefu.order变量即可，类似如下代码。

<script>
window._kefu = {
    bid: 'X6uAFOVR', // 商家id
    uid: 1666, // 用户ID
    name:'用户名称', // 用户名称
    groupid: 0, // 分组ID
    mini: 1, // 是否开启浮层
    autoOpen: 0, // 是否自动打开（可选）
    icon:'https://www.workerman.net/upload/img/20250613/13684c0415388e.png' // 客服图标(可选)
};

_kefu.order = {
    title: 'Huawei/华为 P40 5G新款手机', // 商品标题
    content: '【当天发/24期分期/送果汁机】Huawei/华为 P40 5G新款手机官方旗舰店p40正品30直降价 pro 5g', // 商品描述
    img: 'https://g-search1.alicdn.com/img/bao/uploaded/i4/imgextra/i1/45646959/O1CN010OYHf821HGsvSDLVh_!!0-saturn_solar.jpg_460x460Q90.jpg', // 商品图片
    url: 'https://g-search1.alicdn.com/img/bao/uploaded/i4/imgextra/i1/45646959/O1CN010OYHf821HGsvSDLVh_!!0-saturn_solar.jpg_460x460Q90.jpg', // 订单url
    price: 5000, // 商品价格
    status: '未支付', // 订单状态，任意字符串
    order: '94759173094712', // 订单号
    datetime: '06-10 10:30' // 订单时间
};

(function(){var w=window,d=document;function l(){var a=d.createElement('script');a.type='text/javascript';a.async=!0;a.charset='utf-8';a.src='https://kefu.99kf.com/static/js/kf.js';var b=d.getElementsByTagName('script')[0];b.parentNode.insertBefore(a,b)}l();})();

</script>

关于如何获取bid相关信息请参考如何快速接入客服系统

这里对应的用户地址是 https://kefu.99kf.com/user?bid=X6uAFOVR&groupid=0&uid=1666

客服系统目前只能传递一个商品信息。数据格式为 title:标题，content:商品介绍(可选参数)，img:商品图片(可选参数)，url:商品页面url地址(可选参数)等参数。

注意：传递商品信息接口只支持js接入，不支持url接入。

方法二 调用后端接口

<?php

// Mock订单数据
$postData = [
    'bid' => 'X6uAFOVR',
    'kf_id' => '1057',
    'uid' => '1666',
    'title' => 'Huawei/华为 P40 5G新款手机',
    'content' => '当天发/24期分期/送果汁机 Huawei/华为 P40 5G新款手机官方旗舰店p40正品30直降价 pro 5g',
    'order' => '202506291268',
    'datetime' => date('m-d H:i'),
    'img' => 'https://g-search1.alicdn.com/img/bao/uploaded/i4/imgextra/i1/45646959/O1CN010OYHf821HGsvSDLVh_!!0-saturn_solar.jpg_460x460Q90.jpg',
    'url' => 'https://g-search1.alicdn.com/img/bao/uploaded/i4/imgextra/i1/45646959/O1CN010OYHf821HGsvSDLVh_!!0-saturn_solar.jpg_460x460Q90.jpg',
    'price' => '3600',
    'status' => '未支付',
];

// cURL初始化
$ch = curl_init();

// 设置cURL选项
curl_setopt($ch, CURLOPT_URL, 'https://kefu.99kf.com/user/message/order');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求并获取响应
$response = curl_exec($ch);
// 关闭cURL
curl_close($ch);