現在Intercomをご利用のお客様は、以下のソースからusersをインポートできます：
注意：
イベントで出会った人など、少数のusersを追加したい場合は、peopleリストから直接作成できます。
CSVインポートでは会社属性や会社データをIntercomにインポートすることはできません。
すべての方法でusername、email、userID、登録日（DD/MM/YYYY形式、ISO 8601、またはUnixタイムスタンプ）をインポートできます。DD/MM/YYYYを使用する場合、時間は送信できませんのでご注意ください。
CSVインポートではカスタムuser属性も作成できます（各属性ごとに列を含めてください）。
Mixpanelにはlast_seenが含まれます。
MailChimpはuserのIPをインポートします。
始めましょう
まず、Intercomアカウントにログインし、peopleリストから「New users or leads」をクリックします。
次に「Import people」を選択します：
次に、usersをインポートする方法を選択し、インポート手順に従います。
これらのオプションはすべて設定 > データ > インポート & エクスポートからもアクセスできます。
usersをIntercomにインポートし、すぐにライブメッセージの条件に合致した場合、そのメッセージが即座に送信されます。
CSVからusersをインポートする方法
ステップバイステップ：
CSVインポートオプションを選択した場合は、以下の手順に従ってusersをインポートしてください。
「いつでもusersをインポート」セクションで説明したステップ1と2を完了し、CSVインポートツールを開くをクリックしてください。
ログイン済みのusersまたは製品の顧客リストをインポートするにはImport usersを選択します。あるいは、leadsリストをIntercomワークスペースにインポートするには「Import leads」を選択してください。
CSVファイルをドラッグ＆ドロップし、アップロードをクリックします。最大ファイルサイズは20MBです。これを超える場合はファイルを分割してください。
重要なCSVフォーマット要件：
user ID列は
user_id（小文字でアンダースコア）でフォーマットしてください。usersを識別するには次のいずれかを使用できます：
user_id（推奨）Email列
両方ある場合は
user_idが優先されます。emailがない場合は
user_idが必須です。user IDとemailを識別子として不一致に使用すると重複usersが作成される可能性があります。最適な結果のために：
可能な限りすべてのレコードにuser IDとemailの両方を含めてください。
両方提供された場合はuser IDが優先され、重複アカウントの防止に役立ちます。
ベストプラクティス：最適なユーザー管理のためにCSVファイルにuser_idとEmail列の両方を含めてください。
4. Intercomはusersのemail、ID、フルネーム、登録日を含む関連列を選択するよう促します。各列で「この列を選択」をクリックし、「確認」をクリックしてください。
CSV内のすべてのusersまたはleadsはemailアドレスを持っている必要があります。同じemailを持つleadsとusersが別々のエンティティとして扱われると重複が発生する可能性があります。これを防ぐために、インポート時にuserとleadデータの同期を確実にしてください。
emailとuser_idの両方を含むCSVのインポートは、既存のプロファイルにuser_idがない場合、重複を作成する可能性があります。
連絡先は次の順序で識別されます：Intercom ID → user_id → email。user_idが設定されていないユーザープロファイルに対し、CSVにemailとuser_idの両方が含まれている場合、Intercomはemailでマッチせず、user_idを新しい識別子として扱い重複連絡先を作成します。これを避けるために、すべてのusersに対してuser_idの値を一貫して設定してください。既存usersにuser_idがない場合は、CSVインポート前にAPIを使ってuser_idを更新してください。
5. 追加の列を追加した場合、Intercomはカスタム属性に特定の名前を付けるよう促します。名前を付けたら「確認」をクリックしてください。
6. CSVリストに「New Sign-Ups 2015」など覚えやすいタグを付けてください。
7. インポート後、IntercomのUserリストで「tag: New Sign-Ups 2015」を検索できます。リストの全員に一斉メッセージを送信したり、セグメントを作成してターゲットを絞ったプロアクティブサポートメッセージを送信したりできます。
電話番号の先頭に国番号を追加する必要があります。例えば、米国番号の場合は「+1」または「001」を追加します。
注意：WhatsAppメッセージング用に連絡先をインポートする場合、電話番号だけでは不十分です。CSVの各行には連絡先識別子（emailアドレスまたはuser_id）も含める必要があります。電話番号のみのCSVインポートはWhatsAppのアウトバウンドメッセージングには対応しません。
注意：タグはインポート完了後、完全に適用されるまで数分かかる場合があります。すべてのタグがインポートされたusersに適用されるまでしばらくお待ちください。
CSVインポートでuserデータを更新できますか？
はい。既存usersの値を更新したり、新しい属性を追加したりできます。すべてのCSVインポートにはuserのemailアドレス列が必要です。いくつか注意点があります。
同じuser_idで異なるemailアドレスを送信すると、そのuser_idのuserのemailがIntercomで更新されます。
既存のemailアドレスで新しいuser_idを設定してもuser_idは更新されません。新しいレコードが作成されます。
Intercomでuser_idとemailの両方を使用している場合、CSVインポートでemailを送信するだけでuserレコードとマッチします。
Rest API経由でusersをインポートする
REST APIを使って、カスタムuser属性とともにusersをインポートできます。インポート後はEvents APIを使ってusersの過去のイベントデータも追加可能です。
Intercom APIを使ってJSONファイルからcontact userとleadデータをインポートする方法を解説したチュートリアルをご覧ください。
データインポート履歴を見る
Intercomの設定セクションでデータインポート履歴を確認できます。
CSVインポートのエラーレポートをダウンロードする方法
contactsのCSVインポートで失敗した行がある場合、エラーレポートをダウンロードできます。インポートのすべてのエラーを一覧にしたCSVファイルで、失敗した行を一括修正して再インポートできます。
設定 > データ > インポート & エクスポートに移動し、CSVインポートを開きます。
リストからインポートを見つけます。エラーレポート列にスピナーが表示されている間はレポート作成中です。
エラーレポートをダウンロードをクリックしてCSVファイルをダウンロードします。
CSVインポートのエラーレポートには各エラーについて以下が含まれます：
スプレッドシートの行番号はファイル内の行と一致します。ヘッダー行や空白行もカウントされるため、レポートの7行目はスプレッドシートの7行目です。
その行の連絡先のUser IDとEmail。
エラーを引き起こした列。
エラータイプは「無効なemail」「emailがない」「データ型不一致」「最大長超過」「複数レコード一致」などの平易な言葉で表示されます。
すべてのエラーが一覧表示されるため、2つのエラーがある行はエラーレポートに2回表示されます。
注意：CSVインポートを実行したチームメンバーのみがエラーレポートをダウンロードでき、レポートは30日間保存されます。エラーレポートはCSVエクスポートページには表示されず、準備完了時にメールは送信されません。エラーレポート公開前に実行されたインポートは以前のインポートサマリーが表示されます。
「複数レコード一致」エラーとは？
「複数レコード一致」エラーは、システム内に同じemailアドレスを持つ複数のusersが存在する場合に発生します。どのuserを更新すべきか判断できず、競合が起きます。解決するには、各userに一意のemailアドレスまたはuser IDを割り当ててください。
IntercomのAPIを使ってexternal_idフィールドを体系的に更新し、重複を統合してマッチングを明確にすることができます。
重複usersの原因を理解する
Intercomでの重複userプロファイルは様々な理由で発生します。識別子の階層（Intercom ID > User ID > Email）が重要です。一意で安定したuser_idが提供されない場合、重複が起こります。例えば、同じemailに異なるuser_idを送信したり、user_idなしでusersを初期化すると重複します。匿名からログイン状態への移行、emailアドレスの重複、ユーザー識別子の変更も影響します。WhatsApp統合のように電話番号のみでプロファイルを生成するプラットフォーム固有の問題もあります。
不一致なユーザー識別子：
emailとuser IDを不一致に使用すると重複が発生する可能性があります。emailはuser IDがない場合のみ一意の識別子として機能します。したがって、異なるuser IDを持つ2人のusersが同じemailを共有することがあります。これはバックエンドの更新やuser ID生成の変更後に起こることがあります。
統合の挙動：
Shopifyなどのアプリ統合は、user IDを調整せずにemail IDを一意の識別子として使用してusersを作成することがあります。
アップロード時のマッチングロジック：
インポート時にuser IDまたはemailアドレスのみが提供された場合、Intercomは提供されたフィールドでマッチングを試みます。ただし、両方のフィールドが不一致または不整合の場合、問題が発生することがあります。
UsersとLeadsの重複：
Leadsとusersは同じemailアドレスを共有していても別のオブジェクトとして扱われ、重複が発生する可能性があります。
SDKの初期化ミスや匿名からログイン状態への移行時に適切な更新が行われないと重複が発生しやすくなります。例えば、匿名閲覧時にランダムなuser_idを割り当てると、セッション移行時に新しいプロファイルが作成されます。
重複usersの防止
ユーザー識別子の標準化：
設定でuser IDとemailの両方を一貫して割り当てていることを確認してください。例えば：
emailのみが提供された場合、システムはemailでマッチングします。
user IDのみが提供された場合、システムはuser IDでマッチングします。
両方が提供された場合、user IDが優先されます。user IDでマッチしない場合はemailでマッチします。
適切なSDK初期化：
匿名usersの場合は
app_idのみでSDKを初期化してください。ログイン後は適切な
user_idとemail識別子でプロファイルを更新してください。ユーザーログアウト前にSDKをシャットダウン（
Intercom('shutdown')）して重複を避けてください。
Lead変換設定の確認：
サインイン時に一貫したuser IDを使用して、アクティブなleadsをusersに重複なく変換してください。詳細はユーザー認証ガイドを参照してください。
プラットフォーム固有の要件への適応：
例：WhatsAppの場合、「既存usersを識別」設定を有効にし、email識別子を早期に取得して一貫性を保つようにしてください。
移行時の注意点：
新しいIDシステム（例：UUID）への移行時は、IntercomのAPIを使って
external_idフィールドを効果的に更新・管理し、重複を防いでください。