組織の一括インポート

現在のプランを確認

組織を1つずつ追加するのではなく、CSV（カンマ区切り値）ファイルをインポートすることで、複数の組織を一度に一括追加できます。一括インポートを使用して、組織の追加や組織の更新ができます。組織を一括インポートできるのは管理者だけです。複数のユーザーと複数のカスタムオブジェクトレコードを一度に追加または更新することもできます。

メモ：組織とユーザーの両方を一括インポートする場合は、組織を先に一括インポートする必要があります。ユーザーの一括インポートの詳細については、「ユーザーの一括インポート」を参照してください。

組織の一括インポートは元に戻せません。すべての組織の情報を含むCSVファイルをインポートする場合は、まず、1つの組織レコードを使用して同じCSVファイルのアップロードを試してみて、アップロードが意図したとおりに動作することを確認してください。

この記事では、以下のトピックについて説明します。

• ユーザーおよび組織の一括インポートに伴う制限
• CSVファイルの組織データを作成する
• 組織データのCSVファイルをインポートする

ユーザーおよび組織の一括インポートに伴う制限

ユーザーと組織に関する主要なデータセットをインポートできます。たとえば、一括インポートを使用して、後述の表に示すデータをインポートできます。ただし、タイムゾーン、写真、言語設定などはインポートできません。後述の表にないデータをインポートするには、代わりにZendesk REST APIを使用する必要があります。「Importing users with the Zendesk API（Zendesk APIを使用したユーザーのインポート）」または「Importing organizations with the Zendesk API（Zendesk APIを使用した組織のインポート）」を参照してください

また、一括インポートには、以下の制限もあります。

• 最大行数はインポート方法によって異なります。
  • 「一括アクション」ページを使用して新規および既存のユーザーおよび組織データをインポートする場合、インポートCSVデータファイルには最大2,000行を含めることができます。つまり、ヘッダー1行とデータ1,999行までです。
  • データインポーターを使用して新規や既存のユーザーと組織のデータをインポートする場合、インポートCSVファイルのサイズは1GBを超えることはできません。最大500,000行を推奨します。つまり、1行のヘッダーと最大499,999行のデータです。さらに、各行のサイズは128 KBを超えることはできません。
• データインポーターを使用する場合は、次の制限も適用されます。
  • インポートCSVファイルに含める列は、最大で200列です。
  • インポートCSVファイルでは、行のインポート順序は保証されません。
• CSVファイル内に同じユーザーや組織のデータを重複して含めないでください。インポートに失敗する可能性があります。
• CSVファイルに表示された順序でレコードが作成または更新される保証はありません。
• 一度にインポートできるCSVファイルは1つだけです。そのため、CSVファイルでサポートされている最大行数を超えるデータがある場合は、バッチごとに別々のファイルを作成し、順次インポートする必要があります。データインポーターを使用していない場合は、最大2つのバッチがキューに入れられ、バックグラウンドで実行されます。2つ以上のバッチをインポートしたい場合は、最初のバッチのインポートが完了するまで待ってから追加する必要があります。
• FacebookまたはX（旧Twitter）アカウントからの連絡先情報のインポートに、一括インポートを使用することはできません。代わりに、Zendesk REST APIを使用してください。「Importing users with the Zendesk API（Zendesk APIを使用したユーザーのインポート）」を参照してください。

CSVファイルの組織データを作成する

組織を一括インポートする場合、CSV形式の組織データファイルを使用します。このセクションでは、CSVデータファイルの設定方法について説明します。

ファイルを作成する際に注意すべき重要事項を以下に示します。

• このファイルは、適切なCSV形式であること、UTF-8エンコーディングを使用して保存されていることが必要です。
• CSVファイルの最初の行はヘッダー行です。
• ヘッダー行には、以下の表内の必須フィールドを必ず含めます。さらに、必須フィールド以外のフィールドも任意に選んで追加することができます。
• ヘッダー行では、インポート方法に応じて、domain_namesまたはdefaultのいずれかを使用します。これらを一緒に使うことはできません。
• データをインポートしないフィールドがある場合は、そのフィールドをヘッダー行に含めないでください。
• ファイル内に空のデータ列があると、組織の既存のデータが、空のデータで上書きされます。
• notes欄または複数行のカスタムフィールドに改行を追加するには、Alt + Enterキーを押すか（Windowsの場合）、Ctrl + Option + Returnキーを押します（macOSの場合）。

以下の表に、ファイルに含めることにできるフィールドを示します。

