サポート・開発者
ヘルプ導線を作りたい
- §23-01ヘルプ widget (右下バブル)
画面右下のボタンからヘルプとチャットを開く。
どの画面からでも同じ場所からヘルプや問い合わせに入れる。困った瞬間に離脱せず質問できるので、導入初期の挫折を減らす。
ヘルプ・サポート - §23-02FAQ アコーディオン
よくある質問を開閉式に並べて回答を折りたたむ。
質問の一覧を素早く見渡し、気になる項目だけ開いて読める。ヘルプや料金ページの疑問解消で、問い合わせを減らしたいときに使う。
ヘルプ・サポート - §23-03検索可能ナレッジベース
カテゴリと検索でヘルプ記事を探せるようにする。
利用者が問い合わせる前に自力で答えを見つけられるようにする。同じ質問が繰り返し届くサポートの負荷を減らす。
ヘルプ・サポート - §23-04Live chat
担当者や bot とリアルタイムに会話する窓口。
問い合わせフォームより早く返事を得られ、画面を離れずに疑問を解消できる。購入や設定の途中で詰まった利用者を取りこぼさない。
ヘルプ・サポート - §23-08Contextual help (?)
入力欄のそばの ? から補足説明を開く。
用語や入力形式が分からないときに、別ページへ移らずその場で確認できる。専門的な設定項目が並ぶフォームで効く。
ヘルプ・サポート
開発者向け公開機能を作りたい
- §24-01API key 管理 (生成/失効)
API キーを発行・失効し、秘密は一度だけ表示する。
開発者が自分でキーを作り、漏えい時にすぐ無効化できる。外部連携や API を提供するサービスの開発者設定に必要になる。
開発者向け公開機能 - §24-03Webhook 設定 + テスト送信
Webhook の URL を登録しテスト送信で確認する。
外部システムとの連携を、実際の通知を受け取りながら設定できる。連携が動かないときの原因調査にも使える。
開発者向け公開機能 - §24-05API playground / cURL builder
API をブラウザから呼び出し結果を確かめられる。
コードを書く前に動作とレスポンスの形を試せる。開発者向けドキュメントに添えて、導入の最初の一歩を軽くする。
開発者向け公開機能 - §24-09Embed code generator
埋め込み用のタグを生成してコピーできる。
自分のサイトにウィジェットを貼りたい人が、設定を選ぶだけでコードを手に入れられる。外部サイトへの配布を広げたい機能に向く。
開発者向け公開機能 - §24-07Rate limit indicator
API の残り呼び出し回数を表示する。
上限に達する前に利用者が気付き、処理を調整できる。従量制や厳しい上限のある API を提供するサービスで使う。
開発者向け公開機能
システム状態を伝えたい
- §25-01環境バッジ (staging/dev)
ステージングや開発環境であることを帯で常に示す。
どの環境を触っているかが一目でわかり、本番と間違えた操作を防ぐ。環境を複数持つ管理画面や社内ツールに置く。
メタ表示・ステータス - §25-02バージョン表示 (footer)
フッターに動作中のバージョンを表示する。
利用者と開発者が同じ版を見ているかを確かめる。不具合報告でどの版か分からず再現できない問題に効く。
メタ表示・ステータス - §25-04接続状態 indicator
オンライン・オフラインの状態を色と文言で示す。
通信が切れたことを即座に伝え、保存されない操作を続けさせない。チャットや共同編集など、常時接続を前提とする画面に置く。
メタ表示・ステータス - §25-05同期 indicator
同期中・完了・オフラインの状態を表示する。
変更が保存されたかを利用者が確かめられ、オフラインでも安心して作業を続けられる。自動保存のエディタやメモアプリで使う。
メタ表示・ステータス