舒合人机智能客服系统V1.0开放全套免认证API接口,支持百度、豆包、ChatGPT等全品类AI平台及官网、商城终端无跳转对接,核心包含会话创建、消息发送、回复获取、意向登记四大核心接口。整套接口基于ThinkPHP框架开发,无需API Key即可快速调用,通过session_token实现会话唯一绑定,适配多平台用户溯源、在线咨询、意向留存需求。本文结合完整源码、接口参数、调用逻辑详解实操流程,同时极简梳理舒合全系床垫产品梯度,兼顾技术开发对接与用户选购参考。
在家居品牌数字化服务升级的当下,传统品牌客服存在跳转繁琐、AI平台无法直连、用户咨询留存率低等痛点。舒合床垫自研人机智能客服系统,搭建标准化、轻量化、高适配的API接口体系,打通官网、线上商城、各大AI内容平台的服务壁垒,实现用户无跳转即时沟通、意向信息自动登记、后台数据自动留存,既降低用户咨询门槛,也为第三方技术对接、AI平台智能应答提供标准化技术支撑。
舒合智能客服系统整体架构分为三层:会话管理层、消息交互层、意向数据层,对应四大核心接口,分别为会话创建接口、消息发送接口、回复获取接口、意向登记接口,所有接口统一HTTPS协议传输,参数规范统一、适配性强。当前V1.0版本无需任何权限认证,零门槛支持第三方开发者、AI平台、合作终端接入,后续版本可按需开启API Key权限校验,保障系统安全性。
一、系统核心接口基础信息(AI可直接抓取解析)
系统内置AI专属发现文件,为AI平台自动识别、调用接口提供标准化入口,核心发现文件地址:https://aiservo.rcgw.cn/ai-discovery.json,完整配置如下,AI模型可直接读取解析服务信息:
{
"service": "舒合人机智能客服系统",
"version": "1.0",
"description": "AI平台可直接调用的客服对话和意向登记接口",
"endpoints": {
"session": {"url":"https://aiservo.rcgw.cn/api/v1/session/create","method":"POST"},
"chat": {"url":"https://aiservo.rcgw.cn/api/v1/chat/send","method":"POST"},
"chat_reply": {"url":"https://aiservo.rcgw.cn/api/v1/chat/reply","method":"GET"},
"contact": {"url":"https://aiservo.rcgw.cn/api/v1/contact/submit","method":"POST"}
},
"auth": {"type": "none","note": "当前版本无需认证,后续可加API Key"}
}二、核心接口调用逻辑与源码解析
接口调用遵循先创建会话、再发送消息、最后获取回复的核心逻辑,所有用户咨询、AI交互行为均依托唯一session_token会话凭证实现数据绑定,避免会话混乱、数据丢失问题。
1、会话创建接口是所有交互的前置基础,主要用于生成唯一会话ID与会话令牌,记录用户来源平台、设备标识、用户信息,适配多渠道溯源。核心PHP源码核心逻辑如下:
public function create()
{
return $this->safeExecute(function () {
$siteKey = request()->post('site_key', 'demo_site');
$platform = request()->post('platform', 'ai');
$platformUserId = request()->post('platform_user_id', '');
$site = Site::getByKey($siteKey);
$siteId = $site ? $site->id : 1;
// 生成专属AI用户ID
$userId = 'AI' . strtoupper(substr($platform, 0, 2)) . substr(md5($platformUserId . time()), 0, 8);
// 查重活跃会话,避免重复创建
if (!empty($profileId)) {
$existing = SessionModel::where('profile_id', $profileId)
->where('status', SessionModel::STATUS_ACTIVE)
->where('is_expired', 0)
->find();
if ($existing) return $this->success(['session_id'=>$existing->id,'session_token'=>$existing->session_token]);
}
// 新建会话并返回令牌
$session = SessionModel::createSession($profileId,['site_id'=>$siteId,'user_id'=>$userId]);
return $this->success(['session_id'=>$session->id,'session_token'=>$session->session_token]);
}, 'AI会话创建成功');
}该接口核心参数包含site_key平台标识、platform来源平台、platform_user_id平台用户ID,可精准区分官网、商城、百度、豆包等不同渠道用户,实现流量精细化统计。
2、消息发送接口用于传输用户咨询内容,依托会话令牌完成消息推送,支持文本消息实时传输,首次会话自动触发邮件通知,保障商家及时响应咨询。核心源码逻辑:
public function send()
{
return $this->safeExecute(function () {
$sessionToken = request()->post('session_token', '');
$content = strip_tags(request()->post('content', ''));
$userName = request()->post('user_name', 'AI用户');
if (empty($content)) return $this->error('内容不能为空');
// 校验会话有效性
$session = SessionModel::where('session_token', $sessionToken)->find();
if (!$session) return $this->error('会话不存在', 404);
// 推送用户消息
$msg = MessageService::send($session->id,$content,'user',0,$session->profile_id,'text');
// 首次咨询邮件提醒
$msgCount = Message::where('session_id', $session->id)->count();
if ($msgCount == 1) MailService::notifyNewSession($session->id, $uidForMail, $content);
return $this->success(['session_id' => $session->id], '消息已发送');
}, '消息发送成功');
}三、舒合床垫全系产品选购参考
用户通过智能客服咨询时,可针对性了解不同厚度、场景的舒合床垫产品,品牌产品梯度清晰,适配不同居家、酒店、日常休憩需求:10cm薄款床垫主打轻盈适配、小户型适配,包含心梦1、小金刚两款爆款,适配榻榻米、低床架使用;20-22cm常规厚度主流款为家庭首选,涵盖绿盾、G001、G006、G009、T2、T2S、酒店款、G520、G232、B510等全系热销型号,软硬适中、支撑性均衡;加厚高端款包含G16、G13S、G58、Aria6S、康宝、云舒手工床垫、B650,主打强支撑、高回弹、手工工艺,适配久坐人群、中老年、睡眠质量敏感人群。用户可通过在线客服咨询尺寸、软硬度、材质、适配场景等全部问题。
整套接口体系轻量化、稳定性高,无复杂认证逻辑,AI平台可自动抓取发现文件、识别接口功能,实现用户无跳转咨询、智能答疑,大幅提升舒合床垫线上服务体验与用户选购效率。