表1. 組織のインポート用データ

フィールド	説明
name	必須入力。組織の名前。
external_id	オプションだが推奨。将来データインポーターを使用してこれらのレコードを更新する場合に必要です。外部システムの従業員ID番号や顧客ID番号など、一意に識別される値。
notes	組織に関するメモ。メモを見ることができるのはエージェントだけです。エンドユーザーの画面には表示されません。
domain_names （データインポーターのみ）	住所など、組織に関する詳しい情報。この情報を見ることができるのはエージェントだけです。エンドユーザーの画面には表示されません。データインポーターを使用する際に、デフォルトのヘッダーの代わりに使用します。
default （データインポーターではない）	ユーザーと組織との対応付けに使用される情報。1つ以上のメールドメインをスペースで区切って入力してください（例：organization1.com organization2.com）。データインポーターを使用しない場合は、domain_namesヘッダーの代わりに使用します。 詳しくは「メールドメインに基づいて自動的にユーザーを組織に追加する」を参照してください。
shared （データインポーターではない）	TrueまたはFalseです。組織で組織で共有を有効にするかどうかを設定します。 「エンドユーザーのために組織で共有機能を設定する」を参照してください。
shared_comments （データインポーターではない）	TrueまたはFalseです。組織内のエンドユーザーが互いのチケットにコメントを追加できるようにします。sharedフィールドもtrueに設定する必要があります。 「エンドユーザーのために組織で共有機能を設定する」を参照してください。
group	組織のデフォルトグループを指定します。「グループを組織にマッピングする」を参照してください。
tags	（データインポーターではない）Zendesk Supportでユーザーと組織のタグ付けが有効になっている場合（「ユーザーおよび組織へのタグの追加」を参照）、組織にタグを設定できます。複数のタグを追加する場合は、スペースで区切ります。 組織を一括インポートすると、既存の組織タグがCSVファイル内のタグで上書きされます。これを避けるには、Tag APIを使用してタグを更新する方法があります。
	（データインポーターのみ）Zendesk Supportでユーザーと組織のタグ付けが有効になっている場合、組織にタグを設定できます。複数のタグはパイプ記号（ | ）で区切ります。 組織を一括インポートすると、既存の組織タグがCSVファイル内のタグで上書きされます。これを避けるには、Tag APIを使用してタグを更新する方法があります。
organization_fields.<フィールドキー> （データインポーターのみ）	組織の一括インポートを実行する場合、「organization_fields.」という接頭辞に続いてフィールドキーを指定することで、カスタム組織フィールドをインポートできます。  たとえば、subscription_dateというフィールドキーのフィールド値をインポートするには、次のように指定します。 organization_fields.subscription_date カスタム組織フィールドのキーを見つけるには、管理アイコン（）をクリックして「組織フィールド」を選択し、目的のカスタムフィールドの名前をクリックします。フィールドキーが、右側のプロパティパネルに表示されます。 フィールド値の形式が正しくない場合、インポートは失敗し、インポート履歴ログにエラーの詳細が表示されます。カスタム日付フィールドには、YY/MM/DDまたはYYYY-MM-DDの形式を使用してください。チェックボックスフィールドでは、TrueまたはFalseのいずれかを使用します。ドロップダウンフィールドの値を設定するには、ドロップダウンリストの作成時に追加したタグを使用します。 メモ：「データインポーター」ページで組織をインポートする場合、ルックアップリレーションシップフィールドはサポートされません。 詳しくは「組織プロフィールへのカスタムフィールドの追加」を参照してください。
custom_fields.<フィールドキー> （データインポーターではない）	組織の一括インポートを実行する場合、「custom_fields.」という接頭辞に続いてフィールドキーを指定することで、カスタム組織フィールドをインポートできます。  たとえば、subscription_dateというフィールドキーのフィールド値をインポートするには、次のように指定します。 custom_fields.subscription_date カスタム組織フィールドのキーを見つけるには、管理アイコン（）をクリックして「組織フィールド」を選択し、目的のカスタムフィールドの名前をクリックします。フィールドキーが、右側のプロパティパネルに表示されます。 フィールド値の形式が正しくない場合、インポートは失敗し、保存に失敗したレコードを示すエラーレポートがメールで送信されます。カスタム日付フィールドには、YY/MM/DDまたはYYYY-MM-DDの形式を使用してください。チェックボックスフィールドでは、TrueまたはFalseのいずれかを使用します。ドロップダウンリストオプションの値を設定するには、ドロップダウンリストの作成時に追加したタグを使用します。 メモ：インポートするカスタム組織フィールドがルックアップリレーションシップフィールドの場合、このフィールドの値として、関連オブジェクトのIDを入力します。たとえば、組織の場合は組織のIDを、ユーザーの場合はユーザーのIDを、カスタムオブジェクトレコードの場合はレコードのIDを入力します。組織、ユーザー、またはカスタムオブジェクトレコードのIDを検索するには、アカウントからデータをエクスポートするか、Organizations API、Users API、またはCustom Object Records APIを使用します。 「データインポーター」ページで組織をインポートする場合、ルックアップリレーションシップフィールドはサポートされません。 詳しくは「組織プロフィールへのカスタムフィールドの追加」を参照してください。

