2
软件包:无界面 + UI
15.1+
iOS 版本,Android 需 API 24+
53+
Expo SDK,React Native 需 0.73+
功能
完整的聊天体验,而不只是组件的套壳
网页组件能做的一切,都为原生移动端打造。
AI 聊天 + 实时升级
完整的对话流程,可通过 Socket.IO 自动升级到人工客服,与网页组件一致。
附件和语音消息
通过 useAttachments() 和 useVoiceRecorder() 提供内置的图片/文档选择器和聊天内语音消息。
无界面或现成 UI
使用 @sellwhisper/react-native 的预置界面,或基于无界面的 @sellwhisper/chat-client 构建您自己的 UI。
丰富的操作卡片
潜在客户表单、Cal.com 预约以及 Shopify/WooCommerce 电商卡片均以原生方式渲染。
可定制主题
支持浅色、深色和自动主题,并提供设计令牌和组件覆盖,与您的应用风格一致。
推送通知
用一个 hook 注册 Expo 或 Firebase 推送令牌:usePushNotifications()。
团队为何选择这个渠道
为真正的产品团队打造,而非演示
支撑您网页组件的同一平台,如今进入您的应用。
- 与网页组件共用同一后端、知识库和操作。只需配置一次。
- 无界面客户端不依赖任何 React Native 组件,因此也能在 Node 或浏览器中运行。
- 一切都能平稳降级:可选的原生模块(渐变、图标)真正是可选的。
- 附带可运行的 Expo 示例应用,集成前即可看到实际效果。
在 npm 上发布并进行版本管理
两个软件包都发布真正的 semver 版本并附有变更日志,不是未发布的分支,也不是套壳的 WebView。像其他依赖一样用您的包管理器安装即可。
- @sellwhisper/chat-client
- @sellwhisper/react-native
- 已在 npm 发布
面向开发者
快速开始
import AsyncStorage from "@react-native-async-storage/async-storage";
import { SellWhisperClient } from "@sellwhisper/chat-client";
import { SellWhisperProvider, SellWhisperChatScreen } from "@sellwhisper/react-native";
const client = new SellWhisperClient({
widgetId: "YOUR_WIDGET_ID",
persistence: { adapter: AsyncStorage, keyPrefix: "myapp_" },
});
export default function App() {
return (
<SellWhisperProvider client={client} theme={{ mode: "auto" }}>
<SellWhisperChatScreen showHeader showHistory enableAttachments enableVoiceNotes />
</SellWhisperProvider>
);
}常见问题
常见问题
React Native SDK 是否已在 npm 上发布?
是的。@sellwhisper/chat-client 和 @sellwhisper/react-native 都已在 npm 上发布并进行版本管理。
它支持 Expo 吗?
支持,托管工作流和开发构建均可,需 Expo SDK 53 及以上。
我必须使用 UI 包,还是可以自己构建?
两者皆可。@sellwhisper/chat-client 是不依赖 React Native 的无界面 TypeScript 客户端;@sellwhisper/react-native 在其基础上提供现成的界面、组件和 hooks。
可以在纯 React Native CLI 项目中使用吗?
可以。支持纯 React Native(0.73+),用对应的原生 peer 包替代 Expo 模块即可。

