@useairfoil/producer-zendesk

中文文档
0.0.3发布于 2026/11/03TypeScriptES Module构建来源已验证

同步门票,评论,现场历史,度量事件,用户,组织,满意度评级和调查,帮助中心文章和社区帖子,谈话线,并从一个Zendesk帐户命名他们的id列表。它回填每个资源和

中文使用文档
文档目录6 节
  1. 配置
  2. 设置
  3. 数据
  4. 限制
  5. 演示数据
  6. 地方发展

Zendesk生产商

同步门票、评论、字段历史、度量事件、用户、组织、 满意度评级和调查,帮助中心文章和社区帖子, 对话线,以及从一个Zendesk帐户命名他们的id的列表。它 回填每个资源并轮询更改。没有网络钩子。

配置

变量要求默认的
ZENDESK_SUBDOMAIN是无
ZENDESK_CLIENT_ID是无
ZENDESK_CLIENT_SECRET是无

设置

作为管理员,在admin Center下添加OAuth客户端 应用程序和集成b> api b> OAuth客户端:

  • 客户类型:保密。
  • 作用域:留空,或者允许 read.
  • 不需要重定向URL。

使用标识符 ZENDESK_CLIENT_ID 秘密是 ZENDESK_CLIENT_SECRET。使用 acme 用于 acme.zendesk.com; 完整地址 同样适用。

令牌使用创建客户端的管理员的权限。

数据

  • tickets.metrics 保存回复、等待和解析时间。 custom_fields 将字段id映射到值,和 ticket_fields 的名字。
  • ticket_comments 包括内部笔记(public 是假的)。它有 文本,而不是附件文件。
  • 已删除的票据、用户和组织获取 _deleted。恢复了门票 回来了。
  • 组、品牌、票证字段、表单和状态保留已删除的项,因此 旧票仍然有他们的名字。其他的列表,文章,还有 说行。删除组和组织成员get _deleted.
  • ticket_field_history 每个更改的字段有一行。自定义字段使用 他们的ID。
  • satisfaction_ratings 持有传统CSAT评级。新的分数是新的一行。
  • survey_responses 保存CSAT答案。 csat_surveys 给问题命名 和选项。两者都需要新的CSAT,支持专业或套件增长 和了。未回答的调查被跳过。
  • 表保存姓名、电子邮件和票证文本。把他们当作机密对待。

限制

  • 增量导出共享每个帐户每分钟10次呼叫的限制,或30次 使用高音量附加组件。大的注释回填可能很慢。
  • ticket_comments 和 ticket_field_history 每个读取票务事件 出口,所以两者都算在限制之内。
  • 每5分钟对出口进行一次轮询。Zendesk省略了最近的一分钟。
  • 一个私下发表的评论后来被公开 ticket_comments。Zendesk的 事件没有详细信息。重新阅读编辑过的评论或附件。

演示数据

pnpm demo --size 128MiB 在没有Zendesk的情况下写入编造的Zendesk数据 凭证。有关标志和变量,请参阅Connector Kit README 的需求。

每个客户都有带有注释、字段历史、度量事件和 有时是满意度评价和调查反应。前12位顾客也是 带上那12个探员。帐户设置只写一次,不随时间增长 大小:品牌、组和组成员、状态、领域、表单、角色、SLA 政策、营业时间、宏、帮助中心和社区、Talk热线、 CSAT调查,以及40个组织。

地方发展

cd connectors/producer-zendesk
pnpm sandbox

pnpm start 运行托管连接器。它需要Wings和PostgreSQL 中的变量 连接器套件自述.

版本与发布记录

@useairfoil/producer-zendesk 共发布 4 个版本,首次发布于 2026/10/29;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.3latest2026/11/03今天
0.0.22026/10/295 天前
0.0.12026/10/295 天前
0.0.0-stage2026/10/295 天前

关于 @useairfoil/producer-zendesk 的常见问题

@useairfoil/producer-zendesk 是什么?

同步门票,评论,现场历史,度量事件,用户,组织,满意度评级和调查,帮助中心文章和社区帖子,谈话线,并从一个Zendesk帐户命名他们的id列表。它回填每个资源和

如何安装 @useairfoil/producer-zendesk?

在项目目录运行 npm install @useairfoil/producer-zendesk,或使用 pnpm add / yarn add / bun add。

@useairfoil/producer-zendesk 支持 TypeScript 吗?

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

@useairfoil/producer-zendesk 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@useairfoil/producer-zendesk 可以商用吗?

@useairfoil/producer-zendesk 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@useairfoil/producer-zendesk 还在维护吗?

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