課題管理ツール

視聴中のセッションをチケットにできます。プレーヤーのボタンを一つ押し、説明をご自身の言葉で書くだけで、再生リンクは既に付加されています。

1. 手動にしている理由

MousePlayer の他の連携ブリッジは、すべて自動で実行されます。こちらは違います。それが設計の核心です。

チケットは、人に作業を割り当てるものです。連打クリックのたびに作成すると、誰も仕分けない項目でボードが埋まり、1週間もすればチームはそれらを除外するようになります。その時点で、本物の問題も除外されてしまいます。

だから、きっかけを作るのはお客様自身です。セッションを見て、問題を発見し、ボタンを押して、見たことを書きます。録画のリンクは説明に既に入っています。判断するのはお客様です。

ボタンが表示されるのはオーナーと管理者だけで、共有リンクの表示では一切現れません。録画を送られた人が、お客様の課題管理ツールでチケットを作れるべきではないためです。

2. 五つの課題管理ツールと、それぞれに必要なもの

作成先指定するもの
Jiraプロジェクト内の課題サイト URL、アカウントのメールアドレス、API トークン、プロジェクトキー、課題タイプ
Linearチーム内の課題API キー、チーム ID
Asanaプロジェクト内のタスク個人用アクセストークン、プロジェクト ID
Trelloリスト内のカードキー、トークン、リスト ID
GitHubリポジトリ内の Issue個人用アクセストークン、owner/repo

タイルは一つで、一度に選択するプロバイダーは一つです。後から別の課題管理ツールを使う場合は、移行ではなく選択を変更します。

識別子の取得元

Linear のチーム ID と Asana のプロジェクト ID は、ブラウザーでチームやプロジェクトを開いたときの URL にあります。五つの中で最も調べにくいのは Trello のリスト ID です。ボードの URL に .json を追加し、対象のリストを探してください。Jira のプロジェクトキーは、すべての課題番号の先頭部分です。例えば、 ACME は、 ACME-1234の先頭部分です。

3. チケット内のリンクは当社のサーバーで作成します

入力する説明はお客様のものです。再生リンクは異なります。実際に視聴していたセッションから当社側で組み立て、フォームから影響を与えることはできません。

これは、チケットを他の人がクリックするため重要です。リンクをブラウザーから受け取ると、細工したリクエストによって、自社のツールに見えるものの中で、任意のアドレスをチームに提示できてしまいます。

HTTP 200 はチケットの存在を意味しません

Linear は GraphQL で応答し、GraphQL は拒否時にも 200 OK とともに errors 配列を返します。ステータスコードだけを確認する連携ブリッジなら、作成されなかったチケットを成功と報告してしまいます。当社は本文を読み取ります。

課題管理ツールが新しい課題の識別子を返す場合は、確認メッセージに含めます。緑色のメッセージを信じるだけでなく、実際に存在することを確認できます。

4. 意図的に含めていないもの

自動チケットはありません

理由は前述のとおりです。自動化したい場合は、Webhook 連携ブリッジから Zapier や Make に不満のシグナルを送り、そこでチケットにすべきものを判断できます。

双方向の同期はありません

チケットを閉じても MousePlayer では何も変わらず、MousePlayer 側の何かがチケットを再開することもありません。片方向半だけ動く同期は、人が頼り始めてしまうため、同期がないより悪いものです。

添付ファイルはありません

録画は当社に残り、当社で視聴します。動画を課題管理ツールにエクスポートすると、訪問者と合意した保存規則とは異なるシステムへ個人データを送ることになるためです。

トークンは AES-256-GCM で暗号化して保存し、再表示しません。内部キューにも一切含めません。この呼び出しは、待っている間にリクエストから直接実行されます。

5. GitLab、Azure DevOps、ClickUp

さらに三つの課題管理ツールに対応します。ボタンも、手動で実行する点も同じです。

指定するもの
GitLabホスト、プロジェクト ID、トークン。自社の GitLab にも対応します
Azure DevOps組織、プロジェクト、作業項目の種類、PAT
ClickUpリスト ID、個人用トークン

GitLab でホストを尋ねるのは、自社で運用している可能性があるためです

他と異なり、GitLab はセルフホストされることが多いため、ホストは固定値ではなく入力欄です。利用先が該当する場合は、 gitlab.com を貼り付けてください。

Azure DevOps には二つの特徴があります

本文はオブジェクトではなく JSON Patch ドキュメントで、コンテンツタイプは次である必要があります: application/json-patch+json 。それ以外では415が返ります。URL 内で作業項目の種類の前にあるドル記号は、埋め忘れたプレースホルダーではなく、アドレスの一部です。

ClickUp のトークンはそのまま指定します

先頭に次を付けません: Bearer 。この語を前に付けたトークンは401で拒否されます。誤ったトークンとまったく同じように見えます。

記載されている商標はすべて各所有者に帰属します。MousePlayer とこれらのプロバイダーとの間に取引関係はありません。