文档

把 Ontara 装到网站上、用任何语言回复访客所需的一切。

安装挂件

登录并创建工作区后,打开后台的聊天挂件页,复制安装代码,粘贴到每个页面的 </body> 之前:

<script src="https://你的Ontara地址/w.js" data-site="pk_你的站点密钥" async></script>

挂件只在你登记的域名及其子域名上工作(比如登记 example.com 也包含 shop.example.com)。安装前可以先在后台打开测试页试用。

WordPress

用任意能在页眉或页脚插入脚本的插件(例如 WPCode),粘贴同样的代码即可。

单页应用

在 HTML 模板里加一次就行,前端路由切换后挂件照常工作。

JavaScript 接口

脚本加载后会有一个全局对象:

调用作用
lingly.open()打开聊天窗,比如绑在你自己的“联系我们”按钮上。
lingly.close()关闭聊天窗。

翻译

在团队页设置团队语言。访客用其他语言写的消息会翻译给团队看,点一下就能看原文;你的回复会先翻译成访客的语言再发出。欢迎语和自动回复也会翻译。

翻译开关在自动化页。挂件自身的按钮文字跟随访客浏览器语言(中、英、西、葡、法、德、日、韩、意),也可以固定一种。

AI 回答

  1. 在知识库里添加内容:问答、网页地址或一段文字。
  2. 用同页的试问 AI 看看它会怎么回答。
  3. 在自动化页选择 AI 什么时候回答:只在没人在线时,或者始终先由 AI 回答。

AI 只依据知识库、用访客的语言回答。答不了或访客要求找人时,它会转给团队,并在这个对话里不再回答;团队成员一回复,AI 也会停下。

不在线的时候

团队和角色

角色权限
所有者全部权限,包括账单。
管理员设置、知识库、网站、邀请和账单。
客服回复对话、查看知识库。

在团队页邀请成员,对方用被邀请的邮箱登录即可加入。所有套餐都不限人数。

套餐和额度

各套餐包含的内容见定价。月度额度用完后在线聊天照常工作,AI 回答和翻译暂停到下个月或升级后恢复。超过套餐保留期的对话会自动删除。

访客身份校验

访客在你的网站登录后,可以告诉 Ontara 他们是谁,并且证明这一点,别人就冒充不了你的用户。

  1. 在聊天挂件 → 访客身份校验里开启,复制密钥,只放在你的服务器上。
  2. 在服务器上计算 hex(HMAC-SHA256(密钥, userId))。
  3. 在页面里调用 lingly.identify({ userId, email, name, hash })。

客服会看到访客旁边的已验证标记;hash 不对的调用会被拒绝。只在聊天窗里填邮箱的访客不算已验证。

邮件回复

访客离开后收到你的回复邮件,直接回这封邮件就行,回复会出现在同一个对话里,引用的旧邮件和签名会去掉。

需要一个收信域名:在 Cloudflare Email Routing 里把 r-*@reply.你的域名 转给 Ontara Worker,再设置 INBOUND_EMAIL_DOMAIN=reply.你的域名。只有访客本人的邮箱能往对话里发;自动回复和退信会被忽略。

通知

每个成员可以在账户 → 浏览器通知里给当前设备开启通知。收件箱没开着时有访客发消息,就会弹出通知,点一下打开对话。团队页的邮件提醒照常作为兜底。

React

安装 @lingly/react,在根组件放 <LinglyChat siteKey="pk_..." user={...} />,用 useLingly() 拿到 open、close、identify、reset。用户退出登录(user 变成 null)时挂件会忘掉这个访客。这个包还没发布到 npm,发布前可以直接用上面的 JavaScript 接口,效果一样。

WordPress

  1. 下载插件,在 WordPress 的插件 → 安装插件 → 上传插件里上传。
  2. 启用后打开设置 → Ontara Chat。
  3. 填入站点公钥;可选填访客身份校验密钥,已登录的 WordPress 用户就会显示为已验证。

REST API

在开发者页创建密钥,每个请求都带上 Authorization: Bearer lk_...。接口有:网站列表、对话列表和详情、读消息、以团队身份回复(会自动翻译给访客)、关闭和重开、删除对话、访客详情。每个密钥每分钟最多 120 次请求。完整说明见英文版。

Webhook

在开发者页添加 https 地址并选择事件。每个事件以 JSON POST 过来,请求头 Lingly-Signature: t=时间戳,v1=签名,签名是 hex(HMAC-SHA256(密钥, t + "." + 原始请求体))。返回 2xx 即视为成功,失败会重试约 20 分钟,一直失败的地址会被暂停。同一事件偶尔可能送达两次,用 id 去重。