
Zendesk の顧客情報インポート/エクスポート機能を実際に試してみた
はじめに
本記事では、Zendesk のインポート/エクスポート機能について、実際にユーザーデータをダウンロードし、その構造を確認する検証を行います。公式ドキュメントには機能の説明がありますが、実際のデータ形式を見る機会は少ないため、具体的なファイル例を交えて解説します。
Zendesk とは
Zendesk は、カスタマーサポート業務を効率化するクラウド型のカスタマーサービスプラットフォームです。チケット管理、ナレッジベース、レポート機能などを提供し、顧客対応の一元管理を実現します。
対象読者
- Zendesk の導入を検討している方
- データ移行やバックアップを計画している方
- インポート/エクスポート機能の実際の動作を確認したい方
参考
ユーザーのインポート
Zendesk では、データをインポートする際に CSV ファイルを使用します。
管理センター > メンバー > 一括アクション > ユーザーのインポート からインポートを実施します。

インポートに使用する CSV の例は以下の通りです。
name*,email*,ticket_restriction*,external_id,details,phone,role
Importer Test,importer-test@example.com,requested,,インポートのテストです,+810123456789,End-user
* マークは必須項目(コピーするときは * マークを削除してください)
より詳細な仕様は Zendesk 公式ページ をご確認ください。
インポート検証
上記の CSV を実際にインポートし、「顧客」に追加されることを確認しました。今回は role として End-user を指定したので、こちらに追加されます。


ユーザーのエクスポート
データのエクスポートは、管理センター > アカウント > ツール > レポート から実行します。 ユーザーのエクスポートには JSON 形式または XML 形式を使用します。(CSV によるエクスポートはチケット情報のみ対応)

JSON 解説
JSON 形式でエクスポートすると以下のような結果が取得できました。
JSON データ例
{
    "id": 01234567890123,
    "url": "https://subdomain.zendesk.com/api/v2/users/****.json",
    "name": "テスト 太郎",
    "email": "test.taro@example.com",
    "created_at": "2024-12-02T08:10:44.000Z",
    "updated_at": "2024-12-02T08:10:44.000Z",
    "time_zone": "Tokyo",
    "iana_time_zone": "Asia/Tokyo",
    "phone": null,
    "shared_phone_number": null,
    "photo": null,
    "locale_id": 67,
    "locale": "ja",
    "role": "end-user",
    "verified": true,
    "external_id": null,
    "tags": [],
    "alias": null,
    "active": true,
    "shared": false,
    "shared_agent": false,
    "last_login_at": null,
    "two_factor_auth_enabled": null,
    "signature": null,
    "details": null,
    "notes": null,
    "role_type": null,
    "custom_role_id": null,
    "moderator": false,
    "ticket_restriction": "requested",
    "only_private_comments": false,
    "restricted_agent": true,
    "suspended": false,
    "default_group_id": null,
    "report_csv": false,
    "user_fields": {
        "address": null,
        "admin_approved": false,
        "car": null,
        "company": null,
        "department": null,
        "industry": null,
        "s3_link1": null,
        "s3_link2": null,
        "test": null,
        "title": null,
        "user_multi_test": null,
        "user_test": null
    },
    "abilities": {
        "url": "https://subdomain.zendesk.com/api/v2/users/****.json",
        "user_id": 01234567890123,
        "can_edit": true,
        "can_edit_password": true,
        "can_manage_identities_of": true,
        "can_verify_identities": true,
        "can_reset_password": true,
        "can_set_password": true,
        "can_create_password": true,
        "can_change_password": true,
        "can_set_alias": true,
        "can_send_verification_email": true,
        "can_verify_now": true,
        "can_make_comment_private": true,
        "can_edit_agent_forwarding": true,
        "can_modify_user_tags": true,
        "can_assume": true,
        "can_delete": true,
        "can_view_views": false,
        "can_view_reports": true,
        "can_export": false,
        "can_use_voice_console": false,
        "voice_enabled_account": true,
        "can_use_voice": false,
        "can_view_voice_dashboard": false,
        "can_manage_people": true,
        "can_access_organization_list": false,
        "can_view_ticket_comment_original_email": true,
        "has_data_masking_configured_in_role": false
    },
    "organization": null
}
XML 解説
XML 形式でエクスポートすると以下のような結果が取得できました。
XML データ例
<user>
  <id type="integer">01234567890123</id>
  <is-active type="boolean">true</is-active>
  <roles type="integer">2</roles>
  <name>テスト 太郎</name>
  <time-zone>Tokyo</time-zone>
  <updated-at type="dateTime">2025-10-10T16:05:12+09:00</updated-at>
  <created-at type="dateTime">2023-07-14T10:06:31+09:00</created-at>
  <external-id nil="true"/>
  <details></details>
  <openid-url nil="true"/>
  <notes></notes>
  <restriction-id type="integer">0</restriction-id>
  <locale-id type="integer">67</locale-id>
  <last-login type="dateTime">2025-10-10T16:05:12+09:00</last-login>
  <current-tags></current-tags>
  <email>test.taro@example.com</email>
  <is-verified type="boolean">true</is-verified>
  <custom-role-id type="integer">01234567890123</custom-role-id>
  <groups type="array">
    <group>
      <id type="integer">01234567890123</id>
      <is-active type="boolean">true</is-active>
      <name>テストグループ</name>
      <updated-at type="dateTime">2025-05-19T15:20:08+09:00</updated-at>
      <created-at type="dateTime">2023-07-14T10:06:41+09:00</created-at>
      <description></description>
      <is-public type="boolean">true</is-public>
    </group>
  </groups>
  <photo-url></photo-url>
  <uses-12-hour-clock>false</uses-12-hour-clock>
  <phone/>
  <organization-id>01234567890123</organization-id>
</user>
まとめ
本記事では、Zendesk のインポート/エクスポート機能について、実際のファイル例を交えて解説しました。データ移行やバックアップを計画する際は、まず小規模なテストデータでインポート/エクスポートを試し、実際のファイル構造を確認することをおすすめします。












