CSVで活動履歴をまとめて更新する

活動履歴一覧の「CSVで一括更新」を使うと、CSV（カンマ区切り）または TSV（タブ区切り）のファイルで、 既にある活動履歴 の項目（架電結果・メモなど）をまとめて書き換えられます。

• 活動履歴を新しく追加することはできません（更新のみ）。活動履歴は、リード詳細で電話のあとに入力するか、 「架電なしで記録」で追加します（→ 活動履歴と架電履歴）。
• 1件だけ直すときは、リード詳細で修正するほうが簡単です（→ 活動履歴を修正・削除する）。 絞り込んだ活動履歴の項目を全部同じ値にするだけなら、「フィールドの値を一括更新」も使えます（→ 項目の値をまとめて更新する・リードをまとめて削除する）。

ファイルの準備

いちばん簡単なのは、活動履歴一覧の「⋮」→「CSVへエクスポート」で書き出したファイルを直して使う方法です。 書き出したファイルには「活動履歴番号」の列が入っているので、そのまま照合キーに使えます。 「-」「+」などで始まる値の先頭に付いている「'」（「'- 不在」など）は、取り込むときに自動で外れます。

• 1行目は列名（見出し）にします。列名が活動履歴の項目名と同じ列は、自動で対応付けられます。 そのクライアントで前に取り込んだときに使った列がすべてファイルにあれば、そのときの対応付け（照合キーを含む）が復元されます。
• 文字コードは UTF-8 と Shift_JIS のどちらでも構いません（自動で判別します）。
• ファイルは1回に1つ、100MBまで です。100MBを超えるファイルや、CSV・TSV以外のファイルは、選んだ時点で 「このファイルはアップロードできません」と表示されます。
• 1つのファイルに入れられるのは 10万行まで（見出しの行を除く）です。超えるときはファイルを分けて、1つずつ取り込んでください。 セルの中の改行は行数に数えません。
• 値の書き方はリードの取り込みと同じです（日付は「2026/10/01」「2026-10-01」のどちらでも可、複数選択の項目はカンマか改行で区切る、 エージェント型の項目にはユーザの名前を画面の表示どおりに入れる）。

手順

1. 上部メニューの「活動履歴」を開き、左上で対象のクライアントを選びます。
2. 右上の「⋮」→「CSVで一括更新」を選びます。「活動履歴のインポート（一括更新）」画面が開きます。
3. 「対象クライアント」を確認します。
4. 「ファイルを選択」でファイルを選ぶか、枠にドラッグ＆ドロップし、「アップロード開始」を押します。
5. 「ファイル形式」と「アップロードしたファイルのプレビュー (先頭10行)」を確認します。 「操作」は「更新 (活動履歴は更新のみ行なえます)」に決まっています。
6. 「照合キー」を選びます。ファイルの各行を、どの活動履歴に当てはめるかを決める項目です。
   • 「活動履歴番号」（最初に選ばれています）
   • 「値の重複を禁止する」が有効になっている活動履歴のカスタムフィールド（エージェント型・日付・日時の項目は選べません）
7. 「列のマッピング設定」で、照合キーの列と、更新したい項目の列を選びます。 列を選んだ項目は「更新されます」、選んでいない項目は「更新されません」と表示されます。照合キーの列を選ぶまでは「インポート」を押せません。
8. 選択肢のある項目があれば、「選択肢に登録されていない値をエラーにする」を決めます（チェックなしだと選択肢にない値もそのまま登録されます）。
9. 「インポート」→ 確認画面（「活動履歴の一括更新」）で「開始」を押します。 「インポートを開始しました」と表示され、「活動履歴のインポート履歴」の画面に移ります。

更新のルール

• 照合キーが同じ行が2行以上あると、最初の行だけが取り込まれ、2行目以降は「…がCSV内で重複しています」としてエラーファイルに出力されます。 照合キーが重複しないようにファイルを整えてから取り込んでください。
• 「活動履歴番号」そのものは変更できません。照合キーを「活動履歴番号」以外にしたときは、ファイルに「活動履歴番号」の列があっても使われません。
• 活動履歴を、別のリードや別の架電に付け替えることはできません。
• 更新した活動履歴の「更新者」「更新日時」は、取り込みを行った人と処理した日時に変わります。
• 「値の重複を禁止する」項目に、ほかの活動履歴と同じ値を入れた行はエラーになります。

結果を確認する（CSV一括更新の履歴）

取り込みは裏側で順番に処理されます。進み具合と結果は、活動履歴一覧の「⋮」→「CSV一括更新の履歴」 （「活動履歴のインポート履歴」）で確認します。

ステータスが「処理中」のあいだは、同じクライアントの活動履歴の保存（電話のあとの架電結果、「架電なしで記録」、編集・削除）が 数秒待ったあと失敗することがあります。エージェントが架電結果を残せなくなるので、架電の多い時間帯を避けて取り込んでください。 同じクライアントでほかの取り込みや一括更新が動いていると、終わるまで「待機中」のまま順番を待ちます。

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

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

誰ができるか

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

うまくいかないとき

• 一部の行が更新されていない: 履歴の「失敗」の件数とエラーファイルを確認してください。照合キーが空・一致しない （「…に一致する活動履歴が見つかりません」「…が存在しません」）、必須項目が空、選択肢にない値（チェックありのとき）、 重複禁止の項目の重複、見つからない担当者名、などが理由として書かれています。

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

• ステータスが「待機中」「処理中」のまま進まない: 大きなファイルは時間がかかります。数時間たっても進まないときは、「処理の停止」で止めてから、同じファイルをそのまま取り込み直してかまいません（処理済みの行は、同じ値でもう一度上書きされるだけです）。 停止した取り込みにはエラーファイルが付きません。取り込み直しても進まないときは、COCOA のサポートに問い合わせてください（→ サポートに問い合わせる）。

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

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

  途中で「失敗」になったときは、それまでに処理済みの行は更新されたまま残ります。同じファイルをそのまま取り込み直してかまいません。

• 文字化けする: Excel なら「CSV UTF-8（コンマ区切り）」で保存し直してください。