文档
把 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 回答
- 在知识库里添加内容:问答、网页地址或一段文字。
- 用同页的试问 AI 看看它会怎么回答。
- 在自动化页选择 AI 什么时候回答:只在没人在线时,或者始终先由 AI 回答。
AI 只依据知识库、用访客的语言回答。答不了或访客要求找人时,它会转给团队,并在这个对话里不再回答;团队成员一回复,AI 也会停下。
不在线的时候
- 离开时自动回复:团队没人在线时自动发出。
- 请访客留邮箱:可选从不、没人在线时、总是。
- 邮件跟进:访客已离开且留了邮箱,你的回复大约两分钟后会发到对方的邮箱。
- 团队提醒:访客等了几分钟仍没人在线,开了邮件提醒的成员会收到邮件。
团队和角色
| 角色 | 权限 |
|---|---|
| 所有者 | 全部权限,包括账单。 |
| 管理员 | 设置、知识库、网站、邀请和账单。 |
| 客服 | 回复对话、查看知识库。 |
在团队页邀请成员,对方用被邀请的邮箱登录即可加入。所有套餐都不限人数。
套餐和额度
各套餐包含的内容见定价。月度额度用完后在线聊天照常工作,AI 回答和翻译暂停到下个月或升级后恢复。超过套餐保留期的对话会自动删除。
访客身份校验
访客在你的网站登录后,可以告诉 Ontara 他们是谁,并且证明这一点,别人就冒充不了你的用户。
- 在聊天挂件 → 访客身份校验里开启,复制密钥,只放在你的服务器上。
- 在服务器上计算
hex(HMAC-SHA256(密钥, userId))。 - 在页面里调用
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
- 下载插件,在 WordPress 的插件 → 安装插件 → 上传插件里上传。
- 启用后打开设置 → Ontara Chat。
- 填入站点公钥;可选填访客身份校验密钥,已登录的 WordPress 用户就会显示为已验证。
REST API
在开发者页创建密钥,每个请求都带上 Authorization: Bearer lk_...。接口有:网站列表、对话列表和详情、读消息、以团队身份回复(会自动翻译给访客)、关闭和重开、删除对话、访客详情。每个密钥每分钟最多 120 次请求。完整说明见英文版。
Webhook
在开发者页添加 https 地址并选择事件。每个事件以 JSON POST 过来,请求头 Lingly-Signature: t=时间戳,v1=签名,签名是 hex(HMAC-SHA256(密钥, t + "." + 原始请求体))。返回 2xx 即视为成功,失败会重试约 20 分钟,一直失败的地址会被暂停。同一事件偶尔可能送达两次,用 id 去重。