CSVでリードを取り込む・まとめて更新する

リードは CSV（カンマ区切り）または TSV（タブ区切り）のファイルから、まとめて 新規追加 したり、 既にあるリードを 更新 したりできます。 （カスタムフィールドの 設定 をCSVで取り込む方法は別の機能です → 他のクライアントと同じ項目を使う（コピー・CSV））

ファイルの準備

• 1行目は列名（見出し）にします。列名がリードのフィールド名と同じ列は、自動で対応付けられます。 そのクライアントで前に取り込んだときに使った列がすべてファイルにあれば、そのときの対応付け（照合キーを含む）が復元されます。
• 文字コードは UTF-8 と Shift_JIS のどちらでも構いません（自動で判別します）。Excel で「CSV」として保存したファイルもそのまま使えます。
• ファイルは1回に1つ、100MBまで です。100MBを超えるファイルや、CSV・TSV以外のファイルは、選んだ時点で 「このファイルはアップロードできません」と表示されます。
• 1つのファイルに入れられるのは 10万行まで（見出しの行を除く）です。新規追加・更新のどちらでも同じです。超えるときはファイルを分けて、1つずつ取り込んでください。 セルの中の改行は行数に数えません。
• 新規追加 では、取り込み後のリードの総数（既存のリード＋ファイルの行数）が 100万件 を超えるファイルは取り込めません。更新 はリードが増えないので、この上限はありません。
• 10万行・100万件の上限を超えるファイルは、「開始」を押したときに「インポートに失敗しました」と理由が表示され、取り込まれません。
• 値の書き方:
  • 日付は「2026/10/01」「2026-10-01」のどちらでも読み込めます。
  • チェックボックス・ドロップダウン（複数選択）の項目は、カンマまたは改行で区切ると複数の値を入れられます。
  • エージェント型の項目（担当者など）には、チームのユーザの 名前 を画面の表示どおりに入れます。見つからない名前の行はエラーになります。
  • 「CSVへエクスポート」で書き出したファイルでは、「-」「+」などで始まる値の先頭に「'」が付いています（「'- 不在」など）。この「'」は取り込むときに自動で外れるので、消さずにそのまま使えます。

新規追加の手順

1. 上部メニューの「リード」を開き、右上の「⋮」→「CSVからインポート」を選びます。
2. 「対象クライアント」を確認します。
3. 「ファイルを選択」でファイルを選ぶか、枠にドラッグ＆ドロップし、「アップロード開始」を押します。
4. 「ファイル形式」（CSV（カンマ区切り）／TSV（タブ区切り））と、「アップロードしたファイルのプレビュー (先頭10行)」を確認します。
5. 「操作」で「新規追加」を選びます。
6. 「列のマッピング設定」で、リードの各フィールドにファイルのどの列を入れるかを選びます。 各フィールドに「作成されます」「作成されません」と表示されるので、入れたい項目が「作成されます」になっているか確認します。
7. 選択肢のある項目があれば、「選択肢型の項目の扱い」を決めます（下記）。
8. 「インポート」→ 確認画面で「開始」を押します。「インポートを開始しました」と表示され、インポート履歴の画面に移ります。

「会社名」と、「初期値」のない必須の項目に列を対応付けるまでは、「インポート」を押せません。

初期値について: 新規追加では、項目の「初期値」は 必須の項目だけ に使われます（列を対応付けていないか、セルが空のとき）。 必須でない項目は、空のまま登録されます。初期値が「ログインユーザ（あなた）」の必須のエージェント型の項目は、 初期値を使えないためその行がエラーになります。その項目には必ず列を対応付けてください。

新規追加では、ファイルの すべての行が新しいリードとして登録されます。同じ会社がすでにあっても重複チェックはされません （「値の重複を禁止する」項目に同じ値がある行はエラーになります）。

「会社名」「電話番号」も、クライアントによっては「値の重複を禁止する」、「電話番号」は「必須項目にする」が設定されています （→ カスタムフィールドを編集・削除する）。その場合は次のようになります。

• 重複を禁止した「会社名」「電話番号」に、既存のリードやファイルのほかの行と同じ値がある行はエラーになります。 会社名は 完全に一致する値だけ が重複とみなされます（「株式会社〇〇」と「(株)〇〇」は別の値です）。 電話番号はハイフンやスペースの有無をそろえて比べるので、「03-0000-0000」と「0300000000」は同じ番号として重複になります。
• 「電話番号」が必須のときは、電話番号が空の行はエラーになります。新規追加では「電話番号」に列を対応付けてください。

