更新记录

1.0.0（2026-05-08） 下载此版本

• 首次发布 Supportly UniApp AI 客服 SDK
• 支持基于 Cloudflare 的免费自部署客服方案
• 支持 RAG 知识库智能问答
• 支持 HTTP 消息发送、WebSocket 实时接收、历史同步和断线重连

平台兼容性

uni-app(3.7.7)

UniApp-SDK

Supportly UniApp SDK 是一个纯 JS 的 Headless 客服聊天 SDK。

发送消息：HTTP POST
接收新消息：WebSocket
历史消息：HTTP GET
断线补偿：HTTP GET after=lastMessageId
本地会话：uni storage

插件目录

uni_modules/supportly-ai-chat

使用

import {
  initSupportly,
  connectSupportly,
  closeSupportly,
  sendSupportlyText,
  onSupportlyMessage,
  onSupportlyStatus,
} from "@/uni_modules/supportly-ai-chat";

onSupportlyMessage((message) => {
  console.log("message", message);
});

onSupportlyStatus((status) => {
  console.log("status", status);
});

await initSupportly({
  apiBaseUrl: "https://api.example.com",
  wsBaseUrl: "wss://api.example.com",
  channelAccountId: "ch_xxx",
  visitorId: "user_123",
  pageUrl: "app://support",
  pageTitle: "在线客服",
});

connectSupportly();

await sendSupportlyText({
  content: "你好",
  clientMessageId: null,
});

closeSupportly();

API

initSupportly(config)
connectSupportly()
closeSupportly()
sendSupportlyText({ content, clientMessageId })
loadSupportlyMessages(afterMessageId)
onSupportlyMessage(callback)
onSupportlyStatus(callback)

平台注意事项

H5:
  生产环境使用 https:// 和 wss://。

App:
  使用 uni.request / uni.connectSocket / uni storage。

小程序:
  需要配置合法 request 域名和 socket 域名。