課題管理ツール
視聴中のセッションをチケットにできます。プレーヤーのボタンを一つ押し、説明をご自身の言葉で書くだけで、再生リンクは既に付加されています。
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 とこれらのプロバイダーとの間に取引関係はありません。