engawa ユーザーガイド

目次

1. はじめに
2. ログイン / ログアウト
3. 画面構成
4. メッセージを送る
5. メッセージを編集・削除する
6. ファイルを添付する
7. リアクションをつける
8. 返信（引用）
9. @メンション
10. ルームを作る・参加する
11. ダイレクトメッセージ (DM)
12. 既読・未読
13. メッセージ検索
14. リマインダー（後で再通知）
15. プロフィール / パスワード変更
16. キーボードショートカット
17. 制限値リファレンス
18. 困ったとき
19. 管理者向け機能

はじめに

engawa は ~100 名規模の組織を想定した、軽量な社内チャットツールです。 ブラウザだけで使える Web アプリで、PC とスマホの両方で動作します。

主な機能:

• グループチャットと 1:1 ダイレクトメッセージ
• ファイル添付（最大 50MB）
• 絵文字リアクション（カテゴリ別 250+ 個）
• 特定メッセージへの返信（引用）
• @メンション での呼びかけ
• 全文検索（日本語対応）
• 未読カウントとプッシュ通知（PWA インストール時）

ログイン / ログアウト

1. ブラウザで管理者から共有された URL を開きます。
2. メールアドレスとパスワードを入力します。
3. 初回ログイン後はパスワードの変更を強くおすすめします（プロフィール / パスワード変更）。

ログアウトはサイドバー上部のログアウトアイコンから。

セッションが切れた場合は自動的にログイン画面に戻ります。

画面構成

PC では左にサイドバー、右にメッセージエリアの2カラム。スマホではサイドバーが画面いっぱいに表示され、ルームを開くと切り替わります。

接続インジケータが「切断」になった場合、ネットワーク回復時に自動再接続します。

メッセージを送る

1. ルームを選んでメッセージエリアを開きます。
2. 下部のテキストエリアに本文を入力します。
3. Cmd+Enter (Mac) または Ctrl+Enter (Windows/Linux) で送信。
   • 単独の Enter は改行になります（モバイルキーボード対策）。
   • プロフィールから「Enter で送信」を ON にするとモバイル風の挙動に切替可能。

送信したメッセージは即座にリストの末尾に表示され、他のメンバーにも WebSocket でリアルタイムに届きます。

Markdown

本文は markdown としてレンダリングされます。

URL はそのまま貼っても自動でリンクになります。<script> などの危険な HTML はサニタイズで除去されます。

下書き

入力中のテキストはルーム単位で自動保存されます。タブを閉じても、戻ってくれば書きかけが復元されます。ルームを切り替えても各ルームの下書きが個別に保持されます。

メッセージを編集・削除する

自分が送ったメッセージにマウスホバー（モバイルでは長押し以外で常時表示）すると以下のボタンが出ます:

• ✎ 編集 — 本文を書き換えて保存（編集済みのマークが付きます）
• 🗑 削除 — 確認ダイアログのあと完全に削除

他人のメッセージは編集・削除できません。誤送信の場合はすぐ削除してください — 既読履歴はリセットされません。

ファイルを添付する

3つの方法があります。

1. 「+」アイコンをタップ → 1〜複数ファイルを選択（最大 10 件）。
2. ドラッグ&ドロップ — ファイルをチャット入力欄に直接ドロップ。デスクトップで枠が青く光ったらリリース OK。
3. クリップボード貼付 — スクリーンショット (Cmd+Shift+4 / Win+Shift+S) のあと、入力欄で Cmd+V / Ctrl+V。

入力欄の上にファイル名のチップが並ぶので、不要なものは「×」で外せます。テキストと一緒に送信、もしくはテキスト無しで送信。

対応形式: 画像 / 動画 / PDF / Office (doc/xls/ppt) / テキスト / ZIP 1ファイルあたり最大 50MB。

受信側ではメッセージ下に添付ブロックが表示されます。画像はインラインプレビュー、それ以外はダウンロードリンクとして開けます。

リアクションをつける

メッセージにマウスホバー（または常時表示の操作行）から 😀 ボタン を押すとピッカーが開きます。

ピッカーは2段階:

