Zendeskからデータをエクスポートする方法：2026年完全ガイド

長年の顧客との会話をバックアップする場合でも、ヘルプデスクの移行を準備する場合でも、コンプライアンスのためにデータが必要な場合でも、Zendeskのデータをエクスポートすることは、ほとんどのサポートチームが最終的に直面するタスクです。課題は、データを取得することだけではありません。どの方法を使用するか、実際に何を取得できるか、および制限事項を理解することです。

このガイドでは、組み込みのUIオプションからAPIベースのソリューションやサードパーティツールまで、Zendeskからデータをエクスポートするすべての方法について説明します。各方法の正確な手順を説明し、トレードオフを説明し、特定の状況に最適なアプローチを選択するのに役立ちます。

傾向を分析したり、AIモデルをトレーニングしたりするために、頻繁にデータをエクスポートしている場合は、より良い方法があります。 eesel AIのような最新のAIプラットフォームは、Zendeskアカウントに直接接続し、ファイルをエクスポートすることなく、過去のチケットから学習できます。過去の会話でトレーニングされたAIエージェントをデプロイすることもできます。

まずは従来の方法から始めましょう。

必要なもの

始める前に、以下を確認してください。

• 適切なプラン権限を持つZendeskアカウント（各方法の具体的な内容を説明します）
• データのエクスポートをリクエストしたり、APIトークンを生成したりするための管理者アクセス
• プログラムによる方法を使用している場合はAPIトークン（作成方法を説明します）
• **オプション：**カスタムエクスポートスクリプトを実行する場合は、PythonまたはNode.jsがインストールされていること

要するに、Teamプランを使用している場合は、APIを使用する必要があります。ProfessionalおよびEnterpriseプランでは、ネイティブのエクスポートUIを使用できますが、それでもAPIの方が制御性が高いことがよくあります。

方法1：ネイティブデータエクスポート（JSON、CSV、XML）

Zendeskのネイティブエクスポート機能は、アクセスできる場合は最も簡単なオプションです。ただし、注意点があります。ProfessionalおよびEnterpriseプランでのみ利用可能です。Teamプランを使用している場合は、方法3（API）に進んでください。Zendeskのエクスポート要件の詳細については、公式ドキュメントを参照してください。

ステップ1：データエクスポートを有効にする

データエクスポートは、対象となるプランでもデフォルトでは有効になっていません。アカウントの所有者は、Zendeskカスタマーサポートに連絡して、アクティベーションをリクエストする必要があります。リクエストにはZendeskのサブドメインを含めてください。

有効にすると、数時間以内に管理センターにエクスポートが表示されます。

ステップ2：エクスポートを実行する

1. 管理センター > アカウント > ツール > レポートに移動します。
2. エクスポートタブが表示されている場合はクリックします（一部のレガシーバージョンでは、エクスポートが別のタブに表示されます）。
3. エクスポート形式を選択します。

4. 期間を設定します（JSONおよびCSVのみ）。
5. データ型を選択します：チケット、ユーザー、または組織。
6. エクスポートをクリックします。

ニーズに基づいて適切な形式を選択してください。JSONは大規模なデータセットを処理し、コメントを含みます。CSVはExcel分析に最適ですが、フィールドが制限されています。XMLはレガシー互換性を提供しますが、ファイルサイズの上限は500MBです。

ステップ3：ファイルをダウンロードする

エクスポートが完了すると、Zendeskからダウンロードリンクがメールで送信されます。リンクは少なくとも3日間有効です。データ量によっては、大規模なエクスポートには数分から1日以上かかる場合があります。

知っておくべき重要な制限事項：

• 添付ファイルはエクスポートに含まれません
• 保留中のチケットは除外されます
• 1MBを超えるチケットはコメントが削除されます
• 100万件以上のチケットを持つアカウントは、31日間の増分に制限されます

方法2：Zendesk Exploreからのエクスポート

完全なバックアップではなく、分析用の詳細なデータが必要な場合は、Zendesk Exploreを使用すると、より柔軟なオプションが提供されます。ネイティブエクスポートと同様に、これにはProfessionalまたはEnterpriseプランが必要です。

