Chatwork Group Mention

Chatwork に「グループメンション」を追加する拡張機能です。よくメンションする相手を「グループ」として登録しておくと、メッセージ入力欄で「@」からグループを選ぶだけで、メンバー全員分の [To:] メンションを一括挿入できます。あわせて、全ルームを横断検索できるルーム検索パレット(Cmd+K / Ctrl+K)も使えるようになります。 「毎朝の連絡で毎回5人分の To を選んでいる」「チーム全員に確実に通知したいのに、たまに1人漏れる」──そんな手間とミスをなくすために作りました。 ━━━━━━━━━━━━━━━━━━━━━━ 主な機能 ━━━━━━━━━━━━━━━━━━━━━━ ■ 1. グループメンション(@ サジェスト) ・ツールバーの拡張機能アイコンから、よくメンションするメンバーを「グループ」として登録できます(例: 営業チーム、開発チーム、プロジェクトA関係者) ・Chatwork のメッセージ入力欄で「@」を入力すると、登録済みグループのサジェストが表示されます ・グループ名の入力で候補を絞り込み、Enter / Tab / クリックで確定すると、メンバー全員分の「[To:アカウントID] 名前」が一括挿入されます ・あとは本文を書いて送信するだけ。全員に通知が届きます サジェストの操作: ・↑↓キーで候補を移動、Enter / Tab で確定、Esc で閉じる ・全角の「＠」にも反応します ・「@」は行頭または空白の直後でだけ反応するため、メールアドレスの入力などを邪魔しません ・一致するグループがないときは何も表示せず、Chatwork 標準の動作を妨げません ・日本語 IME での変換確定の Enter を誤って拾わないよう配慮しています グループは全ルーム共通で使えます。ルームごとの設定は不要です。 ■ 2. グループの作成・管理 ツールバーの拡張機能アイコンをクリックすると、グループ管理画面が開きます。メンバーの追加方法は3通りあります。 (1) API トークンで、ルームからメンバーを選ぶ(推奨) Chatwork の個人 API トークンを設定すると、参加中のルーム一覧からルームを選び、そのメンバーをチェックボックスで選んでグループに追加できます。「全員チェック」でルーム全員を一括追加することもできます。 (2) 表示中の画面から読み込む(トークン不要) Chatwork のタブを開いた状態で「今開いているルームの画面から読み込む」を押すと、画面に読み込まれている範囲からメンバー候補を収集します。手軽ですが、発言のないメンバーは取得できないことがある簡易的な方法です。 (3) 手動で追加(トークン不要) 名前とアカウント ID を直接入力して追加できます。 登録したグループは Chrome の同期ストレージに保存されるため、同じ Google アカウントでログインしている別の PC の Chrome でもそのまま使えます。 ■ 3. ルーム検索パレット(Cmd+K / Ctrl+K) キーボードだけで目的のルームへ素早く移動できます。 ・Cmd+K(Windows / Linux: Ctrl+K)でパレットが開きます ・参加中の全ルーム(グループチャット・ダイレクトチャット・マイチャット)を名前で検索できます ・検索は大文字/小文字、ひらがな/カタカナを同一視した部分一致です(「かいはつ」で「開発チーム」がヒット) ・並び順は「メンションあり → 未読あり → 更新が新しい順」。いま見るべきルームが上に来ます ・未読数・メンション数のバッジも表示されます(API トークン設定時) ・↑↓で選択、Enter でそのルームへジャンプ、Esc で閉じる ■ 4. 検索ボックスへのフォーカス(Cmd+Shift+P / Ctrl+Shift+P) Chatwork のメッセージ検索ボックスへキーボードだけでフォーカスを移せます。マウスに持ち替えずに検索を始められます。 ■ 5. 画面になじむ UI ・サジェストやパレットは Chatwork の画面の明暗(ダークモード)を自動検出し、テーマを合わせて表示します ・拡張機能の UI は Shadow DOM 内に描画されるため、Chatwork 側のデザインを崩したり、CSS が干渉したりしません ━━━━━━━━━━━━━━━━━━━━━━ 使い方(3ステップ) ━━━━━━━━━━━━━━━━━━━━━━ 1. グループを作る ツールバーの拡張機能アイコン → 「＋ 新しいグループ」→ 名前を付けてメンバーを追加 → 保存 2. 「@」で呼び出す Chatwork のメッセージ入力欄で「@」を入力 → グループ名で絞り込み → Enter で確定 3. 送信する メンバー全員分の [To:ID] 名前 が挿入されるので、本文を書いてそのまま送信 ━━━━━━━━━━━━━━━━━━━━━━ API トークンの設定(任意・推奨) ━━━━━━━━━━━━━━━━━━━━━━ トークンを設定すると「ルームからメンバーを選んでグループを作る」「パレットに未読数・メンション数を表示する」が使えるようになります。設定しなくても、画面からの読み込みや手動追加でグループを作って利用できます。 設定手順: 1. Chatwork 右上のプロフィール →「サービス連携」→「API Token」でトークンを発行 2. 拡張機能アイコン → 右上の ⚙ → トークンを貼り付けて「保存して接続テスト」 ━━━━━━━━━━━━━━━━━━━━━━ データの取り扱いについて ━━━━━━━━━━━━━━━━━━━━━━ プライバシーを最優先に設計しています。 ・開発者のサーバーは存在せず、外部へのデータ送信は一切ありません ・グループ定義(グループ名・メンバー名・アカウントID)は Chrome の同期ストレージ(chrome.storage.sync)に保存されます。保存先は Google アカウントに紐づく Chrome の領域で、開発者からは見えません ・API トークンはこの端末のローカルストレージ(chrome.storage.local)にのみ保存され、端末間で同期されません ・トークンは Chatwork 公式 API(api.chatwork.com)への通信にだけ使われます。用途は「自分のアカウント確認(接続テスト)」「参加ルーム一覧の取得」「ルームメンバー一覧の取得」の3つのみです ・メッセージの内容を読み取ったり、収集したり、自動送信したりすることはありません。メンションの挿入は入力欄への文字入力だけで、送信ボタンを押すのは常にあなた自身です ・アクセス解析・広告・トラッキングの類は一切含まれていません 権限について: ・「storage」: グループ定義とトークンの保存に使います ・「api.chatwork.com への接続」: 上記のメンバー・ルーム取得に使います ・コンテンツスクリプトは Chatwork(www.chatwork.com / kcw.kddi.ne.jp)のページでのみ動作します。他のサイトには一切アクセスしません ━━━━━━━━━━━━━━━━━━━━━━ こんな方におすすめ ━━━━━━━━━━━━━━━━━━━━━━ ・朝会や日報など、決まったメンバーへの定期連絡が多い方 ・プロジェクトの関係者全員に、漏れなく通知を届けたい方 ・大人数のルームで、特定のチームだけにメンションしたい方 ・たくさんのルームを行き来していて、ルーム探しに時間を取られている方 ・マウスよりキーボード操作が好きな方 ━━━━━━━━━━━━━━━━━━━━━━ 制限事項・ご注意 ━━━━━━━━━━━━━━━━━━━━━━ ・本拡張機能は個人が開発した非公式のツールであり、Chatwork 株式会社および KDDI 株式会社とは関係ありません ・Chatwork の画面構造(DOM)に依存する部分があるため、Chatwork 側のアップデートにより一部機能が動作しなくなる可能性があります。その際は順次対応します ・「画面から読み込む」機能は表示中の画面からの簡易収集のため、メンバーを全員は取得できないことがあります。確実な取得には API トークンの設定をおすすめします ・未読数・メンション数のバッジは API トークン設定時のみ表示されます ・グループ管理画面(ポップアップ)は現在ライトテーマのみの対応です ・対応ブラウザは Chrome および Chromium 系ブラウザ、対応サイトは Chatwork(www.chatwork.com)と KDDI Chatwork(kcw.kddi.ne.jp)です ━━━━━━━━━━━━━━━━━━━━━━ よくある質問 ━━━━━━━━━━━━━━━━━━━━━━ Q. API トークンは必須ですか? A. 必須ではありません。トークンなしでも、画面からの読み込みや手動追加でグループを作成できます。トークンを設定すると、ルームからのメンバー選択と未読バッジ表示が使えるようになります。 Q. トークンが外部に送られることはありませんか? A. ありません。トークンはお使いの端末にのみ保存され、Chatwork 公式 API との通信にだけ使われます。開発者を含む第三者に送信されることはありません。 Q. グループのメンバーはルームと自動で同期されますか? A. 同期されません。グループはあなたが登録した時点のメンバーの静的なリストです。異動などがあった場合は、グループ管理画面から編集してください。 Q. 挿入されたメンションは Chatwork の正式なメンションとして機能しますか? A. はい。Chatwork 標準の [To:アカウントID] 記法をそのまま入力欄に挿入するため、送信すれば通常どおり相手に通知が届きます。 Q. 「@」を入力しても何も出ません A. グループが未登録の場合、「@」単体の直後にのみ案内が表示されます。また「@」は行頭または空白の直後でのみ反応します。直前に文字がある場合は、スペースを入れてから「@」を入力してください。 不具合のご報告やご要望は、ストアのサポート欄からお寄せください。