Zendeskヘルプセンターのコンテンツをエクスポートしようとしている場合、すでに不満の残る真実に気づいているかもしれません。Zendeskはネイティブのエクスポートツールを提供していません。公式ドキュメントには、「記事をエクスポートするためのプリビルドされたZendeskツールはありません」と明記されています。
では、ナレッジベースをバックアップしたり、新しいプラットフォームに移行したり、オフラインドキュメントを作成したりする必要がある場合はどうすればよいでしょうか？主なオプションは4つあり、それぞれが異なる状況に適しています。
このガイドでは、4つの方法すべてについて説明します。Help Center APIの使用（技術チーム向け）、無料のサードパーティ製アプリのインストール（迅速なエクスポート向け）、移行サービスの利用（複雑な転送向け）、PDFの生成（ユーザーマニュアル向け）です。また、Zendeskのためのeesel AIのような最新のAIナレッジマネジメントツールが、エクスポートの問題を完全になくす方法についても見ていきます。
Zendeskヘルプセンターをエクスポートする必要がある理由
方法に入る前に、理由を見てみましょう。チームがヘルプセンターのコンテンツをエクスポートする一般的な理由はいくつかあります。
- 大規模な再構築またはプラットフォームの変更前のバックアップの作成
- 多言語サポートのためのコンテンツの翻訳（翻訳者にはクリーンなHTMLが必要です）
- Zendeskから別のヘルプデスクへの切り替え時のプラットフォームの移行
- リンク切れ、古い記事、またはカバレッジのギャップを見つけるためのコンテンツの監査
- 必要な顧客向けのPDFユーザーマニュアルのようなオフラインドキュメントの生成
各ユースケースは、異なるエクスポート方法を示しています。オプションを分解してみましょう。
方法1：Zendesk Help Center APIの使用
Help Center APIは、コンテンツをエクスポートするためのZendeskの公式推奨事項です。強力で無料ですが、実装には技術的な知識が必要です。
必要なもの
- コンピューターにインストールされたPython
- コマンドラインツールの基本的な知識
- Zendesk APIトークン（管理センターから生成）
requestsおよびpandasPythonライブラリ
仕組み
APIアプローチでは、Zendeskアカウントで認証し、Help Center APIエンドポイントを介して記事データをプルし、選択したファイル形式（通常はJSONまたはCSV）に保存するPythonスクリプトを作成します。
主要なAPIエンドポイントは次のとおりです。
GET /api/v2/help_center/articlesすべての記事を一覧表示しますGET /api/v2/help_center/incremental/articles.json時間の経過に伴う変更を追跡するため
プロセス
まず、APIトークンを生成します。管理センター > チャネル > APIに移動し、必要に応じてトークンアクセスを有効にして、新しいトークンを作成します。すぐにコピーしてください（Zendeskは一度しか表示しません）。
次に、必要なPythonライブラリをインストールします。
pip install requests pandas
次に、サブドメイン、メール、APIトークンを使用してスクリプトを構成します。スクリプトはすべての記事をページネーション処理し（Zendeskはリクエストごとに100件を返します）、選択した形式にコンパイルします。
知っておくべき制限事項
APIメソッドにはいくつかの注意点があります。デフォルトでは、OAuth認証は公開されたコンテンツのみをエクスポートします。内部記事または下書き記事が必要な場合は、代わりにBasic Authを使用する必要があります。文字エンコーディングも問題になる可能性があります。スクリプトをUTF-8として保存して、特殊文字を含むUnicodeエラーを回避してください。
この方法は、自動化された定期的なエクスポートまたはカスタムデータ形式を必要とする開発者がいるチームに最適です。
方法2：Swifteq Help Center Export（無料アプリ）
Pythonスクリプトの作成が苦手な場合は、Swifteq Help Center Exportがノーコードの代替手段を提供します。これは、数回クリックするだけでCSVエクスポートを生成するZendesk Marketplaceの無料アプリです。
主な機能
- メタデータ（タイトル、セクション、リンク、ラベル、更新時間）を含むすべての記事をエクスポートします
- 内部および外部のリンク切れを検出します
- 壊れた画像とビデオを識別します
- 複数の言語をサポートします
- 使用制限なしで100％無料
使い方
- Zendesk Marketplaceからアプリをインストールします
- 無料のSwifteqアカウントにサインアップします
- ヘルプセンターのデータを読み取るためのアプリを承認します（読み取り専用アクセス）
- エクスポートが処理されるのを待ちます（通常は数分）
- CSVファイルをメールで受信します
CSVを使用すると、ナレッジベース全体を俯瞰できます。ExcelまたはGoogleスプレッドシートで開いて、コンテンツを監査したり、最終更新日を確認したり、すべての記事でリンク切れを見つけたりできます。
ユーザーの声
このアプリは、Zendesk Marketplaceで17件のレビューから5つ星の評価を得ています。あるユーザーは、「Guideの記事をエクスポートするのに最適でした。APIをいじったり、JSONをCSVに変換したり、再フォーマットしたりするよりもはるかに便利です」と述べています。
制限事項
無料版では、公開記事のリンク切れのみがチェックされます。内部記事を監査する必要がある場合は、Swifteqの有料Help Center Managerアプリ（月額89ユーロから）が必要です。エクスポートもCSVのみです。無料版にはPDFまたはHTMLオプションはありません。
方法3：複雑な転送のための移行サービス
大規模な移行またはプラットフォーム間の転送の場合、多くの場合、専門の移行サービスが理にかなっています。Help Desk Migrationは、チームからの技術的な作業を必要とせずに、プラットフォーム間でヘルプデスクデータを移動することを専門としています。
移行サービスを検討する場合
- Zendeskから別のヘルプデスクプラットフォームへの移行
- 長年の履歴コンテンツの転送
- 複雑な記事の階層とメタデータを保持する必要がある
- APIスクリプトを作成するための技術的なリソースがない
- 移行中のダウンタイムをゼロにしたい
仕組み
Help Desk Migrationは、プロセスをガイドするノーコードの移行ウィザードを使用します。
- 評価 Zendesk Guideの構造を分析します
- 準備 API資格情報を収集し、ターゲットプラットフォームの互換性を確認します
- 構成 プラットフォーム間でデータフィールドをマッピングします
- デモ移行 小さなデータセットでテストします（無料）
- 完全移行 自動転送を完了します
- 検証 新しいプラットフォームでコンテンツを確認します
このサービスは90以上のプラットフォームをサポートし、転送中に記事の階層、添付ファイル、タグ、および書式設定を維持します。
価格設定
Help Desk Migrationは、データ量に基づいてカスタム価格を提供します。コミットする前にプロセスをテストできるように、無料のデモ移行を提供しています。大規模なエンタープライズ移行（200,000件以上のレコード）の場合、顧客は、節約された時間とエラー削減でサービスがペイすると報告しています。
顧客からのフィードバック
このサービスは、G2で5つ星の評価を得ています。あるエンタープライズIT管理者は、「私が10年間で経験した中で最高の移行体験でした。非常に印象的なツール、非常にリーズナブルな価格で素晴らしいチーム。ServiceNowからFreshServiceに10年以上のデータを迅速に移行することができました」と書いています。
方法4：ユーザーマニュアル用のPDFエクスポート
印刷可能なドキュメント、コンプライアンス要件、またはオフラインユーザーマニュアルを必要とする顧客のために、ヘルプセンターのコンテンツをPDF形式で必要とする場合があります。Kolibri DigitalのKnowledge Base to PDFアプリは、この特定のユースケースを処理します。
ユースケース
- オンラインナレッジベースの使用を拒否する顧客
- 印刷可能な製品ドキュメント
- 複数の製品バージョンを同時にサポートする
- コンプライアンスドキュメントの要件
仕組み
- Knowledge Base to PDFアプリをZendesk Marketplaceからインストールします
- 左側のナビゲーションバーからアプリにアクセスします
- PDFフロントページのタイトルを設定します
- 必要に応じて、含める特定のカテゴリを選択します（またはすべてをエクスポートします）
- 「ユーザーマニュアルを作成」をクリックして、PDFをダウンロードします
処理には、ナレッジベースのサイズに応じて、数秒から1分かかります。
カスタムブランディング
PDFを会社の視覚的アイデンティティに合わせたい場合は、Kolibriがカスタムブランディングサービスを提供しています。カスタムブランドキーを受け取ったら、生成するすべてのPDFに適用できます。
制限事項
Zendesk APIの制限により、アプリは非アクティブ化または制限されたヘルプセンターからエクスポートできません。カスタムブランディングには、追加のサービス料金も必要です。
エクスポート方法の比較
適切なアプローチを選択するのに役立つ簡単な比較を次に示します。
| 方法 | 最適 | 技術レベル | コスト | 出力形式 |
|---|---|---|---|---|
| Help Center API | 開発者、自動化 | 高 | 無料 | JSON/CSV |
| Swifteq Export | 迅速な監査、バックアップ | なし | 無料 | CSV |
| 移行サービス | プラットフォームの転送 | なし | カスタム見積もり | 各種 |
| PDFアプリ | ユーザーマニュアル | 低 | 有料アドオン |
一般的な問題とトラブルシューティング
OAuthとBasic Auth
APIメソッドを使用している場合に内部記事にアクセスできない場合は、OAuthからBasic Authに切り替えます。OAuthはデフォルトで公開されたコンテンツのみを対象とし、Basic Authは内部記事と下書き記事を取得できます。
文字エンコーディングエラー
Unicodeエラーは通常、スクリプトがUTF-8として保存されていないことを意味します。VS CodeやSublime Textなどのコードエディターを使用し、保存時にエンコーディングを明示的にUTF-8に設定します。
レート制限
ZendeskのAPIにはレート制限があります。429エラーが発生した場合は、リクエスト間に60秒の遅延を入れて再試行ロジックを実装します。
データがありません
エクスポートに記事がない場合は、API資格情報に正しい権限があることを確認してください。また、ページネーションが正しく処理されていることを確認してください。Zendeskはデフォルトでページあたり100件の記事を返します。
より良い方法：eesel AIによるAI搭載のナレッジマネジメント
これらのエクスポート方法すべてについて言えることは、根本的な制限に対する回避策であるということです。ナレッジベースのコンテンツを別の場所（分析、翻訳、移行、またはAIトレーニング）で必要とするため、エクスポートしています。
しかし、エクスポートする必要がない場合はどうでしょうか？
eesel AIは、別のアプローチを取ります。Zendeskヘルプセンターをエクスポートする代わりに、当社のAIが直接統合されます。コンテンツをその場で読み取って理解するため、手動エクスポートは不要になります。
仕組み
eesel AIをZendeskヘルプセンターに数分で接続します。当社のAIは、記事、過去のチケット、およびマクロから学習します。エクスポート、ファイル転送、手動データ準備は不要です。AIは、ビジネスコンテキスト、トーン、および一般的な問題を初日から理解します。
できること
接続すると、eesel AIは次のことができます。
- ヘルプセンターのコンテンツを使用して、顧客の質問に直接回答します
- サポートエージェントの返信を下書きします
- ヘルプセンターに記事がないナレッジギャップを特定します
- 成功したチケット解決に基づいて、新しいヘルプセンターコンテンツを生成します
- 同じナレッジベースから複数のプラットフォーム（Zendesk、Slack、Webサイト）で動作します
本当の利点
従来のエクスポートでは、静的なスナップショットが作成されます。ヘルプセンターは変更されますが、エクスポートされたファイルは変更されません。eesel AIは自動的に最新の状態を維持します。記事を更新すると、AIはすぐに認識します。再エクスポートは不要です。バージョン管理の頭痛の種はありません。
AIトレーニングまたは移行のためにエクスポートを検討しているチームにとって、eesel AIのアプローチは複雑さを完全に取り除きます。データ操作なしで、AI搭載サポートのメリットを得られます。
ニーズに合ったエクスポート方法の選択
決定を簡素化しましょう。
- 開発者がいて、自動化された定期的なエクスポートが必要な場合は、APIメソッドを選択してください
- 監査またはバックアップのために無料のシンプルなCSVエクスポートが必要な場合は、Swifteqを選択してください
- プラットフォームを移行していて、複雑なデータを保持する必要がある場合は、移行サービスを選択してください
- オフラインドキュメントが特に必要な場合は、PDFアプリを選択してください
- AIをトレーニングしたり、コンテンツを分析したりするためにエクスポートする場合は、eesel AIを検討してください。エクスポート手順を完全に取り除きます
適切な選択は、技術リソース、予算、および達成しようとしていることによって異なります。1回限りの監査またはバックアップを実行するほとんどのチームにとって、Swifteqの無料アプリが最も迅速な方法です。複雑な移行の場合、専門サービスは節約された時間と回避されたエラーでペイします。
