@dialstack/sdk-react

中文文档
3.10.0发布于 2026/11/10MITTypeScriptESM + CJS近 30 天下载 3725

为DialStack SDK反应组件和钩子——呼叫日志、语音信箱、拨号计划、软电话和上机

中文使用文档
文档目录6 节
  1. 安装
  2. 每个组件一个导入路径
  3. 软手机不需要启动器
  4. 其他一切需要一个
  5. 文档
  6. 许可证

@dialstack/sdk-反应

用于 DialStack SDK 的响应组件和钩子——呼叫日志,语音邮件,呼叫 历史 电话号码 号码订购 AI代理 拨号计划编辑器 软电话和登机.

安装

npm install @dialstack/sdk-js @dialstack/sdk-react react react-dom

其中两个需要解释.

@dialstack/sdk-js 是一个同伴,而不是依赖,同样的方式 @stripe/react-connect-js 端点 @stripe/connect-js: 你同时安装, 而你 给初始者打电话 npm 7+ 自动安装缺失的对等点, 因此在 练习此命令 .

@xyflow/react 也是对等器,但只有拨号计划编辑器需要它。 安装 如果您导入了它 ./dial-plan数字 :

npm install @xyflow/react

它具有不能重复的模块级状态,这就是它为什么解决 复制你的应用程序 而不是复制我们的.

没错 没有 需要导入任意样式表。 部件变成阴影根 带着他们需要的风格.

每个组件一个导入路径

组成部分是: 没有 从软件包根导出。 每一个都有自己的子路径:

import { DialstackComponentsProvider } from '@dialstack/sdk-react';
import { CallLogs } from '@dialstack/sdk-react/call-logs';
import { Voicemails } from '@dialstack/sdk-react/voicemails';

<DialstackComponentsProvider dialstack={dialstack}>
  <CallLogs />
  <Voicemails userId={userId} />
</DialstackComponentsProvider>;
子路径出口
@dialstack/sdk-reactDialstackComponentsProvider, (中文(简体) ), useDialstack, (中文(简体) ), useDialstackComponents, (中文(简体) ), useCreateComponent, (中文(简体) ), useAppearance, (中文(简体) ), useUpdateWithSetter
./call-logsCallLogs
./voicemailsVoicemails
./call-historyCallHistory
./phone-numbersPhoneNumbers
./phone-number-orderingPhoneNumberOrdering
./ai-agentAIAgent, FAQ 预填入帮助
./dial-planDialPlan 类型
./softphoneSoftphoneProvider, (中文(简体) ), Softphone、呼叫钩和UI原始人
./onboardingOnboardingPortal

为什么不是根管. 一个管子再出口 每一个部件 使整个 它后面的模块图形可以从任何单个导入中到达, 因此导入一个薄 包装器拉入了拨号计划编辑器 @xyflow/react, (中文(简体) ), dagre 财务报告和审定财务报表 cmdk 随便 测量: ~144 KB 全部3个,对等: ~58 KB 软音 直接导入的元素包件,单独和为~1.5 KB. sideEffects: false - 代码是真正可以达到的,而不是死的 也不发布每个模块的文件。 拆分切入点是唯一 工作的东西.

每一个子路径都会解决相同的反应上下文,所以你的应用程序生成的提供者是 可见于它所包罗的.

软手机不需要启动器

它是一个独立验证的成分家族 一个短暂的家族 使用 WebSocket 的用户会话代号, 而不是实例客户端的秘密 瑞丝:

import { SoftphoneProvider, Softphone } from '@dialstack/sdk-react/softphone';

<SoftphoneProvider token={userSessionToken}>
  <Softphone />
</SoftphoneProvider>;

没有 loadDialstackAndInitialize,没有 <DialstackComponentsProvider>通过一个 实例是可选的,只允许现场的外观同步。 登记、拨号 呼叫控制继续工作 当 REST API 无法到达,即 深思熟虑.

其他一切需要一个

其余组件读取 REST API,所以需要初始化实例 包括: DialPlan,它使自己的画布而不是网络 组件,但是是包件中实例中最重的消费者.

如果一个组件变成空白,那首先需要检查。 此软件包投出 元素从未注册时已命名出错, 如果 @dialstack/sdk-js 缺少, 或者您的捆绑商放弃了它的副作用导入 .

文档

完整文档: https://docs.dialstack.ai/sdks (中文(简体) )

许可证

麻省理工学院

版本与发布记录

@dialstack/sdk-react 共发布 12 个版本,首次发布于 2026/08/10;过去 12 个月发布了 12 个版本。

版本发布日期距今
3.10.0latest2026/11/102 天前
3.9.02026/11/029 天前
3.8.02026/10/2616 天前
3.7.02026/10/1923 天前
3.6.02026/10/1230 天前
3.5.02026/10/051 个月前

其他发布通道:bootstrap → 2.1.0。

关于 @dialstack/sdk-react 的常见问题

@dialstack/sdk-react 是什么?

为DialStack SDK反应组件和钩子——呼叫日志、语音信箱、拨号计划、软电话和上机

如何安装 @dialstack/sdk-react?

在项目目录运行 npm install @dialstack/sdk-react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18 || ^19)、react-dom(^18 || ^19)、@xyflow/react(^12.0.0)、@dialstack/sdk-js(>=3.10.0 <4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dialstack/sdk-react 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dialstack/sdk-react 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dialstack/sdk-react 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dialstack/sdk-react 可以商用吗?

@dialstack/sdk-react 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dialstack/sdk-react 的下载量有多少?

根据 npm 官方下载统计,@dialstack/sdk-react 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,725 次,日均约 124 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dialstack/sdk-react 还在维护吗?

最新版本 3.10.0 发布于 2026/11/10(2 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/08/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。