最初のヘルプセンターを立ち上げる

ドキュメントサイトとは、ワークスペース内の記事から作成されるホスト型のヘルプセンターです。検索機能、AIに質問するアシスタント、読者からのフィードバック機能を備えています。この記事では、最初の記事から独自のドキュメントサイトを公開するまでの手順を説明します。各ステップから詳細な記事へリンクしています。

はじめる前に#

• 役割: ワークスペースのオーナーと管理者がドキュメントサイトを作成・設定できます。コンテンツ作成者はページを追加でき、編集者は公開できます。誰が何を行えるかを確認してください。
• プラン: ドキュメントサイトはすべてのプラン（無料プランを含む）で利用可能です。無料プランとStarterプランには1サイトが含まれ、Proプランにはシート数に応じて2〜5サイトが含まれます。ドキュメントサイトのプランと制限を参照してください。
• 無料プラン: 公開には認証済みのメールアドレスが必要です。

ステップバイステップで構築する#

1. 最初の記事を書く#

   サイトには記事が表示されるため、まずはいくつか作成しましょう。作成をクリックし、記事タブを開いて種類を選択します（ハウツー記事、トラブルシューティング、標準作業手順書、ブログ記事、またはプロダクトアップデート）。デスクトップアプリ、Chrome拡張機能、アップロード、ライブラリ、またはAIで録画から録画を1つ追加し、記事を生成をクリックします。記事の生成には通常5〜15クレジットが必要です。詳しくは録画から記事を作成するをご覧ください。

   すでに他の場所でヘルプセンターを運用していますか？その場合は、サイト作成時（次のステップ）にインポートすることも可能です。

2. ドキュメントサイトを作成する#

   サイドバーのドキュメントサイトをクリックし、新しいドキュメントサイトを選択します。ウィザードは3つのステップで構成されています。

   1. サイトに名前を付ける: サイト名を入力し、.clevera.helpで終わる無料のアドレスを確認します。サイトの言語を選択します。
   2. コンテンツを選択: コレクションから（各フォルダがセクションになります）、コンテンツを選択、空から開始、または他のツールからインポートから選択します。
   3. カスタマイズ: ロゴ、ブランドカラー、フォント、およびデフォルトの外観を追加します。

   サイトを作成をクリックします。コンテンツから開始した場合、サイトはすぐに無料アドレスで公開され、概要ページが開きます。そこにははじめるためのチェックリストが表示されます。ドキュメントサイトを作成するを参照してください。

3. ページを追加・整理する#

   サイトのサイドバーでページを開き、セクションの追加、ライブラリからの記事の追加、新しいページの作成、順序の設定を行います。チェックリストでは少なくとも5ページの作成が推奨されています。ページを追加・整理するを参照してください。

4. 外観を設定する#

   外観を開いて、ロゴ、ブランドカラー、サイトスタイル、フォント、ホームページのヘッダーを変更します。ライブプレビューで変更内容を確認できます。ナビゲーションでヘッダーとフッターのメニューを設定します。ドキュメントサイトの外観をカスタマイズするおよびドキュメントサイトのヘッダーとフッターを設定するを参照してください。

5. AIアシスタントを有効にする#

   新しいサイトではアシスタントはオフになっています。設定 → AIアシスタントに移動し、アシスタントを表示をオンにします。回答できない場合の動作を選択し、保存をクリックします。アシスタントは公開済みのページのみに基づいて回答し、ソースをリスト表示します。回答にクレジットは消費されません。プランごとに月間の回答数（無料プランでは300回）が含まれています。ドキュメントサイトのアシスタントを設定するを参照してください。

6. 閲覧権限を設定する#

   すべてのサイトはデフォルトで公開されています。非公開にするには、設定 → アクセスに移動し、パスワードまたはワークスペースへのサインインを選択します。非公開サイトにはProプラン以上が必要です。ドキュメントサイトの閲覧権限を管理するを参照してください。

7. 公開する#

   サイトヘッダーの公開をクリックし、変更リストを確認して確定します（ボタンには「3件の変更を公開」のように表示されます）。読者は数秒以内に新しいバージョンを閲覧できます。すべてのバージョンは公開中に保持されるため、いつでもロールバック可能です。新しいサイトでは自動公開がオンになっています。サイトが公開されると、保存された変更は編集なしで約2分後に反映されます。ドキュメントサイトを公開するを参照してください。

8. 独自のドメインを接続する#

   カスタムドメインにはStarterプラン以上が必要です。ドメインを開き、help.example.comのようなサブドメインを入力して接続をクリックします。ドメインプロバイダーでCleveraが指定するCNAMEレコードを追加し、今すぐ確認をクリックします。証明書の発行には通常5〜30分かかります。ステータスが公開中になると、無料アドレスからドメインへリダイレクトされます。example.comのようなルートドメインは接続できません。ドキュメントサイトにカスタムドメインを接続するを参照してください。

Autopilotに構築を任せる#

Proプラン以上では、オートパイロットがヘルプセンターの構築と維持を代行します。サイドバーのオートパイロットをクリックして開始してください。詳しくはオートパイロットへのアクセス権を取得するをご覧ください。構築レシピを使用できるのは、ワークスペースのオーナーまたは管理者のみです。

アプリからヘルプセンターを構築する#

Autopilotで「アプリからヘルプセンターを構築」レシピをクリックするか、Autopilotは何をすべきですか？に「ヘルプセンターを構築して」と入力します。Cleveraエージェントが設定カードを表示します。詳細を入力をクリックし、ウェブサイトとアプリのアドレスを追加し、サインイン方法を選択して、サイトの言語を選択します。

既存のヘルプセンターの下で、新規作成を選択するか、インポートを選択してIntercom、Zendesk、Help Scout、GitBook、ReadMe、Mintlify、Document360、Docusaurus、または他のドキュメントサイトを選択します。インポートは公開ページのみを読み取り、無料です。NotionとConfluenceは、サイト作成後にサイト設定からインポートされます。

タスクはブランド、サイトと動画、記事、レビューと公開の4つのステップで実行されます。計画の作成は無料です。各ステップの計画と必要なクレジットを確認でき、実行をクリックするまで何も行われません。一般的な構築には240〜560クレジットが必要で、1〜3時間かかります。Cleveraが勝手にサイトを公開することはありません。最後のステップで記事を選択し、公開をクリックしてください。Autopilotでアプリからヘルプセンターを構築するを参照してください。

リリース時に最新の状態に保つ#

サイト作成後、「リリース時にヘルプセンターを最新の状態に保つ」レシピが、リポジトリのリリースやマージされた変更、変更履歴ページ、または指定した変更を監視します。何かが変更されるたびに、Cleveraは影響を受ける動画や記事を確認し、修正を計画します。各実行はユーザーの確認を待機します。一般的な実行には10〜150クレジットが必要です。リリース時にヘルプセンターを最新の状態に保つを参照してください。

関連情報#