用户反馈

安装 Blipit.showFeedback() or one POST

错误发生后,询问用户当时在做什么。浏览器 SDK 会打开一个小的原生对话框;其他客户端可以 POST 到反馈 endpoint。反馈会关联到事件所属的问题,并显示在问题页面和反馈页面上。

粘贴到 Claude Code、Cursor 或任何 AI 编程助手中。它包含步骤和代码。在 app.blipit.io 的“API 密钥”页面,同一提示词已填好你的密钥。

1浏览器对话框

打开一个带标签的表单(姓名、邮箱、消息),默认关联最近捕获的事件。按 Escape 关闭,发送时显示忙碌提示。

js
window.addEventListener("error", () => {
  Blipit.showFeedback({ title: "Something went wrong. What were you doing?" });
});

2直接调用 API

sh
curl https://in.blipit.io/api/v1/feedback \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
  -d '{"message":"The pay button did nothing","email":"ana@example.com","event_id":"9f1c4b6d8e2a47f0b3c5d7e9a1b2c3d4","url":"https://shop.example.com/checkout"}'

3让报告者随时了解进展

每个报告都会获得按项目编号的编号(BR-1、BR-2 等),发送后在小部件中显示。报告者留下邮箱时,Blipit 会用其语言发送回执,并附上跟踪报告的链接。在报告页面,“回复报告者”会把你的消息发邮件给对方,而“内部备注”只留在团队内;把报告移到“处理中”“完成”或“不予修复”时,会提供一封可编辑或跳过的邮件。在项目设置的错误报告小部件中选择回执、状态、发件人名称和回复地址。每封邮件都有一键退订链接,每个地址每小时最多 10 封,未留邮箱的报告者不会收到邮件。Odoo 用户可在 Blipit 的“我的报告”中查看自己的报告。 在内部备注中输入 @ 即可提及能打开该报告的团队成员:对方会收到包含备注的邮件,报告在其账户中显示为未读。提及内容绝不会发送给报告者。

4与工作区以外的人共享报告

发给非成员的错误报告邮件会附带一个只指向该报告的访客链接。发送到对方地址的 6 位验证码可打开只读视图,内容包括消息、截图、录屏、所选元素以及 Odoo 模型、记录和字段,除此之外什么都没有。详情见告警;要关闭或撤销访问,请前往设置 > 访客访问。

5服务台

错误报告可作为服务台使用:报告者凭编号了解每一步进展,您的团队则获得目标、提醒和工作情况报告。在“错误报告 > 服务台设置”中配置。

  • 所有方案:在已收到、审核中、处理中、等待您的回复、已修复、不修复和重新打开时发邮件,优先级、标签或负责人变更从不发邮件。几分钟内的变更合并为一封邮件,同一报告的邮件保持在同一会话中。
  • Solo 及以上:列出报告者在您工作区中所有报告并带回复框的页面、带提醒和自动关闭的“等待报告者”、自动填入报告者姓名、编号和链接的已保存回复、关注报告和合并重复报告。
  • Team 及以上:按优先级、按工作时间和节假日计算的响应和解决目标,等待报告者时暂停;“即将到期”提醒负责人,“已超时”提醒所有者和管理员;修复后一键满意度问题;团队;以及中位数、p90、SLA 达成率和满意度并列的服务台报告。
  • Scale:按团队的目标(例如外部 IT 服务商的合同)、团队对比和按成员的数据。

须知

  • 字段:message 1 到 5,000 个字符(必填),name 最多 128 个,有效的 email,32 位十六进制的 event_id,以及不含查询字符串的页面 URL。
  • 反馈页面按最新在前列出所有内容。文本始终以纯文本渲染,绝不作为 HTML 或链接。
  • 限制:每个密钥每分钟 60 条反馈。
  • 控制台侧边栏的“缺陷报告”会显示对你来说是新的报告数量,浏览器标签页也会显示,例如 (3) Blipit。打开报告或报告离开“新建”状态后不再计数;缺陷报告页面上的“全部标为已读”会清零。
  • 每封邮件中的“跟踪此报告”链接会打开一个使用报告者语言的私密页面,显示编号、状态记录、你的回复以及对方发送的截图。报告者可以在那里添加一条消息和一张图片(PNG、JPEG 或 WebP,最大 3 MB;每个报告最多 5 张图片,每天最多 10 条消息)。消息会以“来自报告者”标记显示在报告的动态中,并通知负责人;若无负责人,则通知接收错误报告邮件的人以及 Slack、Teams 和 webhook(类型 bug_report.reply)。该页面不会被搜索引擎收录,且只能打开其链接对应的报告。 页面在显示任何内容之前,会向报告人的邮箱发送 6 位验证码(10 分钟内有效,可尝试 5 次);输入后,该浏览器可在 7 天内打开此报告,链接也会从地址栏移除。未填写邮箱提交的报告只能在提交它的应用中跟进。在 Odoo 中,报告人在 Blipit「我的报告」下的报告聊天记录(chatter)中跟进并回复自己的报告。
  • 报告者也可以直接回复这些邮件。回复会发送到该报告专用的地址;Blipit 会去掉引用的旧邮件和签名,忽略外出自动回复等自动邮件以及非报告者地址发来的邮件,并把其余内容作为报告者的消息添加到报告中,通知方式和每天 10 条消息的上限相同。
  • “回复报告人”和“内部备注”都可以添加附件:点击“附加”、把文件拖到输入框,或粘贴图片。图片(PNG、JPEG、WebP)和 PDF 最大 3 MB,WebM 或 MP4 视频最大 60 MB,每条消息最多 10 个文件,每个报告最多 30 个,每个文件都会显示上传进度和移除按钮。回复报告人时附带的文件会出现在对方的跟踪页面、回复邮件中的缩略图和链接里,以及 Odoo 中;内部备注的文件永远不会离开你的团队。
  • 在 Odoo 中,Blipit 的“我的报告”会在一个页面中打开每个报告:状态、报告时间和最后更新、团队最新的回复及其文件、用户报告的内容(描述、页面、浏览器和系统),以及一个图库,汇集截图、屏幕录制、会话回放和团队发送的所有文件。所有内容都可全屏打开,支持方向键、滑动、缩放和下载,对话仍在旁边的聊天栏中。文件链接 15 分钟后失效,回放链接 10 分钟后失效,每个链接只为该用户打开该报告的文件。

遇到问题?发邮件至 support@blipit.io。每个项目的密钥和项目 id 在 app.blipit.io 的“API 密钥”下。