ヘルプセンターに戻る

コンタクトのCSVインポート

CSVファイルからコンタクト情報を一括インポートする方法を解説します。

約10分
更新: 2026-11-16
コンタクトインポートCSV
この記事でできること
  • CSVファイルからコンタクト情報を一括インポートできます
  • インポート結果を確認し、エラーを修正できます
  • 既存ツールからのデータ移行がスムーズに行えます
前提条件
  • ワークスペースのオーナー、管理者、またはメンバーであること
  • インポート先のLINEチャンネルが連携済みであること
  • CSVファイルが準備されていること

CSVインポートの概要

CSVインポート機能を使うと、大量のコンタクト情報を一括でTsunavoに取り込めます。

CSVインポートの流れ

対応フォーマット

項目仕様
ファイル形式CSV(カンマ区切り)
文字コードUTF-8(BOM付き)、Shift_JIS(CP932)
最大行数20,000行(超える場合は大量データ移行)
最大ファイルサイズ10MB
line_user_id 列が必須です

同じLINE User IDの情報は1行にまとめてください。取り込みを並列で処理するため、複数行の競合する値を上から順に適用する保証はありません。

CSVインポートでは、各行に LINE User ID(line_user_id 列、U で始まる33文字)が必要です。テンプレートの見出し行どおりに列名を揃えてください。line_user_id が無い行、または形式が合わない行は取り込まれません。

友だち追加時にTsunavoが自動取得するのは、通常のLINE連携フロー上のコンタクトです。CSVから既存のLINEユーザーを取り込む場合は、エクスポート元などから line_user_id を用意してください。

テンプレートをダウンロードする

まず、正しいフォーマットのCSVテンプレートをダウンロードします。

1インポート画面を開く

左側メニューから コンタクト を選択し、「インポート」ボタンをクリックします。

インポート画面が開きます。取り込みと履歴はタブで分かれています。

2テンプレートをダウンロード

「テンプレートをダウンロード」ボタンをクリックします。

CSVテンプレートファイルがダウンロードされます。

3テンプレートを確認

ダウンロードしたテンプレートを開いて、列の構成を確認します。

列名必須説明
line_user_id●LINE User ID(U + 32文字の英数字)
contact_email-コンタクトのメールアドレス
contact_phone-コンタクトの電話番号
contact_display_name-コンタクトの表示名
contact_source-取得元
identity_display_name-LINE側の表示名
identity_picture_url-プロフィール画像URL
identity_language-言語(例: ja)
identity_is_following-フォロー中(true / false)
identity_is_blocked-ブロック(true / false)
identity_tags-タグ(パイプ区切りで複数指定可)
custom_fields-テンプレート互換用の予約列(値は現時点では保存されません)
既存のLINEユーザーのブロック状態を更新する

line_user_id と identity_is_blocked だけのCSVでも、既存ユーザーのブロック状態を変更できます。既存データを更新する設定では、現在と異なる true / false は確認画面で更新として表示されます。同じ値や空欄はブロック状態を変更しません。「更新しない」を選んだ場合や、カスタムプロパティの補完として取り込む場合も、既存のブロック状態は保持されます。

列の追加

テンプレートに含まれていない列を追加した場合、インポート画面の列割り当てでカスタムプロパティに対応づけられます。line_user_id など識別列の見出し名は、テンプレートどおりにしてください。追加列のプロパティ割り当ては最大100列までです。設定を変えて再アップロードが必要なときは、アップロード(再アップロード)ボタンの近くに案内が表示されます。

エクスポート CSV との往復

コンタクトの CSV エクスポートは、上記テンプレートと同じ列名(line_user_id / contact_email / identity_tags など)で出力されます。エクスポートしたファイルをそのまま再インポートできます。末尾の contact_status / contact_created_at / contact_updated_at はエクスポート専用の参考列で、再インポート時は無視されます。カスタムプロパティ列は、インポート画面で列割り当てが必要です。

CSVファイルを準備する

テンプレートに沿ってデータを入力します。

1データを入力

テンプレートにコンタクト情報を入力します。

line_user_id,contact_email,contact_phone,contact_display_name,contact_source,identity_display_name,identity_picture_url,identity_language,identity_is_following,identity_is_blocked,identity_tags,custom_fields
U0123456789abcdef0123456789abcdef,tanaka@example.com,090-1234-5678,田中太郎,,田中太郎,,ja,true,false,VIP,
U0987654321fedcba0987654321fedcb,sato@example.com,080-9876-5432,佐藤花子,,佐藤花子,,ja,true,false,新規|キャンペーン,
2タグの記入方法

複数のタグを設定する場合は、| 区切りで記入します。

identity_tags
VIP|新規顧客|キャンペーン対象
タグの事前作成

CSV の identity_tags 列に存在しないタグ名があると、新しいタグが作成されます。意図しないタグが作られないよう、スペルを確認してください。

3ファイルを保存

UTF-8形式で保存します。

Excelの場合:「名前を付けて保存」→「CSV UTF-8(コンマ区切り)」を選択

Googleスプレッドシートの場合:「ファイル」→「ダウンロード」→「カンマ区切り形式(.csv)」を選択(自動的にUTF-8)

CSVをアップロードする

アップロードからインポートまでの流れ
1LINEチャンネルを選択

インポート先のLINEチャンネルを選択します。

複数のチャンネルがある場合は、正しいチャンネルを選択していることを確認してください。

2ファイルをアップロード

「CSVをドラッグ&ドロップ、またはクリックして選択」エリアにファイルをドロップするか、クリックしてファイルを選択します。

ファイルが選択されると、ファイル名とサイズが表示されます。

3アップロードを開始

「アップロード開始」ボタンをクリックします。

ファイルがアップロードされ、「アップロード済み」と表示されます。

4ファイル全体に付けるタグ

設定ステップで、「このファイルで取り込むコンタクトに付けるタグ」を選べます。

  • そのファイルで成功した行全員に付きます(既存データの項目を変更しない場合も含む)
  • CSV に identity_tags 列がある行は、列のタグと画面で選んだタグの両方(和集合)が付き、既存タグとの差分は確認画面で更新として表示されます
  • 同じタグが両方にあっても、二重には付きません
  • 未選択でもインポートできます
  • 失敗した行と、空行などのスキップには付きません
5インポートを実行

変更内容を確認し、「新規N件・更新N件をインポート」をクリックします。

画面は確認ステップから結果ステップに切り替わり、「取り込みを受け付けました」と表示されます。件数は処理が始まると更新されます。取り込み結果はファイル全体で集計され、設定したタグやプロパティが適用されます。同じワークスペースで別の通常CSV取り込みが進行している場合は、開始まで待つことがあります。大量データ移行とは別の実行枠を使います。行数や混雑状況により、完了まで時間がかかります。

うまくいったかの確認

取り込みを受け付けると、確認ボタンは消えて結果ステップに進みます。完了後に件数サマリーが出ます。

  • 成功: 正常にインポートされた件数
  • 失敗: エラーでインポートできなかった件数
  • スキップ: 重複などでスキップされた件数

インポート結果を確認する

1結果サマリーを確認

インポート完了後、結果が表示されます。

項目説明
合計CSVファイルの総行数
成功正常にインポートされた件数
失敗エラーによりインポートできなかった件数
スキップ重複などでスキップされた件数
2エラーを確認(該当する場合)

エラーCSV・スキップCSVは、取り込み処理の終了後にダウンロードできます。処理中は件数の進捗を確認してください。エラーがあった場合は、「エラーCSVをダウンロード」ボタンをクリックしてエラー詳細を確認できます。

エラーCSVには、エラーの原因と該当行が記載されています。中止直後や一部のレポートを取得できない場合は、取得できた範囲のCSVを返します。その場合はファイル名の末尾に -partial が付きます。処理が落ち着いてから再度ダウンロードしてください。レポートファイルがすべて失われている場合は、ダウンロード時にエラーになります。ダウンロードが混み合っている場合は通知を表示し、指定された待ち時間の後に1度自動で再試行します。解消しない場合や転送が中断された場合も通知しますので、時間をおいてもう一度ダウンロードしてください。

3エラーを修正して再インポート

エラーを修正したCSVを再度アップロードしてインポートできます。

重複チェック

同じデータを再インポートしても、重複するコンタクトは自動的にスキップされます。

インポート履歴を確認する

過去のインポート履歴を確認できます。

1履歴タブを開く

インポート画面上部の「履歴」タブを開きます。

過去のインポートジョブが一覧表示されます。取り込み中も、確認ステップの下ではなくこのタブで確認できます。

2詳細を確認

各インポートジョブの詳細を確認できます。

  • ファイル名
  • ステータス(処理中、完了、失敗)
  • 件数(成功/失敗/スキップ)
  • 作成日時、完了日時
3エラーCSVをダウンロード

過去のインポートでエラーがあった場合も、エラーCSVをダウンロードできます。

うまくいかない場合
エラー: "ファイルをアップロードできません"

原因: ファイルサイズが10MBを超えているか、CSV形式ではありません。

解決策: ファイルサイズが10MB以下であることを確認してください。また、ファイル形式がCSV(.csv)であることを確認してください。

エラー: "文字化けが発生します"

原因: 文字コードがUTF-8ではない可能性があります。

解決策: ファイルをUTF-8(BOM付き)で保存し直してください。Excelの場合は「CSV UTF-8」形式で保存してください。

エラー: "行数制限を超えています"

原因: CSVファイルの行数が20,000行を超えています。

解決策: 大量データ移行が有効なワークスペースでは、エラー表示から「大量データ移行に切り替える」で、分割せずにそのまま取り込めます。有効になっていない場合は、ファイルを分割して複数回に分けてインポートしてください。

エラー: "必須列がありません"

原因: CSVファイルの見出し行がテンプレートと一致していないか、`line_user_id` 列が無い可能性があります。

解決策: テンプレートをダウンロードし、見出し行と `line_user_id` の値(`U` + 32文字)を確認してデータを作り直してください。

エラー: "インポートが途中で止まりました"

原因: サーバーエラーまたはタイムアウトが発生しました。

解決策: ページ上部の「履歴」タブでジョブを確認してください。処理中の場合はしばらくお待ちください。問題が続く場合はサポートにお問い合わせください。

エラー: "タグが自動作成されてしまいました"

原因: CSVに記載したタグ名がシステムに存在しませんでした。

解決策: インポート前に必要なタグを作成しておくか、タグ名のスペルを確認してCSVを修正してください。

インポートしたコンタクトのタグは、一覧で表示されているタグチップまたは「+N」バッジにマウスを重ねるかキーボードでフォーカスすると、すべてのタグ名を確認できます。

キーボードでタグのプレビューを開いた場合、PageUp・PageDownでスクロールし、Home・Endで先頭・末尾へ移動できます。

コンタクトのCSVインポート | Tsunavo ヘルプセンター