ユーザーフィードバック

インストール Blipit.showFeedback() or one POST

エラーの後、ユーザーに何をしていたかを尋ねます。ブラウザ SDK は小さなネイティブダイアログを開き、他のクライアントはフィードバックエンドポイントに POST します。フィードバックはイベントのイシューにリンクされ、イシューページと「フィードバック」ページに表示されます。

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 は報告者の言語で受付メールと状況確認リンクを送ります。報告ページでは「報告者に返信」でメッセージをメール送信し、「社内メモ」はチーム内にとどまります。報告を「対応中」「完了」「対応しない」に移すと、編集またはスキップできるメールが提案されます。受付メール、ステータス、送信者名、返信先はプロジェクト設定のバグ報告ウィジェットで設定します。すべてのメールにワンクリックの配信停止リンクがあり、1 つのアドレスに届くのは 1 時間に最大 10 通で、メールアドレスのない報告者には送信されません。Odoo ユーザーは Blipit の「自分の報告」で自分の報告を確認できます。 社内メモで @ を入力すると、その報告を開けるチームメンバーをメンションできます。メンションされた人にはメモ付きのメールが届き、報告は未読として表示されます。メンションが報告者に届くことはありません。

4ワークスペース外の人とレポートを共有

メンバーではない人へのバグレポートのメールには、そのレポートだけを開くゲストリンクが入ります。宛先に届く 6 桁のコードで、メッセージ、スクリーンショット、録画、選択した要素、Odoo のモデル・レコード・フィールドだけを閲覧のみで表示します。詳細はアラートを、オフにする場合やアクセスの取り消しは設定のゲストアクセスをご覧ください。

5サービスデスク

バグレポートはサービスデスクとして使えます。報告者は参照番号で各ステップを知ることができ、チームには目標、通知、対応状況のレポートが用意されます。「バグレポート > サービスデスク設定」で設定します。

  • すべてのプラン:受付、確認中、対応中、ご返信待ち、修正済み、対応しない、再オープンでメールを送ります。優先度・ラベル・担当者の変更では送りません。数分以内の変更は1通にまとまり、同じレポートのメールは1つのスレッドに並びます。
  • Solo 以上:ワークスペース内の報告者のレポート一覧と返信欄のあるページ、リマインドと自動クローズ付きの報告者返信待ち、報告者名・参照番号・リンクを自動で埋める保存済み返信、レポートのフォロー、重複の統合。
  • Team 以上:営業時間と休日に基づく優先度ごとの初回対応・解決目標(報告者の返信待ち中は停止)、担当者への期限間近の通知とオーナー・管理者への期限超過の通知、修正後のワンクリック満足度の質問、チーム、そして中央値・p90・SLA 達成・満足度を並べたサービスデスクレポート。
  • Scale:チームごとの目標(外部 IT 事業者の契約など)、チームの比較、メンバーごとの数値。

知っておくと便利

  • フィールド:message は1〜5,000文字(必須)、name は128文字まで、有効な email、32文字の16進数の event_id、クエリ文字列を除いて保存されるページ URL。
  • 「フィードバック」ページにはすべてが新しい順で表示されます。テキストは常にテキストとして描画され、HTML やリンクにはなりません。
  • 上限:キーごとに1分あたり60件のフィードバック投稿。
  • ダッシュボードのサイドバーの「バグ報告」に、あなたにとって新しい報告の数が表示され、ブラウザーのタブにも (3) Blipit のように表示されます。報告を開くか「新規」でなくなると数えられなくなり、バグ報告ページの「すべて既読にする」で数がリセットされます。
  • 各メールの「この報告の状況を見る」リンクは、報告者の言語で受付番号、ステータス履歴、あなたの返信、送信されたスクリーンショットを表示する非公開ページを開きます。報告者はそこでメッセージと画像 1 枚(PNG、JPEG、WebP、3 MB まで。1 件の報告につき画像は最大 5 枚、メッセージは 1 日 10 件まで)を追加できます。メッセージは報告のアクティビティに「報告者から」として表示され、担当者、担当者がいなければバグ報告メールの受信者、Slack、Teams、Webhook(タイプ bug_report.reply)に通知されます。このページは検索エンジンにインデックスされず、リンクが作られた報告だけを開きます。 ページは何かを表示する前に、報告者のメールに6桁のコードを送信します(有効期間10分、5回まで)。入力後はそのブラウザで7日間レポートを開くことができ、リンクはアドレスバーから消えます。メールアドレスなしで送信されたレポートは、送信元のアプリでのみ確認できます。Odoo では、報告者は Blipit の「マイレポート」で、レポートのチャターから自分のレポートを確認し返信します。
  • 報告者はこれらのメールに返信するだけでも追記できます。返信はその報告専用のアドレスに届き、Blipit は引用された以前のメールや署名を取り除き、不在通知などの自動返信や報告者以外のアドレスからのメールを無視し、残りを報告者からのメッセージとして報告に追加します。通知も 1 日 10 件の上限も同じです。
  • 「報告者に返信」と「社内メモ」にはファイルを添付できます。添付をクリックするか、ボックスにファイルをドロップするか、画像を貼り付けます。画像 (PNG、JPEG、WebP) と PDF は 3 MB まで、WebM または MP4 の動画は 60 MB まで、1 件のメッセージにつき 10 件、1 件のレポートにつき 30 件までで、それぞれアップロードの進み具合と削除ボタンが表示されます。報告者への返信のファイルは、報告者の追跡ページ、返信メールのサムネイルとリンク、Odoo に表示されます。社内メモのファイルがチームの外に出ることはありません。
  • Odoo では Blipit の「マイレポート」で各レポートを 1 画面で開けます。ステータス、報告日時と最終更新、チームからの最新の返信とそのファイル、ユーザーが報告した内容 (説明、ページ、ブラウザーとシステム)、そしてスクリーンショット、画面録画、セッションリプレイとチームが送ったすべてのファイルをまとめたギャラリーです。どれも全画面で開き、矢印キー、スワイプ、ズーム、ダウンロードが使え、会話は横のチャターに残ります。ファイルのリンクは 15 分、リプレイのリンクは 10 分で期限が切れ、そのユーザーのそのレポートのファイルだけを開きます。

お困りですか?support@blipit.io までメールしてください。各プロジェクトのキーとプロジェクト ID は app.blipit.io の「APIキー」にあります。