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