既存のリードを更新する手順（更新取込）

手順1〜4は新規追加と同じです。

5. 「操作」で「更新」を選びます。ファイルに「リード番号」の列があり、1行目に数字が入っていると、最初から「更新」が選ばれます。
6. 「照合キー」を選びます。ファイルの各行を、どのリードに当てはめるかを決める項目です。
   • 「リード番号」
   • 「値の重複を禁止する」が有効になっているカスタムフィールド（管理番号・顧客IDなど）
   • 「会社名」「電話番号」は、重複を禁止していても照合キーには選べません
   • エージェント型（担当者など）・日付・日時の項目も、重複を禁止していても照合キーには選べません
7. 「列のマッピング設定」で、照合キーに使う列と、更新したい項目の列を選びます。 照合キーの列を選ぶまでは「インポート」を押せません。
8. 「インポート」を押すと、確認画面に「「リード番号」が一致するレコードは更新されます。一致するものがない行は取り込まれず、「失敗」としてエラーファイルに出力されます。」のように表示されます。「開始」を押します。

更新のルール:

• 照合キーが同じ行が2行以上あると、最初の行だけが取り込まれ、2行目以降は「…がCSV内で重複しています」としてエラーファイルに出力されます。 照合キーが重複しないようにファイルを整えてから取り込んでください。
• 「リード番号」そのものは変更できません。
• 担当者の割り振りを変えたいときは、照合キーと「担当者」の2列だけのファイルを作ると、ほかの項目を変えずに済みます。 条件に合うリード全部を同じ値にするだけなら、リード一覧の「⋮」→「フィールドの値を一括更新」も使えます（→ 項目の値をまとめて更新する・リードをまとめて削除する）。

選択肢型の項目の扱い

「選択肢に登録されていない値をエラーにする」:

• チェックなし（初期状態）: 選択肢にない値も、そのまま登録されます。
• チェックあり: 選択肢にない値を含む行は取り込まれず、エラー行になります。

表記ゆれ（全角・半角など）で選択肢が増えてしまうのを防ぎたいときはチェックを入れてください。

取り込みの結果を確認する（インポート履歴）

取り込みは裏側で順番に処理されます。進み具合と結果は「⋮」→「インポート履歴」で確認します。

ステータスが「処理中」のあいだは、同じクライアントのリードの追加・基本情報の編集・削除が保存できず、 数秒待ったあと失敗することがあります。ほかの人の作業も止まるので、大きなファイルはリードを触る人が少ない時間に取り込んでください。 同じクライアントでほかの取り込みや一括更新・一括削除が動いていると、終わるまで「待機中」のまま順番を待ちます。

「2026/11/07 時点の値に戻す」のような行は、バックアップから値を戻したものです。「結果」には「戻した」「そのまま」の件数が出ます（→ バックアップから値を戻す・ダウンロードする）。

• エラーになった行があっても、ほかの行は取り込まれます。エラーファイルを直して、その行だけを取り込み直してください。
• エラーファイルは、インポートしてから7日を過ぎると削除されます。必要なときは早めにダウンロードしてください。 インポートのためにアップロードしたファイルも、7日を過ぎると COCOA から削除されます。
• 「待機中」「処理中」のものは、ステータスの横の停止ボタンで止められます（確認画面「処理の停止」）。 停止するとステータスは「失敗」、詳細は「ユーザによって中断されました」になり、それまでに処理済みの行は取り込まれたまま残ります。
• 停止の確認中に取り込みが終わっていた場合は、「停止できませんでした」「このインポート処理は既に終了しています。」と表示されます。取り込みは停止されず、終わったときの結果（「完了」、またはエラーによる「失敗」）のまま残ります。 インポート履歴でステータスと結果を確認してください。
• 履歴は新しい順に最大200件まで表示されます。クライアントで絞り込まれず、自分が見られるすべてのクライアントの取り込みが、誰が行ったものも表示されます（「クライアント」の列で区別します）。
• エージェント は、自分に許可されていない取り込みの停止ボタンとエラーファイルを押せません（ほかの人が行った取り込みでも同じです）。 新規追加の取り込みは「CSVインポート（新規追加）」、更新の取り込みは「一括更新（CSVインポートによる更新を含む）」の許可で決まります。 マウスを重ねると「この操作はエージェントには許可されていません」と表示されます（→ エージェントに許可する操作を変える（エージェントの操作））。