1. クイック行 — 最近使った絵文字 + よく使う6個 + 「＋（もっと）」ボタン
2. フルピッカー — 「＋」を押すとカテゴリタブ（顔/手/ハート/動物/食/アクティビティ/物/記号）付きのスクロール一覧が開く

選択した絵文字がメッセージ下にバッジとして付きます。

• 同じ絵文字をもう一度押すと取消
• 絵文字をタップすると押した人の合計人数がカウント
• 絵文字バッジがハイライト（青）されているものは自分が押したもの

カスタム絵文字（特殊な Unicode シーケンス）はピッカー下の「絵文字を直接入力」欄から追加できます。

返信（引用）

特定のメッセージに対して文脈を保ったまま返事をしたいとき:

1. 対象メッセージにホバー → 「↩ 返信」ボタンを押す。
2. 入力欄の上に 「Alice への返信: 元のメッセージ抜粋」 というインジケータが出る。
3. キャンセルしたい場合は「×」を押す。
4. そのまま本文を打って送信。

送信されたメッセージには元発言の引用ブロックが添付され、引用ブロックをタップすると元のメッセージへスクロール&ハイライトします。

元メッセージが削除された場合、引用ブロックは「(削除されたメッセージ)」とだけ表示されます。

@メンション

特定のメンバーに向けて呼びかけると、相手のメッセージリストでハイライト表示されます（将来的にはプッシュ通知も予定）。

1. テキストエリアで @ を入力。
2. その時点でルームメンバーの候補リストがポップアップ。
3. 入力を続けるとフィルタリングされる（大文字小文字区別なし）。
4. ↑/↓ で選択 → Enter または Tab で確定。クリック / タップでも可。
5. @山田太郎 のように名前+半角スペースが挿入される。

送信されたメッセージでは:

• 引用された名前がチップ風にハイライト
• 自分が呼びかけられた場合、メッセージ全体に青い縦線と背景色が付く

メンバーじゃない人を @hoge と書いても、チップ化はされません（プレーンテキスト扱い）。

全体メンション (@channel / @here)

グループルームでは特別な2つのメンションが使えます (DM では無効):

• @channel — そのルームの全メンバーに通知
• @here — その時点でルームを開いているオンラインメンバーに通知

メンション補完で @ch / @he と打つと候補に出ます。「全員に通知」「今いる人に通知」というヒント付きで表示されるので、誤選択しにくくなっています。

@channel は本気の全社告知だけにしてください。連発すると通知疲れの原因になります。

ルームを作る・参加する

サイドバー下部の 「ルーム作成」 ボタンから:

1. ルーム名を入力（最大 100 文字）。
2. 招待するメンバーを一覧から選択（複数可）。
3. 「作成」を押すと新しいルームが開きます。

ルームに後からメンバーを追加することもできます（参加中ルームのメニューから）。

ダイレクトメッセージ (DM)

サイドバーの「ユーザー一覧」または「DM作成」UI から相手を選ぶと、その相手との 1:1 ルームが自動的に作られます（既に存在すればそれが開きます）。

DM はルーム名が自動的に相手の名前になり、他のグループルームと同じく検索や添付に対応しています。

既読・未読

ルームを開いた時点で既読としてマークされます。

• 未読メッセージがあるルームには 数字バッジ が表示
• 自分が送信したメッセージは未読カウントの対象外
• 別のルームに切り替えても、サーバー側で個別に既読位置を保持

ブラウザを閉じても既読位置はサーバーに保存されているため、別端末で開いたときも同期されます。

メッセージ検索

サイドバーの 検索 ボタンから:

1. キーワードを入力（部分一致 / FTS5 全文検索）
2. 必要に応じてフィルタ:
   • ルーム — 特定のルーム内に絞る
   • 発言者 — 特定のメンバーの発言だけ
   • 期間 — From / To で日付範囲指定
3. 結果リストの行をクリックすると元メッセージへジャンプ&ハイライト

検索対象は自分が参加しているルームのみです（他人だけのルームの内容は出ません）。

リマインダー（後で再通知）

「後で対応したい」メッセージに自分用のリマインダーを設定できます。

