Zendesk Guideでコンテンツを出し入れしようとしたことがあるなら、おそらく他の人と同じ壁にぶつかったことがあるでしょう。組み込みのエクスポートボタンがないことです。Zendeskはヘルプセンターの記事を一括でエクスポートするためのネイティブツールを提供していないため、多くのチームはナレッジベースの移行、バックアップ、または再構築が必要な場合に、回避策を探すのに苦労しています。
朗報は、選択肢があるということです。実際には、いくつかあります。Python（パイソン）スクリプトを書くのが得意でも、ポイントアンドクリックのインターフェイスが好きでも、あなたのチームに合った方法があります。このガイドでは、Help Center APIからサードパーティアプリ、プロの移行サービスまで、Zendesk Guideの記事をインポートおよびエクスポートするために利用できるすべての方法について説明します。
Zendesk Guideのコンテンツ構造を理解する
コンテンツの移動を開始する前に、Zendeskがどのようにコンテンツを整理しているかを理解する必要があります。単純なフォルダシステムとは異なり、Zendesk Guideは3層の階層を使用します。
- カテゴリは、最上位のコンテナです。
- セクションはカテゴリ内に存在し、記事を保持します。
- 記事は、実際のコンテンツです。
この構造が重要なのは、記事をまとめてインポートして後でソートすることができないためです。最初にカテゴリとセクションを配置する必要があります。別のプラットフォームから移行する場合は、既存の構造をこの3層モデルにマッピングする必要があります。
ユーザーセグメントと呼ばれるオプションのレイヤーもあり、誰がどのコンテンツを見ることができるかを制御します。（内部ドキュメントやVIP専用の記事など）制限されたセクションがある場合は、それらを使用するセクションを作成する前に、これらのセグメントを設定する必要があります。
結論として、インポートを開始する前に構造を計画すると、後でクリーンアップ作業の時間を節約できます。
方法1：Help Center APIを使用する
Zendesk Help Center APIは、コンテンツをインポートおよびエクスポートするための最も強力で柔軟なオプションです。大量のデータを移動する必要がある場合、Zendeskが公式に推奨する方法でもあります。
必要なもの
APIメソッドを開始する前に、以下があることを確認してください。
- APIアクセスが有効になっているZendeskアカウント
- 認証用のAPIトークンまたはOAuth（オーオース）認証情報
- REST API（またはチームの開発者）に関する基本的な知識
- Python（推奨）またはスクリプト作成用の別の言語
API経由でコンテンツをエクスポートする
既存の記事をエクスポートするには、List Articles（記事一覧）エンドポイントを使用します。
GET /api/v2/help_center/articles
APIは、カーソルベースのページネーション（推奨）とオフセットページネーションをサポートしています。大規模なヘルプセンターの場合、カーソルページネーションの方が信頼性があります。リクエストに?page[size]=100を追加することでアクティブにできます。
Zendeskは、ナレッジベース全体のバックアップについて説明するPythonスクリプトの例を提供しています。スクリプトはページネーションを自動的に処理し、各記事をHTMLファイルとして保存します。
APIは、Zendesk Support APIと同じレート制限に従うことに注意してください。数千の記事をエクスポートする場合は、レート制限処理を組み込む必要があります。
API経由でコンテンツをインポートする
インポートは、正しい順序でコンテンツを作成する必要があるため、より複雑です。
-
作成者をZendeskユーザーとして最初にインポートします。役割を「エージェント」に設定し、APIから返されたユーザーIDを記録します。
-
Create Category（カテゴリ作成）エンドポイントを使用してカテゴリを作成します。次のステップのためにカテゴリIDを記録します。
-
制限されたアクセスが必要な場合は、ユーザーセグメントを作成します（オプション）。セグメントIDを記録します。
-
適切なcategory_idとuser_segment_idを割り当てて、カテゴリ内にセクションを作成します。
-
各記事のauthor_idとsection_idを設定して、セクション内に記事を作成します。
-
公開的にホストされていないインライン画像が記事に含まれている場合は、添付ファイルを個別にアップロードします。
基本的な記事作成リクエストは次のようになります。
POST /api/v2/help_center/sections/{section_id}/articles
{
"article": {
"title": "はじめにガイド",
"body": "<p>当社の製品へようこそ...</p>",
"author_id": 9873843,
"locale": "en-us"
}
}
APIは新しい記事IDを返し、これを使用して添付ファイルを関連付けたり、翻訳を作成したりできます。
APIアプローチを使用する場合
APIメソッドは、以下に最適です。
- 開発リソースを持つ技術チーム
- 大規模な移行（数千の記事）
- 定期的な自動バックアップ
- データ変換を必要とする複雑な移行
一度に12の記事を移動するだけであれば、おそらくやりすぎです。
方法2：サードパーティアプリとツール
Pythonスクリプトの作成が得意でない場合は、Zendesk Marketplaceのいくつかのアプリで、視覚的なインターフェイスを使用してインポートとエクスポートを処理できます。
ZenplatesによるHelp Center Import
ZenplatesのHelp Center Importアプリは、1回限りの99ドルの購入で、コンテンツを一括でインポートするための視覚的なインターフェイスを提供します。以下をサポートしています。
- インポートあたり最大500のカテゴリ
- インポートあたり最大500のセクション
- インポートあたり最大1,000の記事
- インポートあたり最大1,000の記事コメント
ワークフローは簡単です。手動で、CSVファイルをインポートして、または別の公開Zendeskナレッジベースからプルして、インタラクティブなテーブルに行を作成することから始めます。テーブルでフィールドを直接編集したり、行を一括更新したり、フィールド値が無効な場合はすぐに視覚的なフィードバックを得ることができます。
データが正しく表示されたら、アプリで確認し（必要に応じてソートとフィルタリング）、[インポート]をクリックします。進行状況インジケーターにステータスが表示され、完了すると、新しく作成されたすべてのレコードIDを含む完了レポートが表示されます。
知っておくべき制限事項：
- 記事の添付ファイルはインポートされません（コンテンツのみ）
- 記事内のリンクと画像参照は変更されません
- コンテンツはプライマリブランドにのみインポートされます
- インポート後にインライン画像を確認する必要があります
CSV経由で別のプラットフォームからコンテンツを移動するチームにとって、このアプリは技術的な複雑さのほとんどを排除します。
kBackup
kBackupは、Felix Stubnerによる無料のアプリで、特にバックアップに焦点を当てています。軽量で、インストールは不要で、ワンクリックで動作します。
これはそれがすることです：
- Help Centerのコンテンツを[ArticleId].htmlという名前のHTMLファイルとしてエクスポートします
- 実行する前に、ユーザーがドメインに存在することを確認します（セキュリティ機能）
- ホストマッピングを使用している場合でも動作します（元のZendeskサブドメインを使用します）
- 完全に安全な読み取り専用操作
このアプリは、翻訳ワークフローまたは定期的なバックアップのためにコンテンツのオフラインコピーを作成する必要がある場合に特に役立ちます。ただし、エクスポート専用です。コンテンツをZendeskにインポートし直す必要がある場合は、別のツールが必要になります。
**注：**アプリは2017年に最後に更新されたため、まだ動作しますが、積極的にメンテナンスされていません。
サードパーティアプリを使用する場合
アプリは、以下の場合に最適です。
- コードを書く代わりに視覚的なインターフェイスが必要な場合
- 移行が中規模の場合（数百のアイテム、数千ではない）
- CSVまたは別のZendeskインスタンスからインポートする必要がある場合
- 継続的なサービス料金よりも1回限りのコストを優先する場合
方法3：手動コピー＆ペーストとテーマのエクスポート
最も簡単なアプローチが最良のアプローチである場合があります。数記事を移動するだけであれば、APIを設定したりアプリを購入したりするよりも、手動でコピー＆ペーストする方が速い場合があります。
手動が理にかなっている場合
手動移行は、以下の場合にうまく機能します。
- 移行する記事が20〜30未満の場合
- セットアップ時間がコピー時間を超える1回限りの移動である場合
- いずれにせよ、移行中にコンテンツを大幅に編集する必要がある場合
テーマコードのエクスポート
Help Centerのテーマ（ルックアンドフィールを制御するHTML、CSS、およびJavaScript）をバックアップまたは移行する必要がある場合、Zendeskはそれ用の組み込みツールを提供しています。
Guide ProfessionalまたはEnterpriseプランでは、管理インターフェイスからテーマとマニフェストファイルを直接インポートおよびエクスポートできます。これにより、すべてのテーマコードを含むZIPファイルが提供されます。
下位層のプランの場合、コードを手動でコピーしてテキストエディタに貼り付ける必要があります。これらのプランでは、テーマコードへのAPIアクセスはありません。
手動アプローチの制限事項
- 大量のコンテンツの場合、時間がかかる
- メタデータ（作成者、作成日など）を保持する方法がない
- 画像と添付ファイルは個別に処理する必要があります
- 一括操作は不可能
移行を成功させるためのベストプラクティス
どの方法を選択しても、これらのプラクティスに従うことで、頭痛の種を減らすことができます。
最初に構造を計画する
インポートを開始する前に、カテゴリとセクションの階層をマッピングします。後で数百の記事を再編成するよりも、最初に構造を正しく理解する方がはるかに簡単です。
サンドボックスでテストする
Zendeskサンドボックス環境にアクセスできる場合は、最初にそこでインポートを実行します。これにより、ライブヘルプセンターに触れる前に、フォーマットの問題、リンク切れ、および権限の問題をキャッチできます。
画像と添付ファイルを慎重に処理する
ほとんどのインポート方法では、インライン画像またはファイルの添付ファイルは自動的に処理されません。通常、次のことを行う必要があります。
- インポートする前に、画像をパブリックサーバー（AWS S3など）でホストするか、
- 記事をインポートした後で添付ファイルを個別にアップロードするか、
- APIを使用して添付ファイルをアップロードし、新しいURLで記事のHTMLを更新します
作成者の属性を管理する
特定の作成者を含む記事をインポートする場合は、インポートする前に、それらのユーザーがZendeskアカウントに存在する必要があります。APIには、作成者の属性に有効なユーザーIDが必要です。
SEOのリダイレクトを設定する
別のプラットフォームから移行していて、記事のURLが変更される場合は、検索ランキングを維持するために301リダイレクトを設定します。ヘルプセンターが重要なオーガニックトラフィックを獲得している場合は、特に重要です。
一般的な問題とトラブルシューティング
慎重に計画しても、問題が発生する可能性があります。最も一般的な問題の処理方法を次に示します。
APIレート制限
スクリプトがレート制限に達した場合は、再試行ロジックで指数バックオフを実装します。Zendesk APIは、待機する時間を示すRetry-Afterヘッダーを返します。
フォーマットとHTMLのクリーンアップ
他のプラットフォームからインポートされたコンテンツは、多くの場合、乱雑なHTMLをもたらします。インポートする前にHTMLクリーナーでコンテンツを実行するか、後でフォーマットの問題を修正する時間を計画することを検討してください。
ユーザー権限エラー
権限エラーでインポートが失敗した場合は、以下を確認してください。
- APIトークンに適切な権限がある
- ユーザーアカウントにエージェントまたは管理者権限がある
- 正しいサブドメインを使用している（特にマルチブランド設定の場合）
移行後の画像リンク切れ
画像が古いプラットフォームでホストされていた場合、移行後に壊れます。画像を新しいホストに移行してURLを更新するか、APIを使用してZendeskの添付ファイルとしてアップロードします。
より良いアプローチ：eesel AIによる最新のAI搭載ナレッジ管理
すべての移行方法について言えば、これらは根本的な問題の回避策です。従来のヘルプセンターは、システム間でコンテンツを簡単に移動できるように設計されていませんでした。すべてのプラットフォームは、独自の形式、独自の構造、独自のやり方にあなたを閉じ込めます。
私たちは、これを根本から解決するためにeesel AIを構築しました。コンテンツをエクスポート、変換、およびインポートすることを強制する代わりに、eesel AIはすでに使用しているツールに直接接続します。既存のヘルプセンター、過去のサポートチケット、Confluenceドキュメント、Google Driveファイルから学習します。移行は必要ありません。
Zendeskアカウントにeesel AIを接続すると、すぐにコンテンツの学習を開始し、その知識に基づいて顧客の質問に答えることができます。後でSlack統合を追加したり、Notionワークスペースを接続したりすると、eesel AIはそれらのソースからも学習します。記事を1つもエクスポートせずに。
これは、次のことを意味します。
- 新しいチャネルを追加するときに、移行の頭痛の種がなくなる
- 複数の場所に同じコンテンツを維持する必要がなくなる
- どのプラットフォームに「マスター」コピーがあるかを心配する必要がなくなる
コンテンツは今日存在する場所に残ります。eesel AIは、最前線のサポートを処理したり、チームの返信を下書きしたり、Slackで従業員の質問に答えたりできるAIエージェントを通じてアクセスできるようにするだけです。
ナレッジベースを移動させるためにCSVファイルやAPIスクリプトと格闘するのにうんざりしている場合は、別のアプローチを試す時期かもしれません。eeselの動作を確認し、数週間ではなく数分で既存のツールに接続できます。
よくある質問
この記事を共有
Article by
Stevia Putri
Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.