誰ができるか

• そのクライアントの「エージェント」以上が操作できます（「マネージャー」、チームの「管理者」「スーパーバイザー」を含む）。
• ただし エージェント は、クライアントの設定（「エージェントの操作」）で許可されている場合だけです。 エージェントの「CSVインポート（新規追加）」と「一括更新（CSVインポートによる更新を含む）」は、最初は許可されていません（新しく作ったクライアントでも、前からあるクライアントでも同じです）。
  • 「新規追加」だけが許可されていないとき: 画面は開けますが、「操作」の「新規追加」が選べず、最初から「更新」が選ばれています（理由は表示されません）。
  • 両方とも許可されていないとき: 「⋮」の「CSVからインポート」「インポート履歴」が選べず、画面を開いても「インポートできません」「この操作はエージェントには許可されていません」と表示されます。 変更は、そのクライアントの「マネージャー」と、チームの「管理者」「スーパーバイザー」がクライアントの編集画面で行います（→ エージェントに許可する操作を変える（エージェントの操作））。
• 「更新操作の可否」が「更新不可」のユーザは、取り込みができません（「更新が許可されていないため失敗しました」→ 更新操作の可否（閲覧のみにする設定））。エクスポートはできます。

うまくいかないとき

• 一部のリードが入っていない: インポート履歴の「失敗」の件数とエラーファイルを確認してください。 必須項目が空、選択肢にない値（チェックありのとき）、重複禁止の項目の重複、見つからない担当者名、更新取込で照合キーが一致しない、などが理由として書かれています。

• ステータスが「待機中」「処理中」のまま進まない: 大きなファイルは時間がかかります。数時間たっても進まないときは、「処理の停止」で止めてから取り込み直してください。

  • 新規追加 のときは、同じファイルをそのまま取り込み直さないでください。停止する前に処理済みだった行はリードとして登録されたまま残るため、同じリードが二重に登録されます。 「進捗」の「1000 / 5000」のような表示の左側が処理済みの行数です。見出しの行は残したまま、先頭からその行数分のデータ行を消して、残りの行だけを取り込んでください。
  • 更新 のときは、同じファイルをそのまま取り込み直してかまいません（処理済みの行は、同じ値でもう一度上書きされるだけです）。
  • 停止した取り込みにはエラーファイルが付きません。処理済みの範囲に失敗した行があっても、エラーファイルでは確認できません。
  • 取り込み直しても進まないときは、COCOA のサポートに問い合わせてください（→ サポートに問い合わせる）。

• ステータスが「失敗」になった: インポート履歴の「詳細」に、ファイル全体が取り込めなかった理由が表示されます。

  「詳細」の表示	対処
  「CSVファイルの形式が不正なため読み込めませんでした（〇行目付近）」	表示された行のあたりで、「"」の閉じ忘れや、セルの中の改行・「"」がないか確認し、保存し直して取り込み直します
  「CSVファイルの文字コードを判定できませんでした（…）」	表示のとおり、UTF-8 か Shift_JIS で保存し直してから取り込み直します
  「ファイルの行数（〇行）が1ファイルあたりの上限（100,000行）を超えるため…」	ファイルを分割して、1ファイル10万行以内にしてから取り込み直します
  「インポート後の件数が上限（1,000,000件）を超えるためインポートできませんでした」	新規追加で、いまあるリードとファイルの行数の合計が100万件を超えるときです。不要なリードを削除してから取り込み直してください
  「列のマッピング設定が不正なためインポートできませんでした」	「会社名」（更新のときは照合キー）の列が対応付けられていません。「CSVからインポート」からやり直してください
  「ユーザによって中断されました」	停止ボタンで止めたものです（停止の説明は上の履歴の節）
  「-」（理由が表示されない）	COCOA側の一時的な問題で止まった可能性があります。取り込み直しても同じになるときはサポートに問い合わせてください

  途中で「失敗」になったときは、それまでに処理済みの行は取り込まれたまま残ります。新規追加で取り込み直すときは、上の「進まない」ときと同じように、処理済みの行を除いてください。

• 文字化けする: UTF-8 か Shift_JIS 以外の文字コードになっていないか確認し、Excel なら「CSV UTF-8（コンマ区切り）」で保存し直してください。

• 更新したら値が消えた: 列を対応付けた項目のセルが空だと、その項目の値は消えます。変えたくない項目は、マッピングで「列を選択しない」にしてください。