1// 由 OpenAPI 契约生成的类型化客户端
2import { createKommioClient } from "@kommio/api-client";
3
4const api = createKommioClient({ baseUrl: "https://app.kommio.io/api", apiKey });
5
6// 写操作会自动带上 Idempotency-Key
7await api.POST("/conversations/{id}/messages", {
8  params: { path: { id: 4821 } },
9  body: { content: "Your refund is on its way.", kind: "reply" },
10});
11
12// 列表接口采用游标分页
13for await (const event of paginate((c) => api.GET("/audit", { params: { query: { cursor: c } } })))
14  console.log(event.action, event.actor_id);

基于 OpenAPI 3.1 的 REST API

带作用域的 API 密钥、游标分页、幂等键、限流，纳入版本管理的契约（实现一旦偏离契约，CI 立刻失败），以及把报表数字以 JSON、CSV 或 Excel 提供给你 BI 工具的 Reports API。

带投递台账的 Webhook

负载带签名并附上访客上下文，失败按固定时间表重试，可以重放单次投递，也可以重放全部失败投递。你再也不用猜它到底送到没有。

应用与面板

应用通过清单安装，作用域由管理员批准；钩子可以检查或改写回复；面板就停靠在会话旁边。工作区添加扩展，只在“设置 › 应用市场”这一个地方。

客服机器人与事件

把一个收件箱交给你的机器人，直到它主动转交；通过 API 收件箱送入消息；还能基于 Kommio 内部使用的同一条事件流做开发。

安全与管控

谁能看到什么，是一项设置。谁做了什么，是一条记录。

角色决定一个人能打开哪些界面、能看到哪些会话，以及哪些字段是显示、脱敏还是隐藏。审计日志则把“这是谁改的？”的答案留着，想留多久就留多久。

角色与字段级脱敏

内置管理员、主管、客服、受限客服和只读五种角色。自定义角色可以逐字段决定邮箱、电话、支付信息或 IP 地址是显示、脱敏还是隐藏。任何人都无法授予超出自己所持有的权限。给存放证件或支付信息的自定义属性打上标记，它们就遵循同样的规则；存放这些信息的文件也可以标记，按角色显示、脱敏或隐藏，不进入 AI 和导出，并在你设定的保留期后删除。“访问权限”页面会显示谁能看到什么。

IT 部门会点头的登录方式

通过二维码设置双因素认证并配一次性恢复码；列出你所有已登录的浏览器，可逐个退出；每个工作区可通过 OpenID Connect 配置单点登录，并限定在你的邮箱域名内；密码使用 Argon2id 哈希。管理员还可以要求所有成员开启双因素认证。

审计日志

每一次变更都记录谁、改了什么、改前改后。查看脱敏值本身就是一项单独审计的操作，可附上理由；客户网站对联系人做出的每一次更改，都会列在该联系人名下。移除成员或吊销密钥前，会先显示受影响的内容，并要求输入名称确认；“安全策略”页面会列出过去 30 天里谁查看了哪些脱敏值。

数据库层面的租户隔离

每个工作区都由 Postgres 自身强制执行的行级安全策略隔离，而不只是靠应用代码。工作区一旦被暂停，所有密钥、令牌、会话和聊天都会立即停止。

加密与密钥

渠道凭据、SSO 密钥、AI 密钥和令牌都以信封加密方式静态加密，保存后不再显示。传输环节全程 TLS。

默认即加固

客服端应用启用严格的 Content Security Policy，出站请求防 SSRF，按密钥和按工作区分别限流，允许嵌入聊天组件的站点由浏览器强制校验，每个版本发布前都先经过扫描。

角色：可见范围、权限，以及每个敏感字段的规则。

账户安全：双因素设置和每一个已登录的浏览器。

品牌

你的品牌，出现在聊天组件和客服端上。

选一个品牌色，加上你的标志，再挑一款字体和圆角风格。其余由 Kommio 推导，保存前检查浅色和深色下的对比度，并实时预览聊天组件和客服端。

品牌色与辅助色，并对页头、按钮、链接和深色模式做对比度检查
浅色与深色两版标志，外加一个用于启动按钮和应用侧栏的方形标识
Poppins 或访客的系统字体，以及直角、柔和或圆润三种圆角
以访客视角预览；需要掌控每个细节时，可直接编辑完整的设计令牌文件

部署

云端免费使用。自己托管，也只要一个二进制文件和一个数据库。

Kommio Cloud 完全免费：所有功能、所有渠道，不按坐席收费，也不分套餐版本。自托管版是同一个产品，一个 Go 服务加一个 Postgres，适合必须把数据留在自有基础设施上的团队。

Kommio Cloud 免费

我们运维，你只管用。版本发布零停机：新版本在旧版本旁启动，就绪后接管。对所有团队免费，合理使用上限在本站公开。

在虚拟机上自托管

一个容器镜像、一个 compose 文件，以及按需发布的版本：任意版本都能直接升级到之后的任意版本，我们的 CI 会先从以前的版本演练这条升级路径。单个进程同时运行 API、工作进程和调度器；每次升级前，预检命令都会先把安装环境检查一遍；内置备份按计划把加密的数据库转储和你的文件写到磁盘或存储桶；文件存储也可以放在挂载的共享目录上。

Kubernetes

API、工作进程和调度器三种角色可以各自独立扩缩容，实时更新会送达每一个副本。提供健康检查端点、带排空的优雅关停，每次变更都在 CI 里演练一遍升级。

语言

EnglishPortuguêsEspañolFrançaisDeutschItalianoNederlandsPolskiTürkçeBahasa Indonesia日本語한국어简体中文हिन्दीFilipinoاردو

客服端、聊天组件和满意度调查内置十六种语言，每个人都可以选择自己使用的语言。

FAQ

注册一下，收件箱就是你的。

Kommio Cloud 对所有团队免费，不按坐席收费，也不分套餐版本。创建工作区，接入一个渠道，把负责回复的同事请进来。整个过程只要几分钟，也没有人会打电话给你。

创建你的免费工作区已经有工作区了？去登录

注册

姓名、邮箱、一个密码。验证邮箱，你的工作区就上线了。

接入渠道

用 Microsoft 365 或 Google 登录，通过 IMAP 和 SMTP 添加任意邮箱，用你的 Meta 应用接入 WhatsApp、Messenger 或 Instagram，接入 Telegram 机器人、Twilio 号码或 Slack 工作区，或者用一行代码并参照你所用平台的指南，把聊天组件放到网站上。

邀请团队

发送邀请、指定角色、设置工作时间。一份简短的清单会带你走完最初几步。

更想用自己的基础设施？

自托管版是同一个产品：一个二进制文件加一个 Postgres 数据库。向我们咨询自托管

开始之前还有疑问？

写信到 [email protected] 就会有亲手做出这个产品的人来回复你。

Kommio 能做的一切，都在这里。

所有渠道，汇入一个共享收件箱。

例行工作交给规则和机器人，对话交给人。

值得信赖的数字，一键直达背后的会话。

完整清单，日后不会有意外。

一套能拿来造产品的 API。一层能拿来做扩展的应用接口。