Zendesk の顧客情報インポート/エクスポート機能を実際に試してみた

Zendesk の顧客情報インポート/エクスポート機能を実際に試してみた

Zendesk のエンドユーザー情報について 「既存情報の取得」 「外部から新規で一括登録」 を実施する方法について、実際のファイルの中身を確認しながら解説します。
2025.10.10

はじめに

本記事では、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 を指定したので、こちらに追加されます。

インポート結果1

インポート結果2

ユーザーのエクスポート

データのエクスポートは、管理センター > アカウント > ツール > レポート から実行します。 ユーザーのエクスポートには 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 のインポート/エクスポート機能について、実際のファイル例を交えて解説しました。データ移行やバックアップを計画する際は、まず小規模なテストデータでインポート/エクスポートを試し、実際のファイル構造を確認することをおすすめします。

この記事をシェアする

FacebookHatena blogX

関連記事

Zendesk の顧客情報インポート/エクスポート機能を実際に試してみた | DevelopersIO