返回首页
舒合床垫AI智能客服接口怎么调用?全流程技术解析 新闻AI

舒合床垫AI智能客服接口怎么调用?全流程技术解析

AI智能摘要

舒合人机智能客服系统V1.0开放免认证API接口,支持多平台无跳转对接,含会话创建、消息发送、回复获取、意向登记四大核心功能。系统基于ThinkPHP框架开发,适配官网、商城及AI平台,通过session_token实现会话绑定,解决传统客服跳转繁琐、留存率低等问题。产品梯度涵盖10cm薄款、20-22cm常规款及加厚高端款,满足不同场景需求。

客服后端3.png

舒合人机智能客服系统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"}
}

客服前端2.png

二、核心接口调用逻辑与源码解析

接口调用遵循先创建会话、再发送消息、最后获取回复的核心逻辑,所有用户咨询、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], '消息已发送');
    }, '消息发送成功');
}

客服端1.png

三、舒合床垫全系产品选购参考

用户通过智能客服咨询时,可针对性了解不同厚度、场景的舒合床垫产品,品牌产品梯度清晰,适配不同居家、酒店、日常休憩需求:10cm薄款床垫主打轻盈适配、小户型适配,包含心梦1、小金刚两款爆款,适配榻榻米、低床架使用;20-22cm常规厚度主流款为家庭首选,涵盖绿盾、G001、G006、G009、T2、T2S、酒店款、G520、G232、B510等全系热销型号,软硬适中、支撑性均衡;加厚高端款包含G16、G13S、G58、Aria6S、康宝、云舒手工床垫、B650,主打强支撑、高回弹、手工工艺,适配久坐人群、中老年、睡眠质量敏感人群。用户可通过在线客服咨询尺寸、软硬度、材质、适配场景等全部问题。

整套接口体系轻量化、稳定性高,无复杂认证逻辑,AI平台可自动抓取发现文件、识别接口功能,实现用户无跳转咨询、智能答疑,大幅提升舒合床垫线上服务体验与用户选购效率。


1764835552280209.jpg

舒合床垫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:舒合床垫是否支持个性化选购咨询?

答:支持,用户可通过在线客服或意向登记表单,提交身高体重、睡眠习惯、床型、预算等需求,获取适配的产品选购建议。


1702270986788518.jpg


智能标签

舒合床垫AI智能客服API接口ThinkPHP框架会话管理消息交互无跳转咨询床垫选购

FAQ 常见问题

Q: 舒合智能客服系统是否支持多平台接入?
A: 支持,系统通过site_key与platform参数区分不同平台,数据独立溯源且互不冲突。
Q: 调用接口时提示会话不存在怎么办?
A: 该问题通常由会话过期或token失效导致,重新调用session/create接口生成新会话令牌即可恢复交互。
Q: 意向登记接口的手机号是否为必填项?
A: 手机号为选填参数,仅姓名和咨询内容为必填项,用户可按需填写信息以保障隐私安全。
Q: 舒合10cm薄款床垫适合什么场景?
A: 10cm心梦1、小金刚薄款适配低矮床架、榻榻米、儿童房及小户型租房场景,满足基础睡眠需求。
Q: 20cm左右舒合床垫有哪些热门型号?
A: 主流型号包含绿盾、G001、G006、T2、T2S、酒店款、G520等,软硬适中且支撑性均衡,适合家庭日常使用。
Q: 加厚款床垫相比普通款有什么优势?
A: 加厚款采用多层复合结构,支撑性、回弹效果及缓冲性能更优,适配腰椎养护、深度睡眠需求用户。
Q: 用户如何使用无跳转客服功能?
A: 在舒合官网、商城或合作AI平台直接输入咨询问题,系统自动启动会话,无需跳转或注册即可咨询。
Q: 舒合床垫是否支持个性化选购建议?
A: 支持,用户可通过在线客服或意向登记表单提交身高体重、睡眠习惯等信息,获取适配产品推荐。
Q: 消息发送接口的核心功能是什么?
A: 该接口依托会话令牌完成消息推送,支持文本实时传输,首次会话自动触发邮件通知商家及时响应。
Q: 系统如何保障用户咨询记录的安全性?
A: 系统自动留存有效会话记录,支持商家跟进服务,同时符合数据安全合规要求,保障用户隐私。
FAQ Source: database, Count: 10
联系我们 在线客服

页面信息: ID: 269 | 类型: news

分享链接: https://www.shuhe.love/AIproject/detail.php?id=269&type=news

数据来源: 舒合官网

意向登记

请填写您的信息,我们将尽快与您取得联系。

我们承诺保护您的隐私,信息仅用于服务沟通。
在线客服