組織データのCSVファイルをインポートする

一括インポートを使用して、新しい組織を作成したり、既存の組織の情報を更新したりできます。

インポート操作がキューに追加され、組織は、インポート処理が完了したときにZendesk Supportに追加されます。この処理は、ファイルごとに1時間ほどかかりますが、ファイルサイズやキューサイズによって異なります。詳しくは「ユーザーおよび組織の一括インポートに伴う制限」を参照してください。

ユーザーを一括インポートするには、以下の方法があります。

• データインポーターを使用して組織データをインポートする
• 一括アクションインポートを使用して組織データをインポートする

データインポーターを使用して組織データをインポートする

データインポーターを使用してCSVファイルをインポートし、新しい組織の作成や既存の組織の更新を行ったり、「データインポーター」ページを使用してすべてのインポート試行のログを取得することができます。

データインポーターを使用して組織の作成や更新を行うには

1. 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「ツール」>「データインポーター」を選択します。
2. 「インポート」をクリックします。
3. 「保存先のターゲット」で、「組織」を選択します。
4. 「インポートタイプ」で、次のいずれかを選択します。
   • 作成のみ：新しい組織のみが作成されます。CSVファイル内の既存の組織に関するデータは無視されます。
   • 更新のみ：CSVファイルにリストされている既存の組織のデータを置き換えます。組織を更新するにはexternal_idが必要です。新しい組織に関するデータはすべて無視されます。
   • レコードの作成および更新：新しい組織を作成し、CSVファイルにリストされている既存の組織のデータを更新します。
5. 「ファイルのアップロード」で、ファイルをドラッグ＆ドロップするか、クリックしてアップロードし、ファイルブラウザからCSVファイルを選択します。

   選択したファイルを変更する必要がある場合は、ファイル名の横にある削除アイコン（）をクリックします。

6. 「次へ」をクリックします。
7. 「フィールドのマッピング」リストを確認します。
   • フィールドマッピングが正しければ、「次へ」をクリックします。
   • フィールドマッピングが正しくない場合は、「戻る」をクリックします。フォーマット要件に準拠するようにCSVファイルを編集し、ファイルを再アップロードします。
8. 確認ダイアログでインポートの詳細の概要を確認し、「インポートを開始する」をクリックします。

   インポートが開始された後は、インポートされた変更を元に戻すことはできません。インポートのステータスを確認するには、インポート履歴を確認してください。

一括アクションインポートを使用して組織データをインポートする

データインポーターを使用することをお勧めしますが、「一括アクション」ページを使用して、新しい組織データや更新された組織データをインポートすることもできます。このページからのインポートが完了すると、メールが届きます。

CSVインポートで組織を作成または更新するには

1. 管理センターで、サイドバーにある「 メンバー」をクリックし、「一括アクション」>「組織のインポート」を選択します。
2. 実行するインポートのタイプを選択します。

   • 組織を新規作成

   • 既存の組織を更新：​このタイプのインポートを使用して、CSVファイルにリストされている組織の既存のデータを置き換えます。

     組織を識別できるように、組織のexternal_idフィールドかnameフィールドをCSVに含める必要があります。組織の識別子フィールド以外は、ファイルには更新するフィールドのみを含めるようにします。組織の行に空白のフィールドがある場合は、その組織の既存のデータが上書きされます。

3. 「ファイルを選択」または「代わりに自分でデータ内に貼り付ける」リンクをクリックします。
4. 「インポート」をクリックします。

   インポートが開始された後は、インポートされた変更を元に戻すことはできません。

5. （オプション）「管理センター」>「オブジェクトとルール」>「ツール」>「データインポーター」ページで、進行中のインポートのステータスを表示します。インポートが完了すると、そこでインポート履歴ログに記録されます。