利用可能なもの

Exploreを使用すると、データセット（レポートだけでなく）をCSV形式でエクスポートできます。利用可能なデータセットは次のとおりです。

• サポートチケットとSLAデータ
• チャットとメッセージングのエンゲージメント
• Talk通話記録
• Guideナレッジベースの記事
• Answer Botのインタラクション

主な利点：データセットのエクスポートには、標準レポートにある50,000行の制限はありません。

エクスポートの作成

1. Exploreで、左側のサイドバーにあるデータセットのエクスポートアイコンをクリックします。
2. 1回限りのエクスポートを作成または定期的なエクスポートを作成を選択します。
3. データセットと期間を選択します。
4. 定期的なエクスポートの場合は、頻度（毎日、毎週、または毎月）を設定します。

データセットのエクスポートワークフローを使用すると、定期的なレポートをスケジュールしたり、1回限りの抽出を実行したりできます。データセットを選択し、期間を設定し、エクスポート頻度を選択します。

重要な詳細：

• データセットごとに1か月に1回エクスポートを実行できます
• 定期的なエクスポートは、14の同時スケジュールに制限されています
• ファイルは7日後に自動的に削除されます
• 各ファイルは最大3回ダウンロードできます

方法3：Zendesk APIの使用

Zendesk APIは最も強力なオプションであり、Teamを含むすべてのプランで利用できます。これは、下位層のプランを使用している場合、エクスポートを自動化する必要がある場合、またはエクスポートする前にデータをフィルタリングする場合に取るべきルートです。

APIアクセスの設定

1. 管理者としてZendeskにサインインします。
2. 管理センター > アプリとインテグレーション > API > Zendesk APIに移動します。
3. [設定]タブでトークンアクセスを有効にします。
4. APIトークンを追加をクリックし、名前を付けて、トークンを安全に保存します。

インクリメンタルエクスポート

定期的なエクスポートに最も効率的なアプローチは、インクリメンタルエクスポートAPIを使用することです。毎回すべてのデータをプルする代わりに、前回のエクスポート以降に変更されたもののみをリクエストします。

ユーザーをエクスポートするための基本的なPythonの例を次に示します。

import csv
import time
import requests

ZENDESK_USER_EMAIL = 'your_email@example.com'
ZENDESK_API_TOKEN = 'your_api_token'
ZENDESK_SUBDOMAIN = 'your_subdomain'

def main():
    print('Getting users from Zendesk...')
    users = []
    url = f'https://{ZENDESK_SUBDOMAIN}.zendesk.com/api/v2/users.json'
    params = {'page[size]': 100}
    auth = (f'{ZENDESK_USER_EMAIL}/token', ZENDESK_API_TOKEN)

    response = requests.get(url, params=params, auth=auth)
    page = response.json()
    users.extend(page['users'])

    while page['meta']['has_more']:
        params['page[after]'] = page['meta']['after_cursor']
        response = requests.get(url, params=params, auth=auth)
        if response.status_code == 429:  # Rate limit
            time.sleep(int(response.headers['retry-after']))
            response = requests.get(url, auth=auth)
        page = response.json()
        users.extend(page['users'])

    write_to_csv(users)
    print('Done!')

def write_to_csv(users):
    with open('users.csv', 'w', newline='') as file:
        writer = csv.writer(file)
        writer.writerow(['Name', 'Email', 'Role'])
        for user in users:
            writer.writerow([user['name'], user['email'], user['role']])

if __name__ == "__main__":
    main()

**レート制限：**すべてのプランで、1分あたり700リクエスト（1秒あたり10リクエスト）を取得できます。上記のスクリプトは、HTTP 429応答をチェックし、推奨される時間待機することで、レート制限を処理します。

エクスポート形式と制限事項の理解

各エクスポート形式には、データの使用方法に影響を与える明確な特性があります。

JSON（NDJSON形式）