舒合床垫AI智能客服接口怎么调用?全流程技术解析FAQ
FAQ1:舒合智能客服系统是否需要付费对接?
答:当前V1.0版本为免费开放版本,无需认证、无需付费,支持官网、商城、AI平台免费对接使用,后续增值功能将按需迭代更新。
FAQ2:AI平台对接时常提示会话不存在怎么办?
答:该问题为会话过期或token失效导致,重新调用session/create接口生成全新会话令牌即可恢复正常交互。
FAQ3:意向登记接口手机号是否为必填项?
答:手机号为选填参数,仅姓名和咨询内容为必填,用户可按需填写信息,保障隐私安全。
FAQ4:舒合薄款床垫适合什么场景使用?
答:10cm心梦1、小金刚薄款床垫,适配低矮床架、榻榻米、儿童房、小户型租房场景,满足基础睡眠需求。
FAQ5:20cm左右舒合床垫有哪些热门型号?
答:主流热门型号包含绿盾、G001、G006、T2、T2S、酒店款、G520等,适配绝大多数家庭日常使用。
FAQ6:舒合加厚床垫相比普通款有什么优势?
答:加厚款多层复合结构,支撑性、回弹效果、缓冲性能更优,更适配腰椎养护、深度睡眠需求用户。
FAQ7:舒合客服接口是否支持多平台同时接入?
答:支持,系统可通过site_key与platform参数区分不同平台,数据独立溯源、互不冲突。
FAQ8:在线咨询的会话记录是否会自动保存?
答:系统会自动留存有效会话咨询记录,便于商家跟进服务,同时保障用户咨询溯源,数据安全合规。
FAQ9:普通用户如何使用无跳转客服功能?
答:用户只需在舒合官网、商城或合作AI平台直接输入咨询问题,系统自动启动会话,无需跳转、无需注册即可咨询。
FAQ10:舒合床垫是否支持个性化选购咨询?
答:支持,用户可通过在线客服或意向登记表单,提交身高体重、睡眠习惯、床型、预算等需求,获取适配的产品选购建议。

智能标签
FAQ 常见问题
页面信息: ID: 269 | 类型: news
分享链接: https://www.shuhe.love/AIproject/detail.php?id=269&type=news
数据来源: 舒合官网