設定:

1. 対象メッセージの ⋯ メニュー → ⏰ リマインド を開く
2. 時間を選ぶ:
   • プリセット（30分後 / 1時間後 / 3時間後 / 明日の朝9時 / 来週）
   • または 任意の日時 を指定
3. 必要ならメモを入力して 設定

通知:

• 指定時刻になると プッシュ通知 が届き、タップで該当メッセージへジャンプします（PWA インストール + 通知許可が前提）。
• リマインダーは 自分だけに見える個人設定です。相手には通知されません。

一覧・解除:

• サイドバー（スマホは「その他」メニュー）の リマインダー から、予定・通知済みの一覧を確認し、不要なものを 解除 できます。

退室した／削除されたメッセージのリマインダーは、発火時に内容を出さず自動的にスキップされます。

プロフィール / パスワード変更

サイドバー上部の自分の名前 → 「プロフィール」を開く:

• 表示名の変更 — 即時反映、サーバーから新トークンが発行されます
• パスワードの変更 — 現在のパスワード + 新しいパスワード（最低 8 文字）

表示名は他のメンバーから見える名前です。@メンションのときに使われるので、わかりやすく一意な名前を推奨します。

キーボードショートカット

サイドバー操作 (スマホ / マウス)

ルーム行に対して以下が使えます。

• 行をスワイプ — 右スワイプで「ピン留め / 解除」、左スワイプ (未読がある時のみ) で「既読化」。緑/青のアクション帯が行の下から現れ、64px 引っ張ったら commit。
• 右クリック (デスクトップ) — ピン留め / 通知レベル変更 (全通知 / メンションのみ / ミュート) / 既読化 / 退出 のメニュー。

制限値リファレンス

困ったとき

ログインできない

• メールアドレス / パスワードを再確認
• アカウントが無効化されていないか管理者に確認
• 5回連続失敗でしばらくロックされる場合があります

メッセージが送れない

• 画面上部の 接続状態 が「切断」になっていないか確認
• 画面上部に保守中のお知らせバナーが出ていないか確認（出ている場合はしばらく待つと復旧します）
• それでもダメなら一度ログアウト→再ログイン

添付がアップロードできない

• ファイルサイズが 50MB 以下か
• 同時添付が 10 件以下か
• 拒否される拡張子（実行ファイル等）でないか

通知音がならない / プッシュが来ない

• ブラウザ通知の許可設定を確認（PWA インストール推奨）
• システムの「通知」設定でブラウザを許可

「セッションが切れました」と出る

• パスワード変更や管理者によるアカウント無効化で発生します
• 再ログインしてください

問題が解決しない場合は管理者に連絡してください。

管理者向け機能

管理者ロールのユーザーには、サイドバーに 「管理」 メニューが表示されます。

ユーザー管理

管理 → ユーザー タブから:

• ユーザー一覧（メール / 名前 / ロール / 状態 / 最終ログイン）
• 検索
• 新規ユーザー作成 — メール / 名前 / 初期パスワード / ロール
• ユーザーの編集:
  • 表示名の変更
  • ロールの変更（admin ↔ member）
  • 無効化 / 有効化 — 無効化されたユーザーはログイン不可
  • パスワードリセット — 新しいパスワードを設定（強制変更通知は別途）

自分自身の無効化や、自分が最後の admin で member への降格はブロックされます（システムから admin がいなくなる事故を防止）。

ルーム管理

管理 → ルーム タブから:

• ルーム一覧（メンバー数 / メッセージ数 / 最終アクティビティ）
• 検索
• ルーム削除 — ルーム自体とそのメッセージ / リアクション / 添付すべてが消えます。添付ファイルの実体（ローカル/S3）も削除されます

削除は元に戻せません。重要なルームを削除する際は十分にご注意ください。

監査ログ

管理 → 監査 タブから:

• 管理操作（ユーザー作成 / 変更 / パスワードリセット / ルーム削除 など）の履歴
• 実行者 / 対象 / メタデータ / タイムスタンプ
• アクション種別でフィルタ可能

監査ログは追記専用で削除できません。