本記事では、実際にヘルプを構築する具体的な流れをまとめます。
ここからは考え方ではなく、手順です。
まずやることは、機能を理解すること
ヘルプを作るとき、最初に必要なのは文章ではありません。
サービスやプロダクトの機能を把握することです。
- どんな操作があるのか
- どこで入力が発生するのか
- どこで判断が必要になるのか
- どこでエラーが起こりうるのか
機能を分解していくと、ユーザーが止まりそうな地点が見えてきます。
既存サービスであれば、問い合わせログや検索ログも確認します。
新規サービスであれば、機能単位で迷いを仮説します。
いずれにしても、出発点は「機能理解」です。
つまづきを洗い出す
次に、ユーザーが迷いそうな場面を書き出します。
ここではまだFAQは作りません。
- ログインできない
- 決済が完了しない
- 設定が保存されない
- エラー表示の意味が分からない
この段階では、困りごとの断片を集めます。
既存サービスなら実際のログから。
新規サービスなら仮説から。
つまづきは、問い合わせだけから拾うものではありません。
特に新規や改修直後は、ログが薄く「問い合わせ起点」だけだと取りこぼします。
実務では、つまづきの入口を最低でも3つ持ちます。
- 問い合わせログ：困りごとが顕在化した状態（最後の行動）
- ヘルプ検索ログ：探したが解決できなかった状態（迷いの痕跡）
- サジェストワード：ユーザーが使う言い方（迷いの入口）
既存サービスなら、まず問い合わせとヘルプ検索ログを優先します。
一方、新規・改修直後など「まだ問い合わせが少ない」状態では、サジェストワードから先に拾うほうが早い。
これら拾った語は、何が問題か（WHAT）、なぜ起きるのか（WHY）、どう解決するのか（HOW）まで含めて構造化した考え方が、コンタクトリーズン設計です。
詳しい設計方法は、以下の記事で解説しています。
WHATを整理する
洗い出したつまづきを、ユーザーの状態として整理します。
重要なのは、機能名ではなく、
「ユーザーがどんな状態にあるか」で表現することです。
「決済機能の不具合」ではなく、
「決済が完了しない」。
この違いが、そのままQの質になります。
HOWを確認する
次に、そのWHATに対して正しい解決手順（HOW）を確認します。
- 正しい操作手順
- 条件分岐
- 例外ケース
- 仕様上できないこと
ここは必ず運営や開発とすり合わせます。
推測で書かない。
必ず確認する。
Qを設計する
WHAT（状態）
＋
つまづきの状況
＋
必要であればWHY（理由）
を組み合わせて質問文を作ります。
ここで初めてFAQの「Q」が完成します。
Aを作成する
回答は、結論から書きます。
まず何をすればよいか。
次に具体的な手順。
最後に補足や注意点。
説明を書くのではなく、
解決できる形に整えます。
QとAの設計方法をより具体的に整理した内容は、以下の記事で解説しています。
FAQを一覧で管理する
完成したFAQは、まずスプレッドシートで管理します。
- Q
- A
- カテゴリ案
一覧化し、運営と何度も確認します。
ここが曖昧なまま公開すると、後で必ず修正が発生します。
カテゴリを設計する
FAQが揃ったら、カテゴリを決めます。
ここでも基準は機能ではありません。
ユーザーの迷いのまとまりです。
必要に応じて第二階層も設計します。
カテゴリは「管理しやすさ」ではなく
「探しやすさ」で決めます。
ヘルプ全体の構成を決める
ここで初めて、ページ構成を考えます。
基本構造は次の通りです。
検索を最上部に置く。
カテゴリを配置する。
問い合わせフォームは最後に設置する。
問い合わせは、FAQで解決しなかった場合の最終手段です。
ただし、日本では安心感を確保するために
ヘルプトップ下部にも設置することがあります。
導線を設計する
最後に、ヘルプへの導線を決めます。
エラー画面から関連FAQを出すのか。
操作直後にリンクを表示するのか。
ヘッダーやマイページに設置するのか。
迷いが発生する地点から回収できるかどうかが重要です。
まとめ
ヘルプ構築は、文章を書く作業ではありません。
機能を理解し、
つまづきを洗い出し、
WHATを整理し、
HOWを確認し、
QとAを設計する。
そのうえで、
一覧で管理し、
カテゴリを設計し、
構成を決め、
導線まで整える。
この順番を踏まなければ、ヘルプは「存在するだけ」のページになります。
実務設計の全体像について
本記事では、ヘルプ構築の具体的な流れを整理しました。
ただし、ヘルプを“作る”ことと、
ヘルプを“機能させる”ことは同じではありません。
手順を踏めばページは完成しますが、
それだけでは、ユーザーが迷わず解決できる構造にはなりません。
ヘルプを単なる情報置き場にせず、
「解決までのプロセス」として設計する視点が必要です。
本記事で整理した
機能理解
つまづきの整理
WHAT／WHY／HOWの構造化
FAQ設計
カテゴリ設計
構成・導線設計
これらを一貫した設計思想として体系化したものが、
自己解決型ヘルプ・サポート設計書です。
実務で迷わないための設計基準と構造全体をまとめています。
▶ https://helpdesign.stores.jp/items/685ab6239fb10280e4db2072
コメント