JSONエクスポートは、「Newline Delimited JSON」（NDJSON）を使用します。これは、すべてを単一の配列にラップするのではなく、1行に1つのオブジェクトをストリーミングします。これにより、ファイル全体をメモリにロードせずに、大規模なファイルを処理できます。

NDJSONを標準のJSONに変換するには、オブジェクトを配列でラップします。

{"ticket":{"id":1}}
{"ticket":{"id":2}}

次のようになります。

{
  "tickets": [
    {"ticket": {"id": 1}},
    {"ticket": {"id": 2}}
  ]
}

CSV

CSVエクスポートは、ExcelまたはGoogleスプレッドシートで開くのが最も簡単ですが、制限が最も多くあります。

• チケットのコメントまたは説明がない
• 削除されたチケットがない
• 複数行のテキストフィールドは除外されます
• すべてのタイムスタンプは、アカウントのデフォルトのタイムゾーンを使用します

すべてのエクスポートから欠落しているもの

どの方法を選択しても、一部のデータはエクスポートに含まれません。

• **添付ファイル：**ファイルはAPI経由で個別にフェッチする必要があります
• **保留中のチケット：**これらは意図的に除外されています
• **AIエージェントのチケット：**まったくエクスポートできません
• **リアルタイム更新：**エクスポートの6分以内に更新されたアイテムは欠落している可能性があります

サードパーティのエクスポートツール

ネイティブオプションが不十分な場合、サードパーティツールがギャップを埋めることができます。

オープンソースオプション

GitHubのZendesk-Exporterプロジェクトは、チケット、コメント、ユーザー、ビュー、トリガー、マクロなどをJSONにエクスポートするNode.jsツールです。無料のMITライセンスであり、APIのページネーションとレート制限を処理します。

eDiscoveryプラットフォーム

法的およびコンプライアンスのユースケースでは、OnnaのようなプラットフォームがZendeskのAPIに直接接続し、完全なコンテキストで検索可能なリポジトリを提供します。ネイティブエクスポートには添付ファイルが含まれておらず、法的訴訟には不十分な他のギャップがあるため、これはeDiscoveryに必要になることがよくあります。

移行ツール

ヘルプデスクを完全に切り替える場合は、多くのプラットフォーム（eesel AIを含む）が、API抽出を処理するZendeskの直接インポートを提供しています。これは通常、ファイルにエクスポートしてからインポートするよりも簡単です。

エクスポートされたデータの一般的なユースケース

さまざまな状況で、さまざまなエクスポートアプローチが必要です。

自信を持ってZendeskデータをエクスポートする

意思決定プロセスを分解してみましょう。

• Teamプランを使用していますか？ APIを使用してください。これは唯一のオプションですが、最も柔軟性があります。
• 完全なバックアップが必要ですか？ ネイティブUI（Pro/Ent）またはAPIベースのツールを介したJSONエクスポート。
• スケジュールされたレポートが必要ですか？ 定期的なスケジュールでExploreデータセットをエクスポートします。
• 法的/コンプライアンス要件？ サードパーティのeDiscoveryプラットフォームが最適です。
• 新しいヘルプデスクに移行しますか？ 新しいプラットフォームがZendeskの直接インポートを提供しているかどうかを最初に確認してください。

ニーズを満たす最も簡単な方法から始めてください。ネイティブエクスポートは、1回限りのバックアップに最適です。APIは自動化に適しています。サードパーティツールは、Zendeskがネイティブで提供する以上のものが必要な場合にギャップを埋めます。

傾向を分析したり、情報を他のシステムにフィードしたりするために、定期的にデータをエクスポートしている場合は、直接統合によって時間を節約できるかどうかを検討してください。たとえば、eesel AIはZendeskに直接接続し、エクスポートファイルを管理することなく、過去のチケットから学習します。

データに関する質問をしたり、レポートを生成したり、過去の会話でAIエージェントをトレーニングしたりすることもできます。エクスポートとインポートのダンスは必要ありません。

どの方法を選択する場合でも、最初に小さなデータセットでテストしてください。完了に数時間かかる可能性のある完全なエクスポートを実行する前に、期待どおりの結果が得られていることを確認してください。