概要
Lark（Lark）Bitable 連携を設定すると、BugCapturer 拡張機能で生成したすべての共有レポートが、指定した Bitable に完全な 1 行のレコードとして自動的に書き込まれます。説明・ページ・環境・診断サマリー・スクリーンショットのリンク・共有リンクが一行にまとまり、グループチャットの誰にも迷惑をかけずに、チームはいつでもフィルターや見返しができます。 主な特徴：- 面倒な手順ゼロで導入：推奨は Webhook トリガー方式。Lark アプリの作成も管理者の承認も不要で、数分で設定が完了します
- 複数テーブルの振り分け：最大 3 件の連携を登録でき、それぞれ別のテーブルを指せます。「バグ追跡テーブル」と「製品要望テーブル」を分けて管理するのに最適
- 保存時に検証：保存時にサーバーが Webhook アドレスへテストリクエストを送信し、接続をその場で確認できます
- 失敗も見える化：書き込み失敗は自動リトライされ、配信ログで確認可能。20 回連続で失敗すると自動で一時停止し、メールでお知らせします
- 方式 A：自動化 Webhook トリガー（推奨） — Lark アプリの作成は不要。Bitable の「自動化」で Webhook トリガーのフローを新規作成し、アドレスを貼り付けるだけで数分で設定完了
- 方式 B：企業カスタムアプリ API — 保存時に 13 個の標準列を自動作成し、フィールドマッピングも不要。統一された列構造が必要なチームに最適
事前準備：Lark で Webhook フローを作成
Bitable を開き、右上の「自動化」→「新規フロー」をクリックします：BugCapturer での設定
- 名前：例「バグ追跡テーブル」
- Webhook アドレス：前のステップでコピーしたアドレスを貼り付け
- Bearer Token（任意）：Lark 側でトークン検証を有効にした場合のみ入力
フィールドマッピングの完了
Lark のフロー編集画面に戻ります：テーブルに書き込まれるフィールド
| 列 | 内容 |
|---|---|
| 説明 | 報告された問題の説明 |
| ページ URL | 問題が発生したページのアドレス（機密パラメーターはマスク済み） |
| ページタイトル | ページのタイトル |
| ブラウザー / OS / 解像度 | 環境情報 |
| コンソールエラー数 / ネットワークエラー数 | 診断サマリーの件数（本文は含まれません。共有リンクで全文を確認できます） |
| スクリーンショット | スクリーンショットのリンク（クリックで直接開けます） |
| 共有リンク | BugCapturer の共有ページ（完全な注釈・画面録画・診断詳細つき） |
| 提出日時 / 有効期限 / 同期日時 | タイムスタンプ |
日常の使い方
設定後は追加の操作は不要です。拡張機能で「共有」をクリック → テーブルに自動で行が追加されます。共有成功パネルには「N 件のテーブルに自動同期しました」と表示されます。- 書き込みテスト：設定ページの各連携カードに「テスト」ボタンがあり、いつでも書き込みを検証できます
- 配信ログ：直近 20 回の書き込みのステータス・失敗理由・Lark のレコード ID を確認できます
- 一時停止 / 再開：一時的に同期したくないときは一時停止し、いつでも再開できます
- 連続失敗保護：書き込みが 20 回連続で失敗すると（Webhook アドレスの失効、フローの無効化など）、連携は自動で一時停止し、メールで通知されます。修正後は「テスト」を押して検証すれば再開します
よくある質問
保存時に「Webhook アドレスの検証」に失敗すると出る？ アドレスが完全にコピーされているか（https:// を含む）、空白や改行が混入していないか確認してください。BugCapturer が対応しているのは公開された https アドレスのみです。
保存は成功したのにテーブルにデータがない？ Lark のフローが保存・有効化済みか確認してください。「出力設定」でフィールドマッピングが設定されていないと、リクエストを受信してもテーブルには書き込まれません。連携カードの「テスト」をクリックして、テストレコードを再送できます。
テーブルに書き込まれるのはスクリーンショットのファイル本体？ 現在書き込まれるのはスクリーンショットのリンクです。クリックすると高解像度の原図が開きます。
データは安全？ 連携による書き込みは、あなたが能動的に共有したときだけ動作します。このデータフローはプライバシーポリシーで開示しています。
その他のドキュメント：詳しい設定手順は公式ドキュメントをご覧ください — 方式 A · 自動化 Webhook トリガー / 方式 B · 企業カスタムアプリ API。