- CSVファイルからコンタクト情報を一括インポートできます
- インポート結果を確認し、エラーを修正できます
- 既存ツールからのデータ移行がスムーズに行えます
- ワークスペースのオーナー、管理者、またはメンバーであること
- インポート先のLINEチャンネルが連携済みであること
- CSVファイルが準備されていること
CSVインポートの概要
CSVインポート機能を使うと、大量のコンタクト情報を一括でTsunavoに取り込めます。
対応フォーマット
| 項目 | 仕様 |
|---|---|
| ファイル形式 | CSV(カンマ区切り) |
| 文字コード | UTF-8(BOM付き)、Shift_JIS(CP932) |
| 最大行数 | 20,000行(超える場合は大量データ移行) |
| 最大ファイルサイズ | 10MB |
同じLINE User IDの情報は1行にまとめてください。取り込みを並列で処理するため、複数行の競合する値を上から順に適用する保証はありません。
CSVインポートでは、各行に LINE User ID(line_user_id 列、U で始まる33文字)が必要です。テンプレートの見出し行どおりに列名を揃えてください。line_user_id が無い行、または形式が合わない行は取り込まれません。
友だち追加時にTsunavoが自動取得するのは、通常のLINE連携フロー上のコンタクトです。CSVから既存のLINEユーザーを取り込む場合は、エクスポート元などから line_user_id を用意してください。
テンプレートをダウンロードする
まず、正しいフォーマットのCSVテンプレートをダウンロードします。
左側メニューから コンタクト を選択し、「インポート」ボタンをクリックします。
インポート画面が開きます。取り込みと履歴はタブで分かれています。
「テンプレートをダウンロード」ボタンをクリックします。
CSVテンプレートファイルがダウンロードされます。
ダウンロードしたテンプレートを開いて、列の構成を確認します。
| 列名 | 必須 | 説明 |
|---|---|---|
| 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_user_id と identity_is_blocked
だけのCSVでも、既存ユーザーのブロック状態を変更できます。既存データを更新する設定では、現在と異なる
true / false
は確認画面で更新として表示されます。同じ値や空欄はブロック状態を変更しません。「更新しない」を選んだ場合や、カスタムプロパティの補完として取り込む場合も、既存のブロック状態は保持されます。
テンプレートに含まれていない列を追加した場合、インポート画面の列割り当てでカスタムプロパティに対応づけられます。line_user_id
など識別列の見出し名は、テンプレートどおりにしてください。追加列のプロパティ割り当ては最大100列までです。設定を変えて再アップロードが必要なときは、アップロード(再アップロード)ボタンの近くに案内が表示されます。
コンタクトの CSV エクスポートは、上記テンプレートと同じ列名(line_user_id / contact_email /
identity_tags
など)で出力されます。エクスポートしたファイルをそのまま再インポートできます。末尾の
contact_status / contact_created_at / contact_updated_at
はエクスポート専用の参考列で、再インポート時は無視されます。カスタムプロパティ列は、インポート画面で列割り当てが必要です。
CSVファイルを準備する
テンプレートに沿ってデータを入力します。
テンプレートにコンタクト情報を入力します。
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,新規|キャンペーン,
複数のタグを設定する場合は、| 区切りで記入します。
identity_tags
VIP|新規顧客|キャンペーン対象
CSV の identity_tags
列に存在しないタグ名があると、新しいタグが作成されます。意図しないタグが作られないよう、スペルを確認してください。
UTF-8形式で保存します。
Excelの場合:「名前を付けて保存」→「CSV UTF-8(コンマ区切り)」を選択
Googleスプレッドシートの場合:「ファイル」→「ダウンロード」→「カンマ区切り形式(.csv)」を選択(自動的にUTF-8)
CSVをアップロードする
インポート先のLINEチャンネルを選択します。
複数のチャンネルがある場合は、正しいチャンネルを選択していることを確認してください。
「CSVをドラッグ&ドロップ、またはクリックして選択」エリアにファイルをドロップするか、クリックしてファイルを選択します。
ファイルが選択されると、ファイル名とサイズが表示されます。
「アップロード開始」ボタンをクリックします。
ファイルがアップロードされ、「アップロード済み」と表示されます。
設定ステップで、「このファイルで取り込むコンタクトに付けるタグ」を選べます。
- そのファイルで成功した行全員に付きます(既存データの項目を変更しない場合も含む)
- CSV に
identity_tags列がある行は、列のタグと画面で選んだタグの両方(和集合)が付き、既存タグとの差分は確認画面で更新として表示されます - 同じタグが両方にあっても、二重には付きません
- 未選択でもインポートできます
- 失敗した行と、空行などのスキップには付きません
変更内容を確認し、「新規N件・更新N件をインポート」をクリックします。
画面は確認ステップから結果ステップに切り替わり、「取り込みを受け付けました」と表示されます。件数は処理が始まると更新されます。取り込み結果はファイル全体で集計され、設定したタグやプロパティが適用されます。同じワークスペースで別の通常CSV取り込みが進行している場合は、開始まで待つことがあります。大量データ移行とは別の実行枠を使います。行数や混雑状況により、完了まで時間がかかります。
取り込みを受け付けると、確認ボタンは消えて結果ステップに進みます。完了後に件数サマリーが出ます。
- 成功: 正常にインポートされた件数
- 失敗: エラーでインポートできなかった件数
- スキップ: 重複などでスキップされた件数
インポート結果を確認する
インポート完了後、結果が表示されます。
| 項目 | 説明 |
|---|---|
| 合計 | CSVファイルの総行数 |
| 成功 | 正常にインポートされた件数 |
| 失敗 | エラーによりインポートできなかった件数 |
| スキップ | 重複などでスキップされた件数 |
エラーCSV・スキップCSVは、取り込み処理の終了後にダウンロードできます。処理中は件数の進捗を確認してください。エラーがあった場合は、「エラーCSVをダウンロード」ボタンをクリックしてエラー詳細を確認できます。
エラーCSVには、エラーの原因と該当行が記載されています。中止直後や一部のレポートを取得できない場合は、取得できた範囲のCSVを返します。その場合はファイル名の末尾に -partial が付きます。処理が落ち着いてから再度ダウンロードしてください。レポートファイルがすべて失われている場合は、ダウンロード時にエラーになります。ダウンロードが混み合っている場合は通知を表示し、指定された待ち時間の後に1度自動で再試行します。解消しない場合や転送が中断された場合も通知しますので、時間をおいてもう一度ダウンロードしてください。
エラーを修正した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で先頭・末尾へ移